本文へジャンプします。

ニフクラ APIリファレンス

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

RDB:CreateDBInstance

処理概要

DBサーバーを新規作成します。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
AllocatedStorage ディスク容量(GB)
値:50 | 100 | 150 | 200 | 250
数値  
AutoMinorVersionUpgrade
  • ※指定不可
  真偽値  
AvailabilityZone 指定可能なゾーンについては、ニフクラ ゾーン別機能対応表をご参照ください。 ○(プライベートLANを利用している場合) 文字列 自動割り当て  
BackupRetentionPeriod

バックアップ保持期間(日)

  • ※0を指定すると自動バックアップを行いません

値:0〜10

  数値 1  
CharacterSetName
  • ※指定不可
  文字列  
DBInstanceClass DBサーバータイプ
値 : db. mini | db. e-small | db. small | db. e-small2 | db. small2 | db. e-small4 | db. small4 | db. e-small8 | db. small8 | db. e-medium | db. medium | db. e-medium4 | db. medium4 | db. e-medium8 | db. medium8 | db. e-medium16 | db. medium16 | db. e-large | db. large | db. e-large8 | db. large8 | db. e-large16 | db. large16 | db. e-large24 | db. large24 | db. e-large32 | db. large32 | db. e-extra-large16 | db. extra-large16 | db. e-extra-large24 | db. extra-large24 | db. e-extra-large32 | db. extra-large32 | db. e-double-large32 | db. double-large32 | db. e-double-large48 | db. double-large48 | db. e-double-large64 | db. double-large64
文字列  
DBInstanceIdentifier

DBサーバー名

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

DB名

  • ※DBサーバー内に作成されるデータベースの名前です
  • ※指定しない場合にはデータベースは作成されません
  • ※最初の文字はアルファベットである必要があります
  • ※MySQLの場合、1〜64字のアルファベット・数字・アンダースコア('_')が使用できます
  • ※PostgreSQLの場合、1〜63字のアルファベット・数字・アンダースコア('_')が使用できます
  • ※MariaDBの場合、1〜64字のアルファベット・数字・アンダースコア('_')が使用できます
  文字列    
DBParameterGroupName

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

  • ※このパラメーターを指定しない場合、デフォルトのDB パラメーターグループが使用されます
  • ※1〜255字のアルファベット・数字・ハイフンが使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
  文字列 DBエンジンのDefaultParameterGroupName  
DBSecurityGroups.member.N DBファイアウォールグループのリスト   文字配列 DBエンジンのDefaultSecurityGroup 1つのみ指定可能です。複数指定した場合、2つ目以降は無視されます。
DBSubnetGroupName
  • ※指定不可
  文字列  
Engine データベースエンジン
値:MySQL | postgres | MariaDB
文字列  
EngineVersion データベースエンジンのバージョン
値(MySQL):5.5.32 | 5.5.40 | 5.5.41 | 5.5.53 | 5.6.12 | 5.6.21 | 5.6.22 | 5.6.34 | 5.7.15
値(PostgreSQL):9.3.4
値(MariaDB) : 10.1.14 | 10.1.18
  文字列  
Iops
  • ※指定不可
  数値  
LicenseModel DBサーバーのライセンスモデル
値(MySQL):general-public-license
値(PostgreSQL):postgresql-license
値(MariaDB) : general-public-license
  文字列  
MasterUserPassword

マスターユーザーのパスワード

  • MySQLの場合
    「/」、「@」、「"」、「 」、「'」を除く、印字可能なASCII文字が使用できます。1〜41文字。
  • PostgreSQLの場合
    「/」、「@」、「"」、「 」、「'」を除く、印刷可能なASCII文字が使用できます。1〜128文字。
  • MariaDBの場合
    「/」、「@」、「"」、「 」、「'」を除く、印刷可能なASCII文字が使用できます。1〜41文字。
文字列  
MasterUsername

マスタユーザー名

  • MySQLの場合
    • アルファベット・数字・アンダースコア(' _ ') が使用できます
    • 最初の文字はアルファベットである必要があります
    • MySQL の予約語は使用できません
    • 1〜16文字
  • PostgreSQLの場合
    • アルファベット・数字・アンダースコア(' _ ') が使用できます
    • 最初の文字はアルファベットである必要があります
    • PostgreSQLの予約語は使用できません
    • 1〜63文字
  • MariaDBの場合
    • アルファベット・数字・アンダースコア(' _ ') が使用できます
    • 最初の文字はアルファベットである必要があります
    • PostgreSQLの予約語は使用できません
    • 1〜16文字
