重試策略

C++

根據預設，作業支援下列 HTTP 錯誤代碼的重試作業，以及任何表示連線中斷或從未成功建立的通訊端錯誤。

• 408 Request Timeout
• 429 Too Many Requests
• 500 Internal Server Error
• 502 Bad Gateway
• 503 Service Unavailable
• 504 Gateway Timeout

C++ 程式庫中的所有指數輪詢和重試設定都可以設定。如果程式庫中實作的演算法無法滿足您的需求，您可以提供自訂程式碼來實作自己的策略。

根據預設，C++ 程式庫會重試所有作業，即使這些作業永遠不會是等冪作業，且重複成功時可能會刪除或建立多個資源，也會重試。如要僅重試等冪作業，請使用 google::cloud::storage::StrictIdempotencyPolicy 類別。

C#

C# 用戶端程式庫預設使用指數輪詢。

Go

根據預設，作業支援下列錯誤的重試作業：

• 連線錯誤：
  • io.ErrUnexpectedEOF：這可能是暫時性的網路問題所致。
  • url.Error 含有 connection refused：這可能是暫時性的網路問題所致。
  • 包含 connection reset by peer 的 url.Error： 這表示 Google Cloud 已重設連線。
  • net.ErrClosed：這表示 Google Cloud 已關閉連線。
• HTTP 程式碼：
  • 408 Request Timeout
  • 429 Too Many Requests
  • 500 Internal Server Error
  • 502 Bad Gateway
  • 503 Service Unavailable
  • 504 Gateway Timeout
• 實作 Temporary() 介面並提供 err.Temporary() == true 值的錯誤
• 使用 Go 1.13 錯誤包裝包裝的上述任一錯誤

Go 程式庫中的所有指數輪詢設定皆可設定。 根據預設，Go 中的作業會使用下列設定進行指數輪詢 (預設值取自 gax)：

一般來說，除非控制環境已取消、用戶端已關閉或收到非暫時性錯誤，否則系統會無限期重試。如要停止重試，請使用內容逾時或取消。使用 Writer 執行可續傳的上傳作業時，如果資料量夠大，需要多個要求，就會發生例外狀況。在此情境中，每個區塊預設會在 32 秒後逾時，並停止重試。您可以變更 Writer.ChunkRetryDeadline，調整預設逾時時間。

有部分 Go 作業是條件式等冪 (條件式安全重試)。只有在符合特定條件時，這些作業才會重試：

• GenerationMatch或Generation

  • 如果對呼叫套用了 GenerationMatch 前置條件，或已設定 ObjectHandle.Generation，則可安全地重試。

• MetagenerationMatch

  • 如果呼叫套用了 MetagenerationMatch 前置條件，即可安全地重試。

• Etag

  • 如果方法會在 JSON 要求主體中插入 etag，則可以安全地重試。僅在 HMACKeyHandle.Update 中使用，且必須已設定 HmacKeyMetadata.Etag。

RetryPolicy 預設為 RetryPolicy.RetryIdempotent。如要瞭解如何修改預設重試行為，請參閱「自訂重試」一文中的範例。

Java

根據預設，作業支援下列錯誤的重試作業：

• 連線錯誤：
  • Connection reset by peer：這表示 Google Cloud 已重設連線。
  • Unexpected connection closure：這表示 Google Cloud 已關閉連線。
• HTTP 程式碼：
  • 408 Request Timeout
  • 429 Too Many Requests
  • 500 Internal Server Error
  • 502 Bad Gateway
  • 503 Service Unavailable
  • 504 Gateway Timeout

Java 程式庫中的所有指數輪詢設定都可以設定。根據預設，透過 Java 執行的作業會使用下列指數輪詢設定：

如要進一步瞭解相關設定，請參閱 RetrySettings.Builder 和 HttpTransportOptions.Builder 的 Java 參考說明文件。

有一部分 Java 作業是條件式等冪 (條件式安全重試)。只有在包含特定引數時，這些作業才會重試：

• ifGenerationMatch或generation

  • 如果 ifGenerationMatch 或 generation 已做為方法選項傳遞，可以安全地重試。

• ifMetagenerationMatch

  • 如果 ifMetagenerationMatch 是以選項形式傳入，則可安全地重試。

StorageOptions.setStorageRetryStrategy 預設為 StorageRetryStrategy#getDefaultStorageRetryStrategy。如需修改預設重試行為的範例，請參閱「自訂重試」。

Node.js

根據預設，作業支援下列錯誤代碼的重試作業：

• 連線錯誤：
  • EAI_again：這是 DNS 查詢錯誤。詳情請參閱 getaddrinfo 說明文件。
  • Connection reset by peer：這表示 Google Cloud 已重設連線。
  • Unexpected connection closure：這表示 Google Cloud 已關閉連線。
