本文へジャンプします。

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

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

RDB:CreateDBInstanceReadReplica

処理概要

DBサーバーからリードレプリカを作成します。

すべてのリードレプリカは冗長化機能無効・自動バックアップ無効で作成されます。

リクエストパラメーターで指定したもの以外の属性は、作成元のDBサーバーから継承されます。

[重要]
作成元のDBサーバーは自動バックアップが有効でなければなりません。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
AutoMinorVersionUpgrade
  • ※指定不可
  真偽値  
AvailabilityZone
  • ※指定不可
  文字列  
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個連続させたりすることはできません
文字列  
Iops
  • ※指定不可
  数値  
OptionGroupName
  • ※指定不可
  文字列  
Port ※指定不可   数値 マスタDBの値と同じものが使用されます
PubliclyAccessible
  • ※指定不可
  真偽値  
SourceDBInstanceIdentifier

リードレプリカの元になるDBサーバーの名前

  • ※DBサーバーは5つまでリードレプリカを持つことができます
  • ※存在するDBサーバーの名前である必要があります
  • ※リードレプリカの DB サーバー名を指定することはできません
文字列  
NiftyStorageType ディスクタイプ
使用するディスクのタイプを指定
値:0(HDD) | 1(フラッシュドライブ)
  数値 0 ニフティクラウド独自仕様
NiftyReadReplicaPrivateAddress リードレプリカ用のプライベートIPアドレス
(プライベートLANを利用している場合)
文字列 ニフティクラウド独自仕様

レスポンス

XML

status

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

result
要素名 説明 備考
CreateDBInstanceReadReplicaResponse ルート  
CreateDBInstanceReadReplicaResult 結果  
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ファイアウォールグループ情報リスト リスト  
DBSecurityGroup DBファイアウォールグループ  
DBSecurityGroupName DBファイアウォールグループ名 文字列  
Status DBファイアウォールグループのステータス
値:active(有効) | adding(適用中) | removing(取り外し中) | failed(変更失敗)
文字列  
Engine データベースエンジン 文字列  
EngineVersion データベースエンジンのバージョン 文字列  
LicenseModel DBサーバーのライセンスモデル 文字列  
MasterUsername DBサーバーのマスターユーザー 文字列  
MultiAZ 冗長化機能が有効かどうか 真偽値  
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 保留の修正情報  
PreferredBackupWindow バックアップ時間 文字列  
PreferredMaintenanceWindow メンテナンス時間 文字列  
PubliclyAccessible グローバルIPアドレスかプライベートIPアドレスか 真偽値 固定値trueを返却
ReadReplicaDBInstanceIdentifiers リードレプリカのDBサーバー名 文字配列  
ReadReplicaSourceDBInstanceIdentifier リードレプリカのマスターDBサーバー名 文字列  
VpcSecurityGroups ※返却値なし リスト  
NiftyStorageType ディスクタイプ 数値 ニフティクラウド独自仕様
NiftyNetworkId プライベートLANのネットワークユニークID 文字列 ニフティクラウド独自仕様
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTP
ステータスコード
説明
DBInstanceAlreadyExists DB Instance already exists Sender 400 DBInstanceIdentifierにすでに存在するDBサーバー名を指定した場合
DBInstanceNotFound The source instance could not be found: aaa Sender 404 SourceDBInstanceIdentifierに存在しないIDを指定した場合
DBParameterGroupNotFound DBParameterGroupName does not refer to an existing DB Parameter Group. Sender 404 パラメーターグループが存在しない場合
DBSecurityGroupNotFound DBSecurityGroupName does not refer to an existing DB Security Group. Sender 404 存在しないDBSecurityGroupを指定した場合
InstanceQuotaExceeded Request would result in user exceeding the allowed number of DB Instances. Sender 400 作成できるDBサーバー数の上限に達している場合
InsufficientDBInstanceCapacity Specified DB Instance class is not available in the specified Availability Zone. Sender 400 作成されるAZでは指定できないDBサーバータイプを指定した場合
InvalidDBInstanceState The specified DB Instance is not in the available state. Sender 400 指定したSourceDBInstanceIdentifierのステータスが有効でない場合
InvalidDBInstanceState Automated backups are not enabled for this database instance. To enable automated backups, use ModifyDBInstance to set the backup retention period to a non-zero value. Sender 400 リードレプリカ元のDBサーバーのBackupRetentionPeriodが0のとき
InvalidDBInstanceState The source DB Instance specified is only allowed a maximum of 5 read replicas. Sender 400 1つのDBサーバーに紐付くリードレプリカ数の上限に達している場合
InvalidParameterValue The parameter SourceDBInstanceIdentifier 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 SourceDBInstanceIdentifierに無効な(ハイフンで終わるなど)値を指定した場合
Invalid database identifier: Sender 400 SourceDBInstanceIdentifierに63文字以上指定した場合
Invalid DB instance class:aaa Sender 400 DBInstanceClassに無効な値を指定した場合
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に無効な値を指定した場合
Invalid endpoint port: 70000. Valid range is 1150-65535 Sender 400 Portに1150-65535でない値を指定した場合
Invalid NiftyStorageType: 2 Sender 400 NiftyStorageTypeに 0,1以外を指定した場合
The parameter DBInstanceIdentifier must be provided and must not be blank. Sender 400 DBInstanceIdentifierを空で値を指定した場合
The parameter NiftyReadReplicaPrivateAddress must be provided and must not be blank. Sender 400 プライベートLANを利用している場合で、NiftyReadReplicaPrivateAddressの指定がないとき
Invalid NiftyReadReplicaPrivateAddress aaa.bbb.ccc.ddd. Sender 400 NiftyReadReplicaPrivateAddressにIPアドレスとして無効な値を指定したとき
NiftyReadReplicaPrivateAddress is not allowed in the range of 10.0.0.0/8. Sender 400 NiftyReadReplicaPrivateAddressに許可されないIPアドレスを指定したとき
InvalidDBSecurityGroupState DBSecurityGroup is not in available state. Sender 400 設定しようとしたDBセキュリティグループのルールに、ステータス「authorizing」または「revoking」のルールが存在する場合

