本文へジャンプします。

ニフティクラウド 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
ステータスコード
説明
DBParameterGroupAlreadyExists Parameter group test already exists Sender 400 DBParameterGroupNameにすでに存在するものと同じ値を指定した場合
DBParameterGroupQuotaExceeded Request would result in user exceeding the allowed number of DB Parameter Groups. Sender 400 作成できるDBパラメーターグループの上限に達している場合
InvalidParameterValue The parameter ParameterGroupFamily must be provided and must not be empty. Sender 400 必須のDBParameterGroupFamilyを指定しなかった場合
The parameter DBParameterGroupName must be provided and must not be blank. Sender 400 必須のDBParameterGroupNameを指定しなかった場合
The parameter Description must be provided and must not be blank. Sender 400 必須のDescriptionを指定しなかった場合
ParameterGroupFamily mysql5 is not a valid parameter group family Sender 400 無効なDBParameterGroupFamilyを指定した場合
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に無効な(数字から始まるなど)値を指定した場合
The parameter DBParameterGroupName is not a valid identifier because it is longer than 255 characters. Sender 400 DBParameterGroupNameに255文字以上指定した場合
Description is too long. Maximum length is 255 Sender 400 Descriptionに255文字以上指定した場合
The parameter Description must not contain non-printable control characters. Sender 400 Descriptionに全角文字を指定した場合

サンプル

リクエストサンプル
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 以上