BlobRequestOptions.RetryPolicy プロパティ

定義

名前空間:

Microsoft.Azure.Storage.Blob

アセンブリ:

Microsoft.Azure.Storage.Blob.dll

パッケージ:

Microsoft.Azure.Storage.Blob v11.2.3

要求の再試行ポリシーを取得または設定します。

public Microsoft.Azure.Storage.RetryPolicies.IRetryPolicy RetryPolicy { get; set; }

member this.RetryPolicy : Microsoft.Azure.Storage.RetryPolicies.IRetryPolicy with get, set

Public Property RetryPolicy As IRetryPolicy

プロパティ値

IRetryPolicy

IRetryPolicy 型のオブジェクト。

実装

RetryPolicy

例

// Create a Linear Retry Policy.
// This retry policy will instruct the Storage Client to retry the request in a linear fashion.
// This particular retry policy will retry the request every 20 seconds, up to a maximum of 4 retries.
BlobRequestOptions optionsWithRetryPolicy = new BlobRequestOptions() { RetryPolicy = new RetryPolicies.LinearRetry(TimeSpan.FromSeconds(20), 4) };

int byteCount = blob.DownloadToByteArray(destinationArray, index: 0, accessCondition: null, options: optionsWithRetryPolicy);

// This retry policy will never retry.
optionsWithRetryPolicy = new BlobRequestOptions() { RetryPolicy = new RetryPolicies.NoRetry() };
byteCount = blob.DownloadToByteArray(destinationArray, index: 0, accessCondition: null, options: optionsWithRetryPolicy);

注釈

再試行ポリシーは、失敗した要求を再試行するようにストレージ クライアントに指示します。 既定では、一部のエラーのみが再試行されます。 たとえば、接続エラーや調整エラーを再試行できます。 リソースが見つからない (404) か認証エラーは再試行されません。これは、再試行時に成功する可能性が高くないためです。 設定されていない場合、ストレージ クライアントは指数バックオフ再試行ポリシーを使用します。このポリシーでは、要求間の待機時間が指数関数的に長くなり、合計で約 30 秒になります。 ほとんどのシナリオでは、既定の再試行ポリシーをお勧めします。