文字列  
MultiAZ 冗長化機能を有効にするかどうか   真偽値  
NiftyMultiAZType 冗長構成タイプ
使用する冗長構成のタイプを指定
値:0(データ優先) | 1(性能優先)
  数値 0 ニフクラ独自仕様
NiftyReadReplicaDBInstanceIdentifier

リードレプリカのDBサーバー名

  • ※1〜63字のアルファベット・数字・ハイフン('-')が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
  文字列 ニフクラ独自仕様
OptionGroupName
  • ※指定不可
  文字列  
Port アクセス可能なポート番号
値:1150〜65535
  数値 MySQL:3306
PostgreSQL:5432
 
PreferredBackupWindow

バックアップ時間帯

  • ※自動バックアップが有効の場合に日次のバックアップが行われる時間帯を指定します
  • ※30分間以上の時間帯を指定する必要があります
  • ※指定がない場合には、リージョンごとに定められた10時間の中からランダムに30分間が決定されます
    時間帯については、クラウド技術仕様(RDB:自動バックアップ)をご参照ください
  • ※時刻の指定はUTCで行ってください
  • ※PreferredMaintenanceWIndowと重複した時間帯を設定することはできません
  • ※バックアップは条件により30分を超えて行われることがあります
形式: hh24:mi-hh24:mi
  文字列 地域ごとに決まった10時間の中からランダムに選ばれた30分間  
PreferredMaintenanceWindow

メンテナンス時間帯

  • ※週次のメンテナンスが行われる時間帯を指定します
  • ※30分間以上23時間30分以内の時間帯を指定する必要があります
  • ※指定がない場合には、リージョンごとに定められた10時間の中からランダムに30分間が決定されます(曜日もランダムで決定されます)
    時間帯については、クラウド技術仕様(RDB:メンテナンス)をご参照ください
  • ※時刻の指定はUTCで行ってください
  • ※メンテナンスの内容によってはDBサーバーの停止やDBサービスの再起動が行われる場合があります(詳しくはユーザーガイドを参照してください)
  • ※バックアップは条件により30分を超えて行われることがあります
形式:ddd:hh24:mi-ddd:hh24:mi
例. Sun:05:00-Sun:06:00
曜日部分の値: Mon, Tue, Wed, Thu, Fri, Sat, Sun
  文字列 地域ごとに決まった8時間の中からランダムに選ばれた30分間  
PubliclyAccessible グローバルIPアドレスを有効にするかどうか
  • ※リードレプリカにはマスターDBと同じ値が適用されます。
  真偽値 true  
VpcSecurityGroupIds.member.N
  • ※指定不可
  文字配列  
NiftyStorageType ディスクタイプ
値:0(HDD) | 1(フラッシュドライブ)
  数値 0 ニフクラ独自仕様
NiftyNetworkId プライベートLANのネットワークユニークID   文字列 ニフクラ独自仕様
NiftyVirtualPrivateAddress 仮想ロードバランサー用のプライベートIPアドレス ○(プライベートLANを利用している場合) 文字列 ニフクラ独自仕様
NiftyMasterPrivateAddress 主系DBサーバー用のプライベートIPアドレス ○(プライベートLANを利用している場合) 文字列 ニフクラ独自仕様
NiftySlavePrivateAddress 待機系DBサーバー用のプライベートIPアドレス ○(プライベートLANを利用している場合、かつ、NiftyMultiAZType = 0 の場合) 文字列 ニフクラ独自仕様
NiftyReadReplicaPrivateAddress リードレプリカ用のプライベートIPアドレス ○(プライベートLANを利用している場合、かつ、NiftyMultiAZType = 1 の場合) 文字列 ニフクラ独自仕様

レスポンス

XML

status

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

