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 | はい | リソースタイプは次のように分類されます。
|
Tag.n.Key | String | はい | このパラメーターはタグキーを示し、n は 1 ~ 5 です。タグ名は、長さが最大 64 文字で、次の条件を満たしている必要があります。
|
Tag.n.Value | String | はい | このパラメーターはタグ値を示し、n は 1 ~ 5 です。タグは、長さが最大 128 文字で、次の条件を満たしている必要があります。
|
リターンパラメータ
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 存在しません。
|