ニフクラAPI (RDB: CreateDBParameterGroup)

【重要なお知らせ】サービス統合に基づくサービス名称の読み替えのお願い（2024年4月1日）

2024年4月1日をもって、「ニフクラ」は、「FJcloud-V」に統合し、名称を変更しました。
当サイトのアドレス（ドメイン名）に含まれる「nifcloud.com」は現時点では変更はございませんが、
各ページに記載の「ニフクラ」「NIFCLOUD」「nifcloud」は、「FJcloud-V」に読み替えていただきますようお願いいたします。

ニフクラユーザーガイド

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

CreateDBParameterGroup

処理概要

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

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

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

指定するパラメーター

パラメーター	型	説明	必須
DBParameterGroupFamily	string	DBパラメーターグループファミリー名 ※DBパラメーターグループは一つのDBパラメーターグループファミリーに紐づいており、そのDBパラメーターグループファミリーとの互換性を持つDBエンジン・エンジンバージョンのDBサーバーにのみ適用することができます ※大文字・小文字を区別はありません形式：エンジン名＋エンジンバージョン例：mysql5.6、MySQL5.7、postgres9.3	○
DBParameterGroupName	string	DBパラメーターグループ名 ※1〜255字のアルファベット(小文字)・数字・ハイフン(‘-’)が使用できます ※最初の文字はアルファベットである必要があります ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません	○
Description	string	DBパラメーターグループの説明 ※1〜255文字までの印字可能文字が使用できます ※空文字列を指定することも可能です ※4バイト文字（絵文字や一部の漢字など）は使用できません	○

パラメーター

型

説明

必須

DBParameterGroupFamily

string

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

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