• HTTP 程式碼：
  • 408 Request Timeout
  • 429 Too Many Requests
  • 500 Internal Server Error
  • 502 Bad Gateway
  • 503 Service Unavailable
  • 504 Gateway Timeout

Node.js 程式庫中的所有指數輪詢設定都可以設定。 預設情況下，透過 Node.js 執行的作業會使用下列指數輪詢設定：

有部分 Node.js 作業是條件式等冪 (條件式安全重試)。只有在這些作業包含特定引數時，才會重試：

• ifGenerationMatch或generation

  • 如果 ifGenerationMatch 或 generation 已做為方法選項傳遞，可以安全地重試。方法通常只接受這兩個參數的其中一個。

• ifMetagenerationMatch

  • 如果 ifMetagenerationMatch 是以選項形式傳入，則可安全地重試。

retryOptions.idempotencyStrategy 預設為 IdempotencyStrategy.RetryConditional。如要瞭解如何修改預設重試行為，請參閱「自訂重試」一文中的範例。

PHP

PHP 用戶端程式庫預設使用指數輪詢。

根據預設，作業支援下列錯誤代碼的重試作業：

• 連線錯誤：
  • connetion-refused：這可能是暫時性的網路問題所致。
  • connection-reset：這表示 Google Cloud 已重設連線。
• HTTP 程式碼：
  • 200：適用於部分下載案例
  • 408 Request Timeout
  • 429 Too Many Requests
  • 500 Internal Server Error
  • 502 Bad Gateway
  • 503 Service Unavailable
  • 504 Gateway Timeout

PHP 程式庫中的部分指數輪詢設定可供設定。根據預設，透過 PHP 執行的作業會使用下列指數輪詢設定：

有一部分 PHP 作業是條件式等冪 (條件式安全重試)。只有在這些作業包含特定引數時，才會重試：

• ifGenerationMatch或generation

  • 如果 ifGenerationMatch 或 generation 已做為方法選項傳遞，可以安全地重試。方法通常只接受這兩個參數的其中一個。

• ifMetagenerationMatch

  • 如果 ifMetagenerationMatch 是以選項形式傳入，則可安全地重試。

建立 StorageClient 時，系統預設會使用 StorageClient::RETRY_IDEMPOTENT 策略。如要瞭解如何修改預設重試行為，請參閱自訂重試一節的範例。

Python

根據預設，作業支援下列錯誤代碼的重試作業：

• 連線錯誤：
  • requests.exceptions.ConnectionError
  • requests.exceptions.ChunkedEncodingError (僅適用於擷取或傳送酬載資料至物件的作業，例如上傳和下載)
  • ConnectionError
  • http.client.ResponseNotReady
  • urllib3.exceptions.TimeoutError
• HTTP 程式碼：
  • 408 Request Timeout
  • 429 Too Many Requests
  • 500 Internal Server Error
  • 502 Bad Gateway
  • 503 Service Unavailable
  • 504 Gateway Timeout

透過 Python 執行的作業會使用下列指數輪詢預設設定：

除了一律為等冪的 Cloud Storage 作業外，Python 用戶端程式庫預設會自動重試 Objects: insert、Objects: delete 和 Objects: patch。

如果包含特定引數，部分 Python 作業會成為有條件的等冪作業 (可安全地重試)。只有在通過條件案例時，這些作業才會重試：

• DEFAULT_RETRY_IF_GENERATION_SPECIFIED

  • 如果 generation 或 if_generation_match 已做為引數傳遞至方法，則可安全地重試。方法通常只接受這兩個參數的其中一個。

• DEFAULT_RETRY_IF_METAGENERATION_SPECIFIED

  • 如果 if_metageneration_match 是以引數形式傳遞至方法，可以安全地重試。

• DEFAULT_RETRY_IF_ETAG_IN_JSON

  • 如果方法會在 JSON 要求主體中插入 etag，則可以安全地重試。如果是 HMACKeyMetadata.update()，這表示必須在 HMACKeyMetadata 物件本身設定 etag。如果是其他類別的 set_iam_policy() 方法，這表示必須在傳遞至方法的「policy」引數中設定 etag。

Ruby

根據預設，作業支援下列錯誤代碼的重試作業：

• 連線錯誤：
  • SocketError
  • HTTPClient::TimeoutError
  • Errno::ECONNREFUSED
  • HTTPClient::KeepAliveDisconnected
• HTTP 程式碼：
  • 408 Request Timeout
  • 429 Too Many Requests
  • 5xx Server Error

Ruby 用戶端程式庫中的所有指數輪詢設定均可設定。Ruby 用戶端程式庫預設會使用下列設定，透過指數輪詢執行作業：

