edit-icon download-icon

冪等性を確保する方法

最終更新日: May 05, 2018

もしリクエスト VPC のインスタンスを作成するためにCreateVpc API を呼び出すときにタイムアウトするか、内部サーバーエラーが発生し、クライアントが再送信を試みることがリクエスト 。これにより、意図したより多くのインスタンスが作成される可能性があります。

この状況は、ことを確認するために、 ClientTokenパラメータを指定することで回避することができますリクエスト冪等です。クライアントトークンは、クライアントによって生成されるユニークで大文字と小文字を区別する文字列であり、64 ASCII 文字を超えることはできません。

インスタンスを作成するために同じクライアントトークンを使用して API を呼び出すと、同じVpcIdを持つ同じ応答が返されます。したがって、インスタンスが 1 つしか作成されないことを保証するためにリクエストが再送信されたときに、同じクライアントトークンを提供することができます。

注意SignatureNonceTimeStamp、およびSignatureを含むパラメータの値は、 リクエストが再送信されるたびに同じにすることはできません。Alibaba Cloud は、API 呼び出しのセキュリティを保証するためにリクエスト署名します。

一般に、クライアントは、500(InternalError)または 503(ServiceUnAvailable)エラーが発生した場合、または応答を受信しなかった場合に再試行を行います。HTTP ステータスコード 200 が返されると、前回と同じ応答がサーバに何の影響も与えずに返されます。ただし、再試行でも HTTP ステータスコード 4xx のエラーを解決することはできません。

:他のパラメータが異なっていても、以前使用されていたクライアントトークンが提供されている場合、IdempotentParameterMismatchエラーが返されます。