イメージコピーのタスクをキャンセルします。
説明
本インターフェイスを呼び出す際は次の点に留意してください。
- タスクキャンセル後、ターゲットリージョンに作成されたコピー先のイメージは削除されます。ソースイメージは変更されません。
- イメージコピーの処理の完了後は、CancelCopyImage の操作は実行されません。エラーが表示されます。
デバッグ
API Explorer でデバッグを実行できます。 API Explorer で各種操作を行い API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成などができます。
リクエストパラメーター
名称 | タイプ | 必須 | 例 | 説明 |
---|---|---|---|---|
ImageId | String | Yes | m-imageid1 |
コピーされるイメージの ID 。 |
RegionId | String | Yes | cn-hangzhou |
インスタンスが属するリージョンの ID。 DescribeRegions を呼び出すと、Alibaba Cloud の最新リージョンが表示されます。 |
Action | String | No | CancelCopyImage |
実行する操作です。 値を CancelCopyImage に設定します。 |
レスポンスのパラメーター
名称 | タイプ | 例 | 説明 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
リクエストの ID。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=CancelCopyImage
&ImageId=m-imageid1
&RegionId=cn-hangzhou
&<Common request parameters>
通常のレスポンスの例
XML
形式
<CancelCopyImageResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
</CancelCopyImageResponse>
JSON
形式
{
"RequestId":"C8B26B44-0189-443E-9816-D951F59623A9"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
404 | InvalidRegionId.NotFound | 指定された RegionId は存在しません。 | 指定されたトレイルがが存在しない場合に表示されるエラーメッセージ。 該当のリージョンでサービスが利用可能か確認してください。 |
404 | InvalidImageId.NotFound | 指定された ImageId は存在しません。 | 指定されたイメージがこのアカウントに存在しない場合に表示されるエラーメッセージ。 イメージ ID が正しいか確認してください。 |
400 | IncorrectImageStatus | イメージのコピーが完了しました。 | 指定されたイメージのコピーが完了しており、コピータスクをキャンセルできない場合に表示されるエラーメッセージ。 |
400 | InvalidDescription.Malformed | 指定された説明の形式が正しくありません。 | 指定された説明が無効な場合に表示されるエラーメッセージ。 説明は、長さが 2 ~ 256 文字である必要があります。文頭に http:// または https:// を含めることはできません。 |
400 | IncorrectImageStatus | 指定されたスナップショットはコピーされていません。 | 指定されたスナップショットがコピーされていない場合に表示されるエラーメッセージ。 |
400 | IncorrectImageStatus | 指定されたイメージはコピーされていません。 | 指定されたスナップショットがコピーされていない場合に表示されるエラーメッセージ。 |
400 | IncorrectImageStatus | イメージのコピーが完了しています。 | 指定されたイメージのコピーが完了しており、コピータスクをキャンセルできない場合に表示されるエラーメッセージ。 |
400 | IncorrectImageStatus | イメージのコピーに失敗しました。 | 指定されたイメージのコピーに失敗した場合に表示されるエラーメッセージ。 |
400 | CancelNotSupported | 指定されたイメージのコピーはキャンセルできません。 | 指定したコピータスクをキャンセルできない場合に表示されるエラーメッセージ。 |