TagResources
更新時間:
調(diào)用API TagResources為指定的彈性伸縮資源列表統(tǒng)一創(chuàng)建并綁定標簽,可以幫助您更好地管理和分類資源,通過標簽了解資源使用情況,提高資源利用率。
接口說明
-
伸縮組最多支持綁定20個標簽。
說明 綁定標簽前,阿里云會校驗資源已有標簽數(shù)量。超過限制值時返回報錯信息。 - 如果
Tag.N.Propagate
參數(shù)設(shè)置為true
時,伸縮組設(shè)置的標簽只會同步傳播到伸縮組中即將新創(chuàng)建的實例上,而不會傳播到已經(jīng)在伸縮組中運行的實例上。 - 如果伸縮配置設(shè)置了標簽,且將伸縮組設(shè)置的標簽進行傳播,則即將新創(chuàng)建的實例標簽預(yù)期如下:
- 包含伸縮配置與伸縮組設(shè)置傳播的所有標簽。
- 如果伸縮配置設(shè)置的標簽與伸縮組傳播的標簽具有相同的標簽鍵,則伸縮組傳播的標簽會被伸縮配置設(shè)置的標簽覆蓋。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數(shù)
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | TagResources | 系統(tǒng)規(guī)定參數(shù)。取值:TagResources。 |
RegionId | String | 是 | cn-hangzhou | 資源所屬的地域ID。您可以調(diào)用DescribeRegions查看最新的阿里云地域列表。 |
ResourceType | String | 是 | scalinggroup | 資源類型定義,目前僅支持伸縮組。取值:scalinggroup。 |
ResourceId.N | String | 否 | asg-2zej7nf7hea77k5a**** | 資源ID。N的取值范圍:1~50。 |
Tag.N.Key | String | 否 | TestKey | 資源的標簽鍵。N的取值范圍:1~20。 一旦輸入該值,則不允許為空字符串。最多支持128個字符,不能以 |
Tag.N.Value | String | 否 | TestValue | 資源的標簽值。N的取值范圍:1~20。 輸入該值時,可以為空字符串。最多支持128個字符,不能包含 |
Tag.N.Propagate | Boolean | 否 | false | 標識該標簽是否為可傳播標簽,取值范圍:
默認值:false。 |
返回數(shù)據(jù)
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 74C4E313-8570-479F-8791-DC25360D**** | 請求ID。 |
示例
請求示例
http(s)://ess.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=scalinggroup
&ResourceId=["asg-2zej7nf7hea77k5a****"]
&Tag=[{"Key":"TestKey","Value":"TestValue","Propagate":false}]
&公共請求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<TagResourcesResponse>
<RequestId>74C4E313-8570-479F-8791-DC25360D****</RequestId>
</TagResourcesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "74C4E313-8570-479F-8791-DC25360D****"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
文檔內(nèi)容是否對您有幫助?