本文へジャンプします。

ニフクラ ユーザーガイド

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

CopyDBSnapshot

処理概要

DBスナップショットをコピーします。

コピー元のDBスナップショットはステータスが“available”でなければなりません。

自動バックアップ機能で作成されたDBスナップショットのみコピーすることができます。

指定するパラメーター

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

コピー元のDBスナップショット名

  • ※ステータスが“available”のDBスナップショットのみ指定できます
  • ※自動バックアップ機能で作成されたDBスナップショットのみ指定できます

TargetDBSnapshotIdentifier string

コピー先のDBスナップショット名

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

応答フィールド

フィールド (項目) 説明
CopyDBSnapshotResponse structure ルート
CopyDBSnapshotResult structure 結果
DBSnapshot structure DBスナップショット
備考: DBSnapshotの子要素はDescribeDBSnapshotsで返却される要素をすべて記載しているためAPIによっては返却されない要素もあります。実際のレスポンスはレスポンスサンプルを参照してください。
AllocatedStorage integer ディスク容量 (GB)
AvailabilityZone string DBスナップショットのゾーン
DBInstanceIdentifier string DBスナップショットの元になったDBサーバー名
DBSnapshotIdentifier string DBスナップショット名
Engine string DBスナップショットのデータベースエンジン
EngineVersion string DBスナップショットのデータベースエンジンバージョン
InstanceCreateTime timestamp DBスナップショットの元になったDBサーバーの作成日時
LicenseModel string DBスナップショットの元となったDBサーバーのライセンスモデル
MasterUsername string DBスナップショットの元となったDBサーバーのマスターユーザー名
OptionGroupName string

下記の固定値を返却

  • 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エンジンがPostgreSQL9.6系の場合、default:postgres-9-6
  • DBエンジンがPostgreSQL11系の場合、default:postgres-11
  • DBエンジンがPostgreSQL13系の場合、default:postgres-13

Port integer DBスナップショットの元となったDBサーバーのポート
SnapshotCreateTime timestamp DBスナップショット作成日時
SnapshotType string

DBスナップショットのタイプ

  • 値:automated(自動) | manual(手動)

Status string

DBスナップショットのステータス

  • 値:creating(作成中) | availabile(作成完了) | failed(作成失敗)

ResponseMetadata structure 共通メタ情報
RequestId string リクエスト識別子

エラー

コード メッセージ タイプ HTTPステータスコード 説明
Client.InvalidParameterCannotSpecify.CopySourceDBSnapshotIdentifier

Only automated snapshots can be copied.

Sender 400 SourceDBSnapshotIdentifierに手動作成したDBスナップショットを指定した場合
Client.InvalidParameterDuplicate.DBSnapshotIdentifier

Cannot create the snapshot because a snapshot with the identifier sample-snapshot already exists.

Sender 400 TargetDBSnapshotIdentifierにすでに存在するDBSnapshotIdentifierを指定した場合
Client.InvalidParameterFormat.CopySourceDBSnapshotIdentifier

The parameter SourceDBSnapshotIdentifier 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 SourceDBSnapshotIdentifierに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterFormat.DBSnapshotIdentifier

The parameter TargetDBSnapshotIdentifier 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 TargetDBSnapshotIdentifierに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterNotFound.CopySourceDBSnapshot

DBSnapshot not found: rdb:sample-snapshot-2017-05-20-19-14

Sender 404 SourceDBSnapshotIdentifierに存在しない自動作成されたDBSnapshotIdentifierを指定した場合
Client.InvalidParameterRequired.CopySourceDBSnapshotIdentifier

The parameter SourceDBSnapshotIdentifier must be provided and must not be blank.

Sender 400 必須のSourceDBSnapshotIdentifierを指定しなかった場合
Client.InvalidParameterRequired.DBSnapshotIdentifier

The parameter TargetDBSnapshotIdentifier must be provided and must not be blank.

Sender 400 必須のTargetDBSnapshotIdentifierを指定しなかった場合
Client.InvalidParameterTooLong.CopySourceDBSnapshotIdentifier

The parameter SourceDBSnapshotIdentifier is not a valid identifier because it is longer than 255 characters.

Sender 400 SourceDBSnapshotIdentifierに255文字を超える値を指定した場合
Client.InvalidParameterTooLong.DBSnapshotIdentifier

The parameter TargetDBSnapshotIdentifier is not a valid identifier because it is longer than 255 characters.

Sender 400 TargetDBSnapshotIdentifierに255文字を超える値を指定した場合
Client.LimitExceeded.NumberOfDBSnapshot

Request would result in user exceeding the allowed number of DB Snapshots.

Sender 400 作成可能なDBスナップショットの上限に達している場合
Client.ResourceIncorrectState.CopySourceDBSnapshot.Unavailable

The state of the DB Snapshot does not allow deletion.

Sender 400 DBスナップショットのステータスが有効でない場合

リクエストサンプル

    https://jp-east-1.rdb.api.nifcloud.com/
  ?Action=CopyDBSnapshot
  &SourceDBSnapshotIdentifier=rdb:mydbinstance-2013-11-30-06-28
  &TargetDBSnapshotIdentifier=mydbinstance-2013-11-30-06-28
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-12-09T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

  

応答サンプル

    <CopyDBSnapshotResponse>
  <CopyDBSnapshotResult>
    <DBSnapshot>
      <AllocatedStorage>50</AllocatedStorage>
      <AvailabilityZone>east-13</AvailabilityZone>
      <DBInstanceIdentifier>mydbinstance</DBInstanceIdentifier>
      <DBSnapshotIdentifier>mydbinstance-2013-11-30-06-28</DBSnapshotIdentifier>
      <Engine>mysql</Engine>
      <EngineVersion>5.6.12</EngineVersion>
      <InstanceCreateTime>2013-11-30T06:28:42.000Z</InstanceCreateTime>
      <LicenseModel>general-public-license</LicenseModel>
      <MasterUsername>mydbuser</MasterUsername>
      <OptionGroupName>default:mysql-5-6</OptionGroupName>
      <Port>3306</Port>
      <SnapshotCreateTime>2013-11-30T06:29:10.000Z</SnapshotCreateTime>
      <SnapshotType>manual</SnapshotType>
      <Status>available</Status>
    </DBSnapshot>
  </CopyDBSnapshotResult>
  <ResponseMetadata>
    <RequestId>1ed1b7c2-55ab-4188-ac46-2e5c6250a10c</RequestId>
  </ResponseMetadata>
</CopyDBSnapshotResponse>

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

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