本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> RDB> CreateDBParameterGroup
本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/rdb/api/CreateDBParameterGroup.htmへ移行しました。 今後は新ページをご参照ください。

CreateDBParameterGroup

処理概要

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

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

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

指定するパラメーター

パラメーター 説明 必須
DBParameterGroupFamily string

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

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

DBParameterGroupName string

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

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

Description string

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

  • ※1〜255文字までの印字可能文字が使用できます
  • ※空文字列を指定することも可能です
  • ※4バイト文字(絵文字や一部の漢字など)は使用できません

応答フィールド

フィールド (項目) 説明
CreateDBParameterGroupResponse structure ルート
CreateDBParameterGroupResult structure 結果
DBParameterGroup structure DBパラメーターグループ
備考: DBParameterGroupの子要素はDescribeDBParameterGroupsで返却される要素をすべて記載しているためAPIによっては返却されない要素もあります。実際のレスポンスはレスポンスサンプルを参照してください。
DBParameterGroupFamily string DBパラメーターグループファミリー名
DBParameterGroupName string DBパラメーターグループ名
Description string DBパラメーターグループの説明
ResponseMetadata structure 共通メタ情報
RequestId string リクエスト識別子

エラー

コード メッセージ タイプ 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 lowercase 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.InvalidParameterIllegalInput.Description

Description (4バイト文字) is not a valid parameter.

Sender 400 Descriptionに4バイト文字を含む値を指定した場合
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://jp-east-1.rdb.api.nifcloud.com/
  ?Action=CreateDBParameterGroup
  &DBParameterGroupFamily=mysql5.6
  &DBParameterGroupName=mydbparametergroup
  &Description=My new parameter group
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-12-09T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

  

応答サンプル

    <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>

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

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