如果包含特定引數，則有部分 Ruby 作業會成為有條件的等冪作業 (可安全地重試)：

• if_generation_match或generation

  • 如果 generation 或 if_generation_match 參數做為引數傳遞至方法，可以安全地重試。方法通常只接受這兩個參數之一。

• if_metageneration_match

  • 如果 if_metageneration_match 參數以選項形式傳入，可以安全地重試。

根據預設，系統會重試所有等冪作業，且只有在條件案例通過時，才會重試有條件的等冪作業。系統不會重試非等冪運算。如要瞭解如何修改預設重試行為，請參閱「自訂重試」一節的範例。

C++

如要自訂重試行為，請在初始化 google::cloud::storage::Client 物件時，為下列選項提供值：

• google::cloud::storage::RetryPolicyOption：這個程式庫提供 google::cloud::storage::LimitedErrorCountRetryPolicy 和 google::cloud::storage::LimitedTimeRetryPolicy 類別。您可以提供自己的類別，但必須實作 google::cloud::RetryPolicy 介面。

• google::cloud::storage::BackoffPolicyOption：這個程式庫提供 google::cloud::storage::ExponentialBackoffPolicy 類別。您可以提供自己的類別，但必須實作 google::cloud::storage::BackoffPolicy 介面。

• google::cloud::storage::IdempotencyPolicyOption：這個程式庫提供 google::cloud::storage::StrictIdempotencyPolicy 和 google::cloud::storage::AlwaysRetryIdempotencyPolicy 類別。您可以提供自己的類別，但必須實作 google::cloud::storage::IdempotencyPolicy 介面。

詳情請參閱 C++ 用戶端程式庫參考說明文件。

C#

您無法自訂 C# 用戶端程式庫使用的預設重試策略。

Go

初始化儲存空間用戶端時，系統會設定預設的重試設定。除非覆寫，否則設定中的選項會設為預設值。使用者可以為單一程式庫呼叫設定非預設的重試行為 (使用 BucketHandle.Retryer 和 ObjectHandle.Retryer)，也可以為用戶端發出的所有呼叫設定重試行為 (使用 Client.SetRetry)。如要修改重試行為，請將相關的 RetryOptions 傳遞至下列其中一種方法。

請參閱下列程式碼範例，瞭解如何自訂重試行為。

Java

初始化 Storage 時，系統也會初始化 RetrySettings 的執行個體。除非遭到覆寫，否則 RetrySettings 中的選項會設為預設值。如要修改預設的自動重試行為，請將自訂的 StorageRetryStrategy 傳遞至用於建構 Storage 執行個體的 StorageOptions。如要修改任何其他純量參數，請將自訂 RetrySettings 傳遞至用於建構 Storage 例項的 StorageOptions。

請參閱以下範例，瞭解如何自訂重試行為：

Node.js

初始化 Cloud Storage 時，系統也會初始化 retryOptions 設定檔。除非覆寫，否則設定中的選項會設為預設值。如要修改預設的重試行為，請在初始化時，將自訂重試設定 retryOptions 傳遞至儲存空間建構函式。Node.js 用戶端程式庫可自動使用輪詢策略，重試具有 autoRetry 參數的要求。

請參閱下列程式碼範例，瞭解如何自訂重試行為。

PHP

初始化儲存空間用戶端時，系統會設定預設的重試設定。除非覆寫，否則設定中的選項會設為預設值。使用者可以透過陣列傳遞覆寫選項，為用戶端或單一作業呼叫設定非預設的重試行為。

請參閱下列程式碼範例，瞭解如何自訂重試行為。

Python

如要修改預設重試行為，請呼叫 with_BEHAVIOR 方法，建立 google.cloud.storage.retry.DEFAULT_RETRY 物件的副本。如果您加入 DEFAULT_RETRY 參數，Python 用戶端程式庫會自動使用輪詢策略重試要求。

請注意，系統不支援對物件擷取或傳送酬載資料的作業 (例如上傳和下載)。with_predicate建議逐一修改屬性。詳情請參閱 google-api-core Retry 參考資料。

如要設定自己的條件式重試，請建立 ConditionalRetryPolicy 物件，並使用 DEFAULT_RETRY_IF_GENERATION_SPECIFIED、DEFAULT_RETRY_IF_METAGENERATION_SPECIFIED 或 DEFAULT_RETRY_IF_ETAG_IN_JSON 包裝自訂 Retry 物件。

請參閱下列程式碼範例，瞭解如何自訂重試行為。

Ruby

初始化儲存空間用戶端時，所有重試設定都會設為上表顯示的值。如要修改預設重試行為，請在初始化儲存空間用戶端時傳遞重試設定。

如要覆寫特定作業的重試次數，請在作業的 options 參數中傳遞 retries。