本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
冪等性 StartSnapshot API
冪等性確保API請求只完成一次。使用等冪請求,若成功完成原始請求,後續重試會傳回原始成功請求的結果,而且它們沒有其他效果。
StartSnapshotAPI支持使用客戶端令牌的冪等性。客戶端令牌是您在發出API請求時指定的唯一字符串。如果您在成功完成後重試具有相同用戶端 Token 和相同要求參數的要求,則會傳回原始要求的結果。API如果您使用相同的用戶端字符重試請求,但變更一或多個請求參數,則會傳回 ConflictException
錯誤。
如果您沒有指定自己的用戶端 Token,會 AWS SDKs自動為要求產生用戶端 Token,以確保它是冪等的。
客戶端令牌可以是包含最多 64 個ASCII字符的任何字符串。對於不同的請求,您不應該重複使用相同的用戶端字符。
使用您自己的客戶端令牌發出冪等 StartSnapshot 請求 API
指定 ClientToken
請求參數。
POST /snapshots HTTP/1.1 Host: ebs.us-east-2.amazonaws.com Accept-Encoding: identity User-Agent:
<User agent parameter>
X-Amz-Date: 20200618T040724Z Authorization:<Authentication parameter>
{ "VolumeSize": 8, "ParentSnapshot": snap-123EXAMPLE1234567, "ClientToken": "550e8400-e29b-41d4-a716-446655440000", "Timeout": 60 }
使用您自己的客戶端令牌發出冪等 StartSnapshot 請求 AWS CLI
指定 client-token
請求參數。
$
C:\>
aws ebs start-snapshot --region us-east-2 --volume-size 8 --parent-snapshot snap-123EXAMPLE1234567 --timeout 60 --client-token 550e8400-e29b-41d4-a716-446655440000