11.23 Thin Imageペアに対してクローンを実行する
実行権限
ストレージ管理者(ローカルバックアップ管理)
リクエストライン
PUT <ベースURL>/v1/objects/storages/<ストレージデバイスID>/snapshots/<オブジェクトID>/actions/clone/invoke
このAPIはPOSTメソッドでも実行できます。
リクエストメッセージ
- オブジェクトID
-
Thin Imageペアの情報取得で取得したsnapshotIdの値を指定します。次に示す属性値を連結した形式でも指定できます。
<pvolLdevId>,<muNumber>
属性
型
説明
pvolLdevId
int
(必須)クローンを実行するThin ImageペアのP-VOLのLDEV番号
0以上の10進数で指定します。
muNumber
int
(必須)クローンを実行するThin ImageペアのP-VOLのMU番号
0~1023の値を指定します。
- クエリパラメータ
-
なし。
- ボディ
-
{ "parameters": { "copySpeed": "medium" } }
属性
型
説明
copySpeed
string
(任意)コピー速度を指定します。
指定できる値を次に示します。
- slower:低速
- medium:中速
- faster:高速
大文字と小文字は区別されません。
省略した場合、mediumが設定されたと見なされます。
レスポンスメッセージ
- ボディ
-
ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。
属性
説明
affectedResources
クローンを実行したThin ImageペアのURL
Actionテンプレート
GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/snapshots/<オブジェクト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/snapshots/100,3/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/snapshots/100,3/actions/clone/invoke