全部產品
Search

搜尋本產品

    Auto Scaling：如何保證等冪性

    文件中心

    Auto Scaling：如何保證等冪性

    更新時間：Jun 30, 2024

    您在調用Auto Scaling的API時，如果發生請求逾時或伺服器內部錯誤，用戶端可能會嘗試重發請求。您可以在請求中設定ClientToken參數避免多次重試帶來重複操作的問題。

    什麼是等冪性

    在數學計算或者電腦科學中，等冪性（idempotence）是指相同操作或資源在一次或多次請求中具有同樣效果的作用。等冪性是在分布式系統設計中具有十分重要的地位。

    保證等冪性

    通常情況下，用戶端只需要在500（InternalError）或503（ServiceUnavailable）錯誤，或者無法擷取響應結果時重試。使用阿里雲Auto Scaling的API，您可以從用戶端產生一個參數值不超過64個的ASCII字元，並將值賦予ClientToken，保證重試請求的等冪性。

    ClientToken詳解

    • ClientToken是一個由用戶端產生的唯一的、區分大小寫、不超過64個ASCII字元的字串。例如，ClientToken=123e4567-e89b-12d3-a456-42665544****。

    • 如果您提供了一個已經使用過的ClientToken，但其他請求參數有變化，則Auto Scaling會返回IdempotentParameterMismatch的錯誤碼。

      說明

      參數SignatureNonce、Timestamp和Signature在重試時是需要變化的。具體原因是Auto Scaling使用SignatureNonce防止重放攻擊，使用Timestamp標記每次請求時間。所以再次請求必須提供不同的SignatureNonce和Timestamp參數值，同時也會導致Signature值的變化。

    • 添加了ClientToken參數後：

      • 返回結果是200 HTTPCode時，重試後用戶端可以得到與上次相同的結果，但對您的服務端狀態沒有影響。

      • 返回結果是4xx HTTPCode時，如果錯誤資訊沒有表明try it later類似的資訊，重試不會成功。您需要根據錯誤資訊排查問題後再重試請求。

    等冪請求樣本

    以CreateScalingGroup建立一個伸縮組為例，如果您使用同一個ClientToken值，其他請求參數相同時，則服務端會返回相同的請求結果，只會產生一個ScalingGroupId。

    http(s)://ess.aliyuncs.com/?Action=CreateScalingGroup
&ScalingGroupName=scalinggroup****
&InstanceId=i-28wt4****
&RegionId=cn-qingdao
&MinSize=2
&MaxSize=20
&DefaultCooldown=300
.......
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<公用請求參數>

    API列表

    以下為部分包含了ClientToken參數的API，供您參考。具體哪些API支援ClientToken參數請以各API文檔為準，此處不一一列舉。