result
要素名 説明 備考
CreateDBInstanceResponse ルート  
CreateDBInstanceResult 結果  
DBInstance DBサーバー  
AllocatedStorage 割り当てるディスク容量(GB) 数値  
AutoMinorVersionUpgrade マイナーバージョンの自動アップデートを行うかどうか 真偽値 固定値falseを返却
AvailabilityZone DBサーバーのゾーン 文字列  
BackupRetentionPeriod バックアップ保持期間 数値  
DBInstanceClass DBサーバータイプ 文字列  
DBInstanceIdentifier DBサーバー名 文字列  
DBInstanceStatus DBサーバーのステータス 文字列  
DBName DB名 文字列  
DBParameterGroups DBパラメーターグループ情報リスト リスト  
DBParameterGroup DBパラメーターグループ  
DBParameterGroupName DBパラメーターグループ名 文字列  
ParameterApplyStatus DBパラメーターの適用ステータス
値:applying(適用中) | pending-reboot(再起動待ち) | in-sync(適用済み)
文字列  
DBSecurityGroups DBファイアウォールグループ情報リスト リスト  
DBSecurityGroups DBファイアウォールグループ  
DBSecurityGroupName DBファイアウォールグループ名 文字列  
Status DBファイアウォールグループのステータス
値:active(有効) | adding(適用中) | removing(取り外し中) | failed(変更失敗)
文字列  
Engine データベースエンジン
値:MySQL|postgres
文字列  
EngineVersion データベースエンジンのバージョン 文字列  
LicenseModel DBサーバーのライセンスモデル 文字列  
MasterUsername DBサーバーのマスタユーザー名 文字列  
MultiAZ 冗長化機能が有効かどうか 真偽値  
NiftyMultiAZType 冗長構成タイプ 文字列 ニフクラ独自仕様
OptionGroupMemberships オプショングループ情報リスト リスト  
OptionGroupMembership オプショングループ情報  
OptionGroupName

下記の固定値を返却

  • DBエンジンがMySQL 5.5系の場合、default:mysql-5-5
  • DBエンジンがMySQL 5.6系の場合、default:mysql-5-6
  • DBエンジンがMySQL 5.7系の場合、default:mysql-5-7
  • DBエンジンがPostgreSQL9.3系の場合、default:postgres-9-3
  • DBエンジンがMariaDB10.1系の場合、default:mariadb-10-1
文字列  
Status オプショングループのステータス 文字列 固定値in-syncを返却
PendingModifiedValues 保留の修正情報  
MasterUserPassword 保留中のDBサーバーのマスターユーザー名 文字列  
PreferredBackupWindow バックアップ時間 文字列  
PreferredMaintenanceWindow メンテナンス時間 文字列  
PubliclyAccessible グローバルIPアドレスを有効にするかどうか 真偽値  
ReadReplicaDBInstanceIdentifiers リードレプリカ名 文字配列  
VpcSecurityGroups
  • ※返却値なし
