本文へジャンプします。

このサイトは、FJcloud-VおよびFJcloud-Vを基盤としたクラウドサービスに関する技術情報を提供しています。
利用できる機能・サービスおよび一部仕様は各サービスで異なります。
利用できる機能・サービスおよび仕様差異は、各サービスサイトで提供されている案内を確認してください。

ユーザーガイド

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

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.6系の場合、default:mysql-5-6
  • DBエンジンがMySQL 5.7系の場合、default:mysql-5-7
  • DBエンジンがMySQL 8.0系の場合、default:mysql-8-0
  • DBエンジンがMySQL 8.4系の場合、default:mysql-8-4
  • DBエンジンがPostgreSQL9.6系の場合、default:postgres-9-6
  • DBエンジンがPostgreSQL11系の場合、default:postgres-11
  • DBエンジンがPostgreSQL13系の場合、default:postgres-13
  • DBエンジンがPostgreSQL17系の場合、default:postgres-17
␣␣␣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>

サイト内検索

APIメニュー

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

資料ダウンロード 見積シミュレーター

お申し込み

導入のご相談はお電話でも受け付けております。

※ FJcloud-Vをご契約の方に向けた窓口です。

0120-22-1200（平日 9:00～17:45）

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

ページの先頭へ