サンプル

リクエストサンプル
https://rdb.jp-east-1.api.cloud.nifty.com/
    ?Action=CreateDBInstanceReadReplica
    &SourceDBInstanceIdentifier=mydbinstance
    &DBInstanceIdentifier=mydbinstancereadreplica
    &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"?>
<CreateDBInstanceReadReplicaResponse>
  <CreateDBInstanceReadReplicaResult>
  <DBInstance>
    <AllocatedStorage>50</AllocatedStorage>
    <AutoMinorVersionUpgrade>false</AutoMinorVersionUpgrade>
    <AvailabilityZone>east-13</AvailabilityZone>
    <BackupRetentionPeriod>0</BackupRetentionPeriod>
    <DBInstanceClass>db.small</DBInstanceClass>
    <DBInstanceIdentifier>mydbinstancereadreplica</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>false</MultiAZ>
    <OptionGroupMemberships>
      <OptionGroupMembership>
        <OptionGroupName>default:mysql-5-6</OptionGroupName>
        <Status>in-sync</Status>
      </OptionGroupMembership>
    </OptionGroupMemberships>
    <PendingModifiedValues/>
    <PreferredBackupWindow>05:30-06:00</PreferredBackupWindow>
    <PreferredMaintenanceWindow>mon:06:01-mon:07:31</PreferredMaintenanceWindow>
    <PubliclyAccessible>true</PubliclyAccessible>
    <ReadReplicaDBInstanceIdentifiers/>
    <ReadReplicaSourceDBInstanceIdentifier>mydbinstance</ReadReplicaSourceDBInstanceIdentifier>
    <VpcSecurityGroups/>
    <NiftyStorageType>0</NiftyStorageType>
  </DBInstance>
</CreateDBInstanceReadReplicaResult>
  <ResponseMetadata>
  <RequestId>e2dc16db-bae8-4760-8775-d7dcb95b9daa</RequestId>
</ResponseMetadata>
</CreateDBInstanceReadReplicaResponse>

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