Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


11.22 スナップショットグループ単位でクローンを実行する

指定したスナップショットグループのThin Imageペアのクローンを実行します。スナップショットグループに含まれるすべてのペアについて一括でクローンを実行します。

実行権限

ストレージ管理者(ローカルバックアップ管理)

リクエストライン

PUT <ベースURL>/v1/objects/storages/<ストレージデバイスID>/snapshot-groups/<オブジェクトID>/actions/clone/invoke

このAPIはPOSTメソッドでも実行できます。

リクエストメッセージ

オブジェクトID

スナップショットグループの情報取得で取得したsnapshotGroupIdの値を指定します。

属性

説明

snapshotGroupId

string

(必須)クローンを実行するThin Imageペアが所属するスナップショットグループのオブジェクトID

1~32文字で指定します。大文字と小文字を区別します。

クエリパラメータ

なし。

ボディ
{
  "parameters": {
    "copySpeed": "medium"
  }
}

属性

説明

copySpeed

string

(任意)コピー速度を指定します。

指定できる値を次に示します。

  • slower:低速
  • medium:中速
  • faster:高速

大文字と小文字は区別されません。

省略した場合、mediumが設定されたと見なされます。

レスポンスメッセージ

ボディ
ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。

属性

説明

affectedResources

クローンを実行したスナップショットグループのURL

Actionテンプレート

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/snapshot-groups/<オブジェクトID>/actions/clone

ステータスコード

この操作のリクエストに対するステータスコードの意味を次に示します。そのほかのステータスコードについては、HTTPステータスコードの説明を参照してください。

ステータスコード

メッセージ

説明

412

Precondition Failed

指定したスナップショットグループに対してクローンを実行できないことを示します。

コード例

Actionテンプレートを取得する場合

curl -v -H "Accept: application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/800000012345/snapshot-groups/snapshotGroup/actions/clone

Actionテンプレートを取得してリクエストを実行する場合

curl -v -H "Accept: application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" --data-binary @./InputParameters.json -X PUT https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/800000012345/snapshot-groups/snapshotGroup/actions/clone/invoke