リソース ID を指定して、インスタンス、ディスク、スナップショット、イメージ、セキュリティグループに対するタグをバインド解除することができます。

Action String はい このインターフェイス名、値: RemoveTags。
RegionId String はい ECS リソースが属するリージョンの ID。 詳細については、DescribeRegions を呼び出して最新のリージョンリストを取得してください。
ResourceId String はい リソース ID。 たとえば、 ResourceTypeをインスタンスに設定した場合、ResourceIdInstanceIdと解釈されます。
ResourceType String はい タグをバインドするときのリソースのタイプを示します。オプションの値:
  • image
  • instance
  • snapshot
  • disk
  • securitygroup
すべて小文字になります。
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 は存在しません。