確保請求中的 StartSnapshot API等冪性 - Amazon EBS

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

確保請求中的 StartSnapshot API等冪性

不緊急性可確保API請求只完成一次。使用等冪請求,若成功完成原始請求,後續重試會傳回原始成功請求的結果,而且它們沒有其他效果。

StartSnapshot API 支援使用用戶端字符的等冪。用戶端字符是您提出API請求時指定的唯一字串。如果您在成功完成後,使用相同的用戶端字符和相同的請求參數重試API請求,則會傳回原始請求的結果。如果您使用相同的用戶端字符重試請求,但變更一或多個請求參數,則會傳回 ConflictException 錯誤。

如果您未指定自己的用戶端字符, AWS SDKs會自動為請求產生用戶端字符,以確保其具有等冪性。

用戶端字符可以是包含最多 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