1 つまたは複数のタグを ECS リソースに追加または上書きします。インスタンス、ディスク、スナップショット、イメージ、セキュリティグループなどの ECS リソースにタグを追加して、操作や管理を簡単にカスタマイズできます。

このインターフェイスを呼び出すときは、次の点を考慮してください。

  • 各 ECS リソースに最大 10 個のタグを追加できます。

  • タグのキー（ Tag.n.Key）と値（Tag.n.Value）は、キーと値が一致している必要があります。

  • 指定されたリソースに対してキー（ Tag.n.Key）が既に追加されている場合、以前の値（Tag.n.Value）は新しいもので上書きされます。

リクエストパラメータ

Action String はい 操作インターフェイス名、値: AddTags。
RegionId String はい ECS リソースが属するリージョンの ID。詳細については、DescribeRegions を呼び出して最新のリージョンリストを取得してください。
ResourceId String はい 作成されるタグのリソース ID を示します。
ResourceType String はい リソースタイプは次のように分類されます。
  • image
  • instance
  • snapshot
  • disk
  • securitygroup
すべての値は小文字にする必要があります。
Tag.n.Key String はい このパラメーターはタグキーを示し、n は 1 ～ 5 です。タグ名は、長さが最大 64 文字で、次の条件を満たしている必要があります。
  • Alibaba Cloud で始めることはできません。
  • http:// または https:// で始めることはできません。
  • 空の文字列にすることはできません。
Tag.n.Value String はい このパラメーターはタグ値を示し、n は 1 ～ 5 です。タグは、長さが最大 128 文字で、次の条件を満たしている必要があります。
  • Alibaba Cloud で始めることはできません。
  • http:// または https:// で始めることはできません。
  • 空の文字列にすることはできません。

リターンパラメータ

RequestId String リクエスト ID

例

リクエストの例

https://ecs.aliyuncs.com/?Action=AddTags
&ResourceId=s-946ntx4wr
&ResourceType=snapshot
&RegionId=cn-shenzhen
&Tag.1.Key=test
&Tag.1.Value=api
&<Public request parameter>

戻り値の例

XML 形式 

<AddTagsResponse>
    <RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</AddTagsResponse>

JSON 形式 

{
  "RequestId": "C46FF5A8-C5F0-4024-8262-B16B639225A0"
}

エラーコード

このインタフェースに固有のエラーコードは次のとおりです。詳細については、API のエラー・センターを参照してください。

エラーコード エラーメッセージ HTTP ステータスコード 説明
InvalidTag.Mismatch The specified Tag.n.Key and Tag.n.Value are not match. 400 タグのキー（Tag.n.Key）と値（Tag.n.Value）はキー値と一致する必要があります。
InvalidTagCount The specified tags are beyond the permitted range. 400 最大 5 つのタグを指定することができます。
InvalidTagKey.Malformed The specified Tag.n.Key is not valid. 400 指定されたTag.n.Keyは有効ではありません。
InvalidTagValue.Malformed The specified Tag.n.Value is not valid. 400 指定されたTag.n.Valueは有効ではありません。
OperationDenied.QuotaExceed The quota of tags on resource is beyond permitted range. 400 10 個のタグまでの各 ECS リソースに追加することができます。
InvalidResourceId.NotSupported The specified ResourceId does not support tagging. 403 指定された ECS リソースにタグを追加することはできません。
InvalidRegionId.NotFound The RegionId provided does not exist in our records. 404 指定されたRegionIdは存在しません。
InvalidResourceId.NotFound The specified ResourceId is not found in our records. 404 指定されたResourceId存在しません。
InvalidResourceType.NotFound The ResourceType provided does not exist in our records. 404 指定されたResourceType存在しません。