TagResources - Auto Scaling

調用API TagResources為指定的Auto Scaling資源清單統一建立並綁定標籤，可以協助您更好地管理和分類資源，通過標籤瞭解資源使用方式，提高資源使用率。

介面說明

伸縮組最多支援綁定20個標籤。
說明綁定標籤前，阿里雲會校正資源已有標籤數量。超過限制值時返回報錯資訊。
如果Tag.N.Propagate參數設定為true時，伸縮組設定的標籤只會同步傳播到伸縮組中即將新建立的執行個體上，而不會傳播到已經在伸縮組中啟動並執行執行個體上。
如果伸縮配置設定了標籤，且將伸縮組設定的標籤進行傳播，則即將新建立的執行個體標籤預期如下：
- 包含伸縮配置與伸縮組設定傳播的所有標籤。
- 如果伸縮配置設定的標籤與伸縮組傳播的標籤具有相同的標籤鍵，則伸縮組傳播的標籤會被伸縮配置設定的標籤覆蓋。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	TagResources	系統規定參數。取值：TagResources。
RegionId	String	是	cn-hangzhou	資源所屬的地區ID。您可以調用DescribeRegions查看最新的阿里雲地區列表。
ResourceType	String	是	scalinggroup	資源類型定義，目前僅支援伸縮組。取值：scalinggroup。
ResourceId.N	String	否	asg-2zej7nf7hea77k5a****	資源ID。N的取值範圍：1~50。
Tag.N.Key	String	否	TestKey	資源的標籤鍵。N的取值範圍：1~20。一旦輸入該值，則不允許為空白字串。最多支援128個字元，不能以`aliyun`和`acs:`開頭，不能包含`http://`或者`https://`。
Tag.N.Value	String	否	TestValue	資源的標籤值。N的取值範圍：1~20。輸入該值時，可以為空白字串。最多支援128個字元，不能包含`http://`或者`https://`。
Tag.N.Propagate	Boolean	否	false	標識該標籤是否為可傳播標籤，取值範圍： true：伸縮組上的標籤只會傳播到即將新建立的執行個體上，不會傳播到已經在伸縮組中啟動並執行執行個體上。 false：伸縮組上的標籤不會傳播到執行個體上。預設值：false。

返回資料

名稱	類型	樣本值	描述
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}]
&公用請求參數

正常返回樣本

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****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。