本文へジャンプします。

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

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

RDB:CreateDBSnapshot

処理概要

DBスナップショットを作成します。

作成元となるDBサーバーのステータスは"available"でなければなりません。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
DBInstanceIdentifier

スナップショットの元になるDBサーバー名

  • ※ステータスが"available"のDBサーバーのみ指定できます
文字列  
DBSnapshotIdentifier

作成するDBスナップショット名

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

レスポンス

XML

status

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

result
要素名 説明 備考
CreateDBSnapshotResponse ルート  
CreateDBSnapshotResult 結果  
DBSnapshot DBスナップショット名  
AllocatedStorage ディスク容量 (GB) 数値  
AvailabilityZone DBスナップショットのゾーン 文字列  
DBInstanceIdentifier DBスナップショットの元になったDBサーバー名 文字列  
DBSnapshotIdentifier DBスナップショット名 文字列  
Engine データベースエンジン 文字列  
EngineVersion データベースエンジンバージョン 文字列  
InstanceCreateTime DBサーバーの元になったDBサーバーの作成日時 日時  
LicenseModel DBスナップショットのライセンスモデル 文字列  
MasterUsername DBスナップショットのマスターユーザー 文字列  
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
文字列  
Port DBスナップショットのポート 数値  
SnapshotCreateTime DBスナップショット作成日時 日時  
SnapshotType DBスナップショットのタイプ
値:automated(自動) | manual(手動)
文字列  
Status DBスナップショットのステータス
値:creating(作成中) | availabile(作成完了) | failed(作成失敗)
文字列  
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTP
ステータスコード
説明
DBInstanceNotFound DBInstance not found: test Sender 404 DBInstanceIdentifierに存在しないDBスナップショット名を指定した場合
DBSnapshotAlreadyExists Cannot create the snapshot because a snapshot with the identifier mydbsnapshot already exists. Sender 400 DBSnapshotIdentifierにすでに存在するDBスナップショット名を指定した場合
InvalidDBSnapshotState Cannot create a snapshot because the database instance mydbsnapshot is not currently in the available state. Sender 400 作成元のDBサーバーのステータスがavailableでない場合
SnapshotQuotaExceeded Request would result in user exceeding the allowed number of DB Snapshots. Sender 400 作成できるスナップショットの上限に達している場合
InvalidParameterValue The parameter DBSnapshotIdentifier must be provided and must not be blank. Sender 400 必須のDBSnapshotIdentifierを指定しなかった場合
The parameter DBInstanceIdentifier must be provided and must not be blank. Sender 400 必須のDBInstanceIdentifierを指定しなかった場合
The parameter DBSnapshotIdentifier 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 DBSnapshotIdentifierに無効な(数字から始まるなど)値を指定した場合
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に無効な(数字から始まるなど)値を指定した場合
The parameter DBSnapshotIdentifier is not a valid identifier because it is longer than 255 characters. Sender 400 DBSnapshotIdentifierに255文字以上指定した場合
The parameter DBInstanceIdentifier is not a valid identifier because it is longer than 63 characters. Sender 400 DBInstanceIdentifierに63文字以上指定した場合
InvalidDBInstanceState Cannot create a snapshot because the DB Instance is a read replica Sender 400 作成元のDBサーバーがリードレプリカの場合

サンプル

リクエストサンプル
https://rdb.jp-east-1.api.cloud.nifty.com/
    ?Action=CreateDBSnapshot
    &DBInstanceIdentifier=mydbinstance
    &DBSnapshotIdentifier=mydbsnapshot
    &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"?>
<CreateDBSnapshotResponse>
  <CreateDBSnapshotResult>
    <DBSnapshot>
      <AllocatedStorage>50</AllocatedStorage>
      <AvailabilityZone>east-13</AvailabilityZone>
      <DBInstanceIdentifier>mydbinstance</DBInstanceIdentifier>
      <DBSnapshotIdentifier>mydbsnapshot</DBSnapshotIdentifier>
      <Engine>mysql</Engine>
      <EngineVersion>5.6.12</EngineVersion>
      <InstanceCreateTime>2013-11-30T09:55:59.000Z</InstanceCreateTime>
      <LicenseModel>general-public-license</LicenseModel>
      <MasterUsername>mydbuser</MasterUsername>
      <OptionGroupName>default:mysql-5-6</OptionGroupName>
      <Port>3306</Port>
      <SnapshotType>manual</SnapshotType>
      <Status>creating</Status>
    </DBSnapshot>
  </CreateDBSnapshotResult>
  <ResponseMetadata>
    <RequestId>02611a43-a2f1-4c4b-9703-1b31ae405d95</RequestId>
  </ResponseMetadata>
</CreateDBSnapshotResponse>

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