リソース ID を指定して、インスタンス、ディスク、スナップショット、イメージ、セキュリティグループに対するタグをバインド解除することができます。
Action | String | はい | このインターフェイス名、値: RemoveTags。 |
RegionId | String | はい | ECS リソースが属するリージョンの ID。 詳細については、DescribeRegions を呼び出して最新のリージョンリストを取得してください。 |
ResourceId | String | はい | リソース ID。 たとえば、 ResourceType をインスタンスに設定した場合、ResourceId は InstanceId と解釈されます。
|
ResourceType | String | はい | タグをバインドするときのリソースのタイプを示します。オプションの値:
|
Tag.n.Key | String | いいえ | n は 1 ~ 5 です。DescribeTags を呼び出して、利用可能なタグを表示することができます。 |
Tag.n.Value | String | いいえ | タグ値を示します。タグ値は、長さが最大 128 文字で、n は 1 ~ 5 です。このパラメーターが指定されていない場合、指定した Tag.n.Key のキーを持つタグが、指定のリソースからバインド解除されます。 |
レスポンスパラメータ
すべての一般的なレスポンスパラメータの詳細については、共通パラメータを参照してください。
例
リクエストの例
https://ecs.aliyuncs.com/?Action=RemoveTags
&ResourceId=s-946ntx4wr
&ResourceType=snapshot
&RegionId=cn-shenzhen
&Tag.1.Key=test
&Tag.1.Value=api
&<Common Request Parameter>
戻り値の例
XML
形式
<RemoveTagsResponse>
<RequestId>6A2C8AB5-E15D-478C-B56A-CF3DAF060028</RequestId>
</RemoveTagsResponse>
JSON
形式
{
"RequestId": "6A2C8AB5-E15D-478C-B56A-CF3DAF060028"
}
エラーコード
このインタフェースに固有のエラーコードは次のとおりです。詳細については、API のエラー・センターを参照してください。
エラーコード | エラーメッセージ | HTTP ステータスコード | 意味 |
---|---|---|---|
InvalidTagCount | The specified tags are beyond the permitted range. | 400 | このクエリー要求では、指定された ECS リソースから最大 5 つのタグを削除できます。 |
InvalidResourceId.NotSupported | The specified ResourceId does not support tagging. | 403 | 指定した ECS リソースからタグを削除することはできません。 |
InvalidResourceId.NotFound | The specified ResourceId is not found in our records. | 404 | 指定された ResourceId は存在しません。
|
InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | 404 | 指定された RegionId は存在しません。
|
InvalidResourceType.NotFound | The ResourceType provided does not exist in our records. | 404 | 指定された ResourceType は存在しません。
|