指定した ECS リソースのリストにタグを作成してアタッチします。
制限事項
各 Alibaba Cloud アカウントには、使用可能なタグの割り当てがあります。 クォータを超過すると、エラーメッセージが返されます。 詳細は、「制限事項」をご参照ください。
デバッグ
オンラインデバッグについては、 API Explorer にアクセスしてください。 API Explorer を使用すると、API を簡単にデバッグし、SDK コード例を自動的に生成して、API をすばやく検索できます。
リクエストパラメーター
| パラメーター | データ型 | 必須/任意 | 値の例 | 説明 |
|---|---|---|---|---|
| Action | String | 任意 | TagResources |
この操作の名前。 値：TagResources。 |
| RegionId | String | 必須 | cn-hangzhou |
ECS リソースが属するリージョンの ID。 詳細については、 DescribeRegions を呼び出して最新のリージョンリストを取得してください。 |
| ResourceId.N | RepeatList | 必須 | i-bp1j6qtvdm8w0z1o0XXX |
ECS リソースの ID 。 N の値の範囲 : 1~50 。 |
| ResourceType | String | 必須 | ECS_INSTANCE("ALIYUN::ECS::INSTANCE") |
ECS リソースのタイプ。 オプション値：
|
| OwnerAccount | String | 任意 | ECSforCloud@Alibaba.com |
RAM ユーザーのログインアカウント。 |
| Tag.N.Key | String | 任意 | FinanceDept |
タグの値。 N の値の範囲 : 1~20 。 パラメーターは NULL 文字列にできません。 パラメーターの長さは 1~64 文字にする必要があり、aliyun、acs:、http://、または https:// で始めることはできません。 |
| Tag.N.Value | String | 任意 | FinanceJoshua |
タグの値。 N の値の範囲: 1~20 。 パラメーターは NULL 文字列にできます。 パラメーターの長さは 1~128 文字にする必要があり、aliyun、acs:、http://、または https:// で始めることはできません。 |
レスポンスパラメーター
| パラメーター | データ型 | 値の例 | 説明 |
|---|---|---|---|
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
リクエスト ID。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceId.1=i-bp1j6qtvdm8w0z1o0XXX
&ResourceType=instance
&Tag.1.Key=FinanceDept
&<Common Request Parameters> レスポンスの例
XML 形式
<TagResourcesResponse>
<RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</TagResourcesResponse> JSON 形式
{
"RequestId":"C46FF5A8-C5F0-4024-8262-B16B639225A0"
}エラー
| HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
|---|---|---|---|
| 404 | MissingParameter.TagOwnerUid | The parameter - TagOwnerUid should not be null | 指定されたタグ所有者の UID は存在しません。 |
| 404 | MissingParameter.TagOwnerBid | The parameter - TagOwnerBid should not be null | 指定されたタグ所有者の BID は存在しません。 |
| 404 | MissingParameter.Tags | The parameter - Tags should not be null | Tags パラメーターは存在しません。 |
| 404 | MissingParameter.RegionId | The parameter - RegionId should not be null | 指定されたリージョン ID は存在しません。 |
| 403 | PermissionDenied.TagOwnerUid | The specified operator not have permission to set TagOwnerUid value. | タグの所有者を設定する権限がありません。 |
| 403 | PermissionDenied.Scope | The specified operator not have permission to set Scope value. | スコープ値を変更する権限がありません。 |
| 400 | NumberExceed.ResourceIds | The ResourceIds parameter's number is exceed , Valid : 50 | リソース ID の数は 50 を超えることはできません。 |
| 400 | NumberExceed.Tags | The Tags parameter's number is exceed , Valid : 20 | タグの数は 20 を超えることはできません。 |
| 400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | タグキーの重複があります。 |
| 404 | InvalidResourceId.NotFound | The specified ResourceIds are not found in our records. | 指定されたリソースは存在しません。 |
| 404 | InvalidResourceType.NotFound | The ResourceType provided does not exist in our records. | 指定されたリソースタイプは存在しません。 |
| 400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | 指定されたタグ値は無効です。 |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定されたリージョン ID は存在しません。 このリージョンでこのプロダクトが利用可能かどうかを確認してください。 |
| 400 | Invalid.Scope | The specified scope is invalid. | 指定されたスコープは無効です。 |
| 403 | NoPermission.Tag | The operator is not permission for the tag. | このリソースタグを使用する権限がありません。 |
エラーコードのリストについては、 API エラーセンターをご覧ください。