リスト  
NiftyStorageType ディスクタイプ 数値 ニフクラ独自仕様
NiftyNetworkId プライベートLANのネットワークユニークID 文字列 ニフクラ独自仕様
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTP
ステータスコード
説明
Client.InvalidParameterCannotSpecify.AllocatedStorage AllocatedStorage should specify the multiple of 50. Sender 400 AllocatedStorageに50の倍数でない値を指定した場合
Client.InvalidParameterCannotSpecify.BackupRetentionPeriod Multi-AZ deployment Type: 1 is not enabled for this database instance. To enable Multi-AZ deployment Type: 1, set the backup retention period to a non-zero value. Sender 400 NiftyMultiAZType=1の時、BackupRetentionPeriodに0を指定した場合
Client.InvalidParameterCannotSpecify.DBInstanceClass Specified DB Instance class is not available in the specified Availability Zone. Sender 400 指定されたAvailabilityZoneで作成できないDBサーバータイプを指定した場合
Client.InvalidParameterCannotSpecify.DBName DBName INTO cannot be used. It is a reserved word for this engine Sender 400 DBNameに予約語を指定した場合
Client.InvalidParameterCannotSpecify.Engine Multi-AZ deployment Type: 1 is not enabled for this database instance. To enable Multi-AZ deployment Type: 1, set the engine to a mysql. Sender 400 NiftyMultiAZType=1の時、 Engineにpostgresまたはmariadbを指定した場合
Client.InvalidParameterCannotSpecify.MasterUsername MasterUsername INTO cannot be used as it is a reserved word used by the engine Sender 400 MasterUsernameに予約語を指定した場合
Client.InvalidParameterCannotSpecify.MasterUserPassword The parameter MasterUserPassword is not a valid password. Only printable ASCII characters besides '/', '@', '"', ' ', ''' may be used. Sender 400 MasterUserPasswordに無効な値(@など)を指定した場合
Client.InvalidParameterCannotSpecify.NiftyMasterPrivateAddress NiftyMasterPrivateAddress is not allowed in the range of 10.0.0.0/8. Sender 400 NiftyMasterPrivateAddressに許可されないIPアドレスを指定した場合
Client.InvalidParameterCannotSpecify.NiftyReadReplicaPrivateAddres NiftyReadReplicaPrivateAddress is not allowed in the range of 10.0.0.0/8. Sender 400 NiftyReadReplicaPrivateAddressに許可されないIPアドレスを指定した場合
Client.InvalidParameterCannotSpecify.NiftySlavePrivateAddress NiftySlavePrivateAddress is not allowed in the range of 10.0.0.0/8. Sender 400 NiftySlavePrivateAddressに許可されないIPアドレスを指定した場合
Client.InvalidParameterCannotSpecify.NiftyVirtualPrivateAddress NiftyVirtualPrivateAddress is not allowed in the range of 10.0.0.0/8. Sender 400 NiftyVirtualPrivateAddressに許可されないIPアドレスを指定した場合
Client.InvalidParameterCannotSpecify.PreferredBackupWindow Invalid backup window time '23:00-24:00' specified. Should be specified as a time hh24:mi (24H Clock UTC). Example: 03:15 Sender 400 PreferredBackupWindowに24:00を指定した場合
Backup window must be at least 30 minutes. Sender 400 PreferredBackupWindowに30分未満を指定した場合
The specified backup window overlaps all available default maintenance windows. Shrink the backup window or specify a non-overlapping maintenance window. Sender 400 PreferredBackupWindowにPreferredMaintenanceWindowを設定する余地がない時間を指定した場合(0:00-23:40 等)
Client.InvalidParameterCannotSpecify.PreferredMaintenanceWindow Maintenance window must be at least 30 minutes. Sender 400 PreferredMaintenanceWindowに30分未満を指定した場合
Maintenance window must be less than 24 hours. Sender 400 PreferredMaintenanceWindowに24時間を超える値を指定した場合
The specified maintenance window overlaps all available default backup windows. Shrink the maintenance window or specify a non-overlapping backup window. Sender 400 PreferredMaintenanceWindowにPreferredBackupWindowを設定する余地がない時間を指定した場合(0:00-23:40 等)
Maintenance window cannot end before it begins. Sender 400 PreferredMaintenanceWindowのTOがFROMより前の場合
Client.InvalidParameterCombination.DBParameterGroupFamily.and.DBParameterGroup
  • MySQLの場合
    The Parameter Group default.mysql5.5 with DBParameterGroupFamily mysql5.5 cannot be used for this instance. Please use a Parameter Group with DBParameterGroupFamily mysql5.6
  • PostgreSQLの場合
    The Parameter Group default.postgresn.n with DBParameterGroupFamily postgresn.n cannot be used for this instance. Please use a Parameter Group with DBParameterGroupFamily postgres9.3
  • MariaDBの場合
    The Parameter Group default.mariadbn.n with DBParameterGroupFamily mariadbn.n cannot be used for this instance. Please use a Parameter Group with DBParameterGroupFamily mariadb10.1
Sender 400 DBサーバーのDBParameterGroupFamilyと異なるDBパラメータグループを指定した場合
Client.InvalidParameterDuplicate.DBInstanceIdentifier DB Instance already exists Sender 400 すでに存在するDBInstanceIdentifierを指定した場合
Client.InvalidParameterDuplicate.DBInstanceIdentifier.and.NiftyReadReplicaDBInstanceIdentifier can not set the same value in DBInstanceIdentifier and NiftyReadReplicaDBInstanceIdentifier. Sender 400 DBInstanceIdentifierとNiftyReadReplicaDBInstanceIdentifierに、同じ値を指定した場合
Client.InvalidParameterDuplicate.PreferredBackupWindow.and.PreferredMaintenanceWindow The backup window and maintenance window must not overlap. Sender 400 PreferredBackupWindowとPreferredMaintenanceWindowが重なるように指定した場合
Client.InvalidParameterDuplicate.PrivateAddress Private addresses are not unique: 192.168.1.112 Sender 400 NiftyVirtualPrivateAddress、NiftyMasterPrivateAddress、NiftySlavePrivateAddress、NiftyReadReplicaPrivateAddressに重複したIPアドレスを指定した場合
Private address is already in use: 192.168.1.110 Sender 400 NiftyVirtualPrivateAddress、NiftyMasterPrivateAddress、NiftySlavePrivateAddress、NiftyReadReplicaPrivateAddressにすでに使用済みのIPアドレスを指定した場合
Client.InvalidParameterFormat.DBInstanceIdentifier The parameter DBInstanceIdentifier 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 DBInstanceIdentifierに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterFormat.DBName DBName must begin with a letter and contain only alphanumeric characters. Sender 400 DBNameに数字から始まる値を指定した場合
Client.InvalidParameterFormat.MasterUsername Invalid master user name Sender 400 MasterUsernameに数字から始まる値を指定した場合
Client.InvalidParameterFormat.NiftyMasterPrivateAddress Invalid NiftyMasterPrivateAddress: aaa.bbb.ccc.ddd. Sender 400 NiftyMasterPrivateAddressにIPアドレスとして無効な値を指定した場合
Client.InvalidParameterFormat.NiftyReadReplicaDBInstanceIdentifier The parameter NiftyReadReplicaDBInstanceIdentifier 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 NiftyReadReplicaDBInstanceIdentifierに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterFormat.NiftyReadReplicaPrivateAddress Invalid NiftyReadReplicaPrivateAddress: aaa.bbb.ccc.ddd. Sender 400 NiftyReadReplicaPrivateAddressにIPアドレスとして無効な値を指定した場合
Client.InvalidParameterFormat.NiftySlavePrivateAddress Invalid NiftySlavePrivateAddress: aaa.bbb.ccc.ddd. Sender 400 NiftySlavePrivateAddressにIPアドレスとして無効な値を指定した場合
Client.InvalidParameterFormat.NiftyVirtualPrivateAddress Invalid NiftyVirtualPrivateAddress: aaa.bbb.ccc.ddd. Sender 400 NiftyVirtualPrivateAddressにIPアドレスとして無効な値を指定した場合
Client.InvalidParameterFormat.PreferredBackupWindow Invalid backup window time '11:22' specified. Should be specified as a time hh24:mi (24H Clock UTC). Example: 03:15 Sender 400 PreferredBackupWindowに無効なフォーマット(11:22 等)で指定した場合
Client.InvalidParameterFormat.PreferredMaintenanceWindow Invalid maintenance window format. Should be specified as a range ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). Example: Sun:23:45-Mon:00:15 Sender 400 PreferredMaintenanceWindowに無効な値(aaa 等)を指定した場合
Invalid maintenance window time 'aaa:12:00' specified. Should be specified as a time ddd:hh24:mi (24H Clock UTC). Example: Mon:00:15 Sender 400 PreferredMaintenanceWindowに無効なフォーマットの値(sun:10:11-01:11 等)を指定した場合
Client.InvalidParameterIllegalInput.AllocatedStorage - Sender 400 AllocatedStorageに数値でない値を指定した場合
Client.InvalidParameterIllegalInput.AvailabilityZone aaa is not a valid availability zone. Sender 400 存在しないAvailabilityZoneを指定した場合
Client.InvalidParameterIllegalInput.BackupRetentionPeriod - Sender 400 BackupRetentionPeriodに数値でない値を指定した場合
Client.InvalidParameterIllegalInput.DBInstanceClass Invalid DB instance class:aaa Sender 400 DBInstanceClassに存在しないDBサーバータイプを指定した場合
Client.InvalidParameterIllegalInput.DBParameterGroupName Invalid parameter group name: sample@db Sender 400 DBParameterGroupNameに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterIllegalInput.Engine Invalid DB engine: aaa Sender 400 Engineに有効でない値を指定した場合
Client.InvalidParameterIllegalInput.EngineVersion
  • MySQLの場合
    Cannot find version 5.5.32 for mysql
  • PostgreSQLの場合
    Cannot find version 9.3.2 for postgres
  • MariaDBの場合
    Cannot find version 10.1.10 for mariadb
Sender 400 EngineVersionに対応していないバージョンを指定した場合
Client.InvalidParameterIllegalInput.LicenseModel
  • MySQLの場合
    Invalid license model 'aaa' for engine 'mysql'. Valid license models are: general-public-license
  • PostgreSQLの場合
    Invalid license model 'aaa' for engine 'postgres'. Valid license models are: postgresql-license
  • MariaDBの場合
    Invalid license model 'aaa' for engine 'mariadb'. Valid license models are: general-public-license
Sender 400 LicenseModelに無効な値を指定した場合
Client.InvalidParameterIllegalInput.MultiAZ - Sender 400 MultiAZに真偽値型でない値を指定した場合
Client.InvalidParameterIllegalInput.NiftyMultiAZType Invalid Multi-AZ deployment Type: 9 Sender 400 NiftyMultiAZTypeに 0,1以外を指定した場合
Client.InvalidParameterIllegalInput.NiftyStorageType Invalid Storage Type: 9 Sender 400 StrageTypeに 0,1以外を指定した場合
Client.InvalidParameterIllegalInput.Port - Sender 400 Portに数値でない値を指定した場合
Client.InvalidParameterIllegalInput.PubliclyAccessible - Sender 400 PubliclyAccessibleに真偽値型でない値を指定した場合
Client.InvalidParameterMissing.AvailabilityZone AvailabilityZone is required Sender 400 プライベートLANを利用している時、AvailabilityZoneを指定しなかった場合
Client.InvalidParameterMissing.NiftyMasterPrivateAddress The parameter NiftyMasterPrivateAddress must be provided and must not be blank. Sender 400 プライベートLANを利用している時、NiftyMasterPrivateAddressを指定しなかった場合
Client.InvalidParameterMissing.NiftyReadReplicaDBInstanceIdentifier The parameter NiftyReadReplicaDBInstanceIdentifier must be provided and must not be blank for ReadReplica instances. Sender 400 NiftyMultiAZType=1の時、NiftyReadReplicaDBInstanceIdentifierを指定しなかった場合
Client.InvalidParameterMissing.NiftyReadReplicaPrivateAddress The parameter NiftyReadReplicaPrivateAddress must be provided and must not be blank for ReadReplica instances. Sender 400 プライベートLANを利用している、かつ、NiftyMultiAZType=1の時、NiftyReadReplicaPrivateAddressを指定しなかった場合
Client.InvalidParameterMissing.NiftySlavePrivateAddress The parameter NiftySlavePrivateAddress must be provided and must not be blank for Multi-AZ instances. Sender 400 プライベートLANを利用している、かつ、NiftyMultiAZType=0の時、NiftySlavePrivateAddressを指定しなかった場合
Client.InvalidParameterMissing.NiftyVirtualPrivateAddress The parameter NiftyVirtualPrivateAddress must be provided and must not be blank. Sender 400 プライベートLANを利用している時、NiftyVirtualPrivateAddressを指定しなかった場合
Client.InvalidParameterNotFound.DBParameterGroup DBParameterGroup not found: aaa Sender 404
  • 存在しないDBParameterGroupNameを指定した場合
  • "default."で始まり、"default."より後の値がEngine及びEngineVersionに紐づくDBパラメータグループファミリと一致しない場合
    例) Engine=mysql、EngineVersion=5.6.34、DBパラメータファミリ=mysql5.6の場合
    ⇒「default.mysql5.6」以外で「default.〜」形式の場合はエラー
Client.InvalidParameterNotFound.DBSecurityGroup DBSecurityGroup not found: aaa Sender 404 存在しないDBSecurityGroupNameを指定した場合
Client.InvalidParameterNotFound.NiftyNetworkId Private LAN net-123456ab does not exist. Sender 404 存在しないNiftyNetWorkIdを指定した場合
Client.InvalidParameterOutOfRange.AllocatedStorage Invalid storage size: 5,000. The storage size for the specified instance class and database engine must be between 50 and 250 GB. Sender 400 AllocatedStorageに50〜指定された最大値(デフォルトは250)でない値を指定した場合
Client.InvalidParameterOutOfRange.NiftyMasterPrivateAddress Invalid NiftyMasterPrivateAddress: 192.168.100.100. Valid range is 192.168.1.1-192.168.1.254 Sender 400 NiftyMasterPrivateAddressにサブネットの範囲外のIPアドレスを指定した場合
Invalid NiftyMasterPrivateAddress: 192.168.1.113/8. Valid CIDR prefix is /24 Sender 400 NiftyMasterPrivateAddressのプレフィックスにプライベートLAN作成時に指定したプレフィックスと異なる値を指定した場合
Client.InvalidParameterOutOfRange.NiftyReadReplicaPrivateAddress Invalid NiftyReadReplicaPrivateAddress: 192.168.100.100. Valid range is 192.168.1.1-192.168.1.254 Sender 400 NiftyReadReplicaPrivateAddressにサブネットの範囲外のIPアドレスを指定した場合
Invalid NiftyReadReplicaPrivateAddress: 192.168.1.115/8. Valid CIDR prefix is /24 Sender 400 NiftyReadReplicaPrivateAddressのプレフィックスにプライベートLAN作成時に指定したプレフィックスと異なる値を指定した場合
Client.InvalidParameterOutOfRange.NiftySlavePrivateAddress Invalid NiftySlavePrivateAddress: 192.168.100.100. Valid range is 192.168.1.1-192.168.1.254 Sender 400 NiftySlavePrivateAddressにサブネットの範囲外のIPアドレスを指定した場合
Invalid NiftySlavePrivateAddress: 192.168.1.114/8. Valid CIDR prefix is /24 Sender 400 NiftySlavePrivateAddressのプレフィックスにプライベートLAN作成時に指定したプレフィックスと異なる値を指定した場合
Client.InvalidParameterOutOfRange.NiftyVirtualPrivateAddress Invalid NiftyVirtualPrivateAddress: 192.168.100.100. Valid range is 192.168.1.1-192.168.1.254 Sender 400 NiftyVirtualPrivateAddressにサブネットの範囲外のIPアドレスを指定した場合
Invalid NiftyVirtualPrivateAddress: 192.168.1.112/8. Valid CIDR prefix is /24 Sender 400 NiftyVirtualPrivateAddressのプレフィックスにプライベートLAN作成時に指定したプレフィックスと異なる値を指定した場合
Client.InvalidParameterOutOfRange.Port Invalid endpoint port: 100000. Valid range is 1150-65535 Sender 400 Portに1150-65535でない値を指定した場合
Client.InvalidParameterRequired.AllocatedStorage The parameter AllocatedStorage must be provided and must not be null. Sender 400 必須のAllocatedStorageを指定しなかった場合
Client.InvalidParameterRequired.DBInstanceClass Invalid DB instance class:null Sender 400 必須のDBInstanceClassを指定しなかった場合
Client.InvalidParameterRequired.DBInstanceIdentifier The parameter DBInstanceIdentifier must be provided and must not be blank. Sender 400 必須のDBInstanceIdentifierを指定しなかった場合
Client.InvalidParameterRequired.Engine Invalid DB engine: null Sender 400 必須のEngineを指定しなかった場合
Client.InvalidParameterRequired.MasterUsername Invalid master user name Sender 400 必須のMasterUsernameを指定しなかった場合
Client.InvalidParameterRequired.MasterUserPassword The parameter MasterUserPassword must be provided and must not be blank. Sender 400 必須のMasterUserPasswordを指定しなかった場合
Client.InvalidParameterTooLarge.BackupRetentionPeriod Invalid backup retention period: 100. Retention period must be between 0 and 10. Sender 400 BackupRetentionPeriodに10より大きい数字を指定した場合
Client.InvalidParameterTooLong.DBInstanceIdentifier The parameter DBInstanceIdentifier is not a valid identifier because it is longer than 63 characters. Sender 400 DBInstanceIdentifierに63文字を超える値を指定した場合
Client.InvalidParameterTooLong.DBName DBName must be less than 64 characters long. Sender 400 DBNameに64文字を超える値を指定した場合
Client.InvalidParameterTooLong.DBParameterGroupName Invalid parameter group name:sample-parameter123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890 Sender 400 DBParameterGroupNameに255文字を超える値を指定した場合
Client.InvalidParameterTooLong.MasterUsername Invalid master user name Sender 400
  • Engine=MySQLの時、MasterUsernameに16文字を超える値を指定した場合
  • Engine=postgresの時、MasterUsernameに63文字を超える値を指定した場合
  • Engine=MariaDBの時、MasterUsernameに16文字を超える値を指定した場合
Client.InvalidParameterTooLong.MasterUserPassword The parameter MasterUserPassword is not a valid password because it is longer than 41 characters. Sender 400 MasterUserPasswordに41文字を超える値を指定した場合
Client.InvalidParameterTooLong.NiftyReadReplicaDBInstanceIdentifier The parameter NiftyReadReplicaDBInstanceIdentifier is not a valid identifier because it is longer than 63 characters. Sender 400 NiftyReadReplicaDBInstanceIdentifierに63文字を超える値を指定した場合
Client.LimitExceeded.NumberOfDBInstance Request would result in user exceeding the allowed number of DB Instances Sender 400 作成可能なDBサーバーの上限に達している場合
Client.ResourceIncorrectState.DBSecurityGroup.Processing DBSecurityGroup is not in available state. Sender 400 設定しようとしたDBファイアウォールグループのルールに、ステータス「authorizing」または「revoking」のルールが存在する場合
Client.ZoneMisMatch.DBInstance.and.DBSecurityGroup DBSecurityGroup sample-security cannot be used in west-11 zone. The availability zone of sample-security is east-21. Sender 400 指定されたゾーンと異なるゾーンに所属するDBファイアウォールグループを指定した場合
Client.ZoneMisMatch.DBInstance.and.NiftyNetworkId Private LAN net-123456ab does not belong to availability zone west-12. Sender 400 指定されたNiftyNetworkIdが所属するゾーンと指定されたAvailabilityZoneが一致しない場合
Client.ZoneMisMatch.NiftyStorageType Invalid Storage Type: 1 Sender 400 指定したAvailabilityZoneに存在しないストレージタイプを指定した場合

サンプル

リクエストサンプル
https://rdb.jp-east-1.api.cloud.nifty.com/
    ?Action=CreateDBInstance
    &AllocatedStorage=50
    &AvailabilityZone=east-13
    &BackupRetentionPeriod=1
    &DBInstanceClass=db.mini
    &DBInstanceIdentifier=mydbinstance
    &DBName=mydb
    &DBParameterGroupName=default.mysql5.6
    &DBSecurityGroups.member.1=mydbsecuritygroup
    &Engine=mysql
    &EngineVersion=5.6.12
    &LicenseModel=general-public-license
    &MasterUserPassword=mydbpassword
    &MasterUsername=mydbuser
    &MultiAZ=true
    &Port=3306
    &PreferredBackupWindow=05%3A30-06%3A00
    &PreferredMaintenanceWindow=Mon%3A06%3A01-Mon%3A07%3A31
    &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"?>
<CreateDBInstanceResponse>
  <CreateDBInstanceResult>
  <DBInstance>
    <AllocatedStorage>50</AllocatedStorage>
    <AutoMinorVersionUpgrade>false</AutoMinorVersionUpgrade>
    <AvailabilityZone>east-13</AvailabilityZone>
    <BackupRetentionPeriod>1</BackupRetentionPeriod>
    <DBInstanceClass>db.mini</DBInstanceClass>
    <DBInstanceIdentifier>mydbinstance</DBInstanceIdentifier>
    <DBInstanceStatus>creating</DBInstanceStatus>
    <DBName>mydb</DBName>
    <DBParameterGroups>
      <DBParameterGroup>
        <DBParameterGroupName>default.mysql5.6</DBParameterGroupName>
        <ParameterApplyStatus>in-sync</ParameterApplyStatus>
      </DBParameterGroup>
    </DBParameterGroups>
    <DBSecurityGroups>
      <DBSecurityGroup>
        <DBSecurityGroupName>mydbsecuritygroup</DBSecurityGroupName>
        <Status>active</Status>
      </DBSecurityGroup>
    </DBSecurityGroups>
    <Engine>mysql</Engine>
    <EngineVersion>5.6.12</EngineVersion>
    <LicenseModel>general-public-license</LicenseModel>
    <MasterUsername>mydbuser</MasterUsername>
    <MultiAZ>true</MultiAZ>
    <OptionGroupMemberships>
      <OptionGroupMembership>
        <OptionGroupName>default:mysql-5-6</OptionGroupName>
        <Status>in-sync</Status>
      </OptionGroupMembership>
    </OptionGroupMemberships>
    <PendingModifiedValues>
      <MasterUserPassword>****</MasterUserPassword>
    </PendingModifiedValues>
    <PreferredBackupWindow>05:30-06:00</PreferredBackupWindow>
    <PreferredMaintenanceWindow>mon:06:01-mon:07:31</PreferredMaintenanceWindow>
    <PubliclyAccessible>true</PubliclyAccessible>
    <ReadReplicaDBInstanceIdentifiers/>
    <SecondaryAvailabilityZone>east-13</SecondaryAvailabilityZone>
    <VpcSecurityGroups/>
    <NiftyStorageType>0</NiftyStorageType>
  </DBInstance>
  </CreateDBInstanceResult>
  <ResponseMetadata>
    <RequestId>06f8640f-5112-4c0b-a99e-158412abd428</RequestId>
  </ResponseMetadata>
</CreateDBInstanceResponse>

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