本文へジャンプします。

ニフティクラウド APIリファレンス

クラウド トップ>API>RDB>CreateDBParameterGroup

RDB:CreateDBParameterGroup

処理概要

DBパラメーターグループを作成します。

パラメーターの値をカスタマイズしたい場合には、ModifyDBParameterGroupを使います。

起動しているDBサーバーへ新しいDBパラメーターグループを適用したい場合には、DBサーバーの再起動が必要になります。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
DBParameterGroupFamily

DBパラメーターグループファミリー名

  • ※DBパラメーターグループは一つのDBパラメーターグループに紐づいており、そのDBパラメーターグループファミリーとの互換性を持つDBエンジン・エンジンバージョンのDBサーバーにのみ適応することができます
  • ※大文字・小文字を区別はありません
形式:エンジン名+エンジンバージョン
例:mysql5.5、MySQL5.6、postgresql9.3
文字列  
DBParameterGroupName

DBパラメーターグループ名

  • ※1〜255字のアルファベット・数字・ハイフン('-')が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
文字列  
Description

DBパラメーターグループの説明

  • ※1〜255文字までの印字可能文字が使用できます
  • ※空文字列を指定することも可能です
文字列  

レスポンス

XML

status

statusは共通の応答メッセージを返却します。

result
要素名 説明 備考
CreateDBParameterGroupResponse ルート  
CreateDBParameterGroupResult 結果  
DBParameterGroup DBパラメーターグループ  
DBParameterGroupFamily DBパラメーターグループファミリー名 文字列  
DBParameterGroupName DBパラメーターグループ名 文字列  
Description DBパラメーターグループの説明 文字列  
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTP
ステータスコード
説明
Client.InvalidParameterDuplicate.DBParameterGroupName Parameter group default.mysql.5.6 already exists Sender 400
  • すでに存在するDBParameterGroupNameを指定した場合
  • DBParameterGroupNameに"default."で始まる値を指定した場合
Client.InvalidParameterFormat.DBParameterGroupName The parameter DBParameterGroupName is not a valid identifier.Identifiers must begin with a letter; must contain only ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens. Sender 400 DBParameterGroupNameに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterIllegalInput.DBParameterGroupFamily ParameterGroupFamily aaa is not a valid parameter group family Sender 400 無効なDBParameterGroupFamilyを指定した場合
Client.InvalidParameterRequired.DBParameterGroupFamily The parameter ParameterGroupFamily must be provided and must not be empty. Sender 400 必須のDBParameterGroupFamilyを指定しなかった場合
Client.InvalidParameterRequired.DBParameterGroupName The parameter DBParameterGroupName must be provided and must not be blank. Sender 400 必須のDBParameterGroupNameを指定しなかった場合
Client.InvalidParameterRequired.Description Description is required. Sender 400 必須のDescriptionを指定しなかった場合
Client.InvalidParameterTooLong.DBParameterGroupFamily DBParameterGroupFamily can not be greater than 256 characters. Sender 400 DBParameterGroupFamilyに256文字を超える値を指定した場合
Client.InvalidParameterTooLong.DBParameterGroupName The parameter DBParameterGroupName is not a valid identifier because it is longer than 255 characters. Sender 400 DBParameterGroupNameに255文字を超える値を指定した場合
Client.InvalidParameterTooLong.Description Description is too long. Maximum length is 255 Sender 400 Descriptionに255文字を超える値を指定した場合
Client.LimitExceeded.NumberOfDBParameterGroup Request would result in user exceeding the allowed number of DB Parameter Groups. Sender 400 作成可能なDBパラメータグループの上限に達している場合

サンプル

リクエストサンプル
https://rdb.jp-east-1.api.cloud.nifty.com/
    ?Action=CreateDBParameterGroup
    &DBParameterGroupFamily=mysql5.6
    &DBParameterGroupName=mydbparametergroup
    &Description=My+new+parameter+group
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2013-12-09T00%3A00%3A00.000Z
    &AWSAccessKeyId=<Nifty Cloud Access Key ID>
    &Signature=<Signature>
レスポンスサンプル
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<CreateDBParameterGroupResponse>
  <CreateDBParameterGroupResult>
  <DBParameterGroup>
    <DBParameterGroupFamily>mysql5.6</DBParameterGroupFamily>
    <DBParameterGroupName>mydbparametergroup</DBParameterGroupName>
    <Description>My new parameter group</Description>
  </DBParameterGroup>
</CreateDBParameterGroupResult>
  <ResponseMetadata>
  <RequestId>fd76a123-12af-481f-9223-3f558ea99a02</RequestId>
</ResponseMetadata>
</CreateDBParameterGroupResponse>

推奨画面サイズ 1024×768 以上