設定訊息儲存政策

如果您發布訊息至全球 Pub/Sub 端點，Pub/Sub 會自動將訊息儲存在最靠近的Cloud de Confiance by S3NS 區域。如要控管訊息的儲存和處理區域，可以為主題設定訊息儲存政策。

訊息儲存政策總覽

建立新主題或使用控制台、Google Cloud CLI 或 REST API 更新主題時，可以設定訊息儲存政策。

郵件儲存空間政策僅適用於郵件內容。這項政策不適用於其他資料，例如主題名稱、標籤或身分與存取權管理 (IAM) 設定。

當用戶端將訊息發布至 Pub/Sub 時，Pub/Sub 會儲存訊息。訊息儲存政策可確保 Pub/Sub 只會在您指定的一組Cloud de Confiance by S3NS 區域中儲存及處理訊息，無論發布或訂閱要求來自何處。如果政策允許發布作業使用多個區域，Pub/Sub 會將訊息儲存在允許的區域，該區域必須最靠近發布訊息進入 Cloud de Confiance 網路的位置。

指定訊息儲存政策時，您可以設定 enforceInTransit 為 True。這個標記會控管下列項目：

• 如果訊息儲存政策不允許在特定區域中儲存訊息，系統就會拒絕在該區域收到的發布、提取和串流提取要求，並傳回 FAILED_PRECONDITION 錯誤。

• 如果用戶端在允許的區域 Cloud de Confiance 內執行 (例如在 Compute Engine VM 中)，就可以使用全域端點。用戶端的要求會在允許的區域中於本機轉送。 用戶端也可以使用指定允許區域的位置端點或區域端點。

• 如果用戶端在不允許的區域內執行，或在區域外執行，則必須使用以允許區域清單中區域為目標的區域或區域端點。 Cloud de Confiance Cloud de Confiance

• 推送訂閱項目的傳送作業只會在允許的 Cloud 區域內處理。在某些情況下，這項限制可能會完全暫停推送訂閱項目的訊息傳送作業。如果推送訂閱項目因訊息儲存位置、允許的區域和匯出資源位置等因素，導致推送位置受到過度限制，就會進入這種狀態，並顯示在 Stackdriver 中。

新主題的訊息儲存政策

• 如果您在建立主題時未指定訊息儲存政策，系統會根據有效的資源位置限制機構政策，自動決定訊息儲存政策。如果沒有生效的機構政策，訊息儲存政策會允許所有地區。

• 同樣地，如果沒有指定訊息儲存政策，系統會根據有效的「強制執行 Pub/Sub 訊息的傳輸中區域」組織政策，判斷 enforceInTransit 旗標。如要進一步瞭解這項組織政策，請參閱「組織政策限制」。

• 建立主題時，如果指定訊息儲存政策，該政策只能包含有效資源位置限制機構政策允許的區域。如果沒有生效的機構政策，訊息儲存政策可以包含任何區域。

現有主題的訊息儲存政策

• 機構政策更新後，變更不會自動傳播至現有主題。因此，現有主題的訊息儲存政策可能會與最新的機構政策不同步。詳情請參閱「管理機構和主題政策之間的差異」。

• 更新主題的訊息儲存政策後，變更不會傳播至已發布的訊息。根據舊政策儲存的訊息不會移至新政策適用的位置。而是只會套用至更新後發布的訊息。

例外狀況

這項政策會指定允許的 Cloud de Confiance 區域名稱清單。因此，系統不支援下列項目：

• 排除清單
• 可用區或多區域位置

如果您發布的訊息含有排序鍵，且訊息儲存空間政策排除最靠近的區域，Pub/Sub 服務會傳回錯誤。

設定訊息儲存政策

設定主題訊息儲存政策的方法有兩種，包括：

• 使用機構政策設定訊息儲存政策。
• 建立主題時，請設定訊息儲存政策。

使用機構政策設定訊息儲存政策

建立主題時設定訊息儲存政策

gcloud pubsub topics create TOPIC_ID \
    --message-storage-policy-allowed-regions=REGION1,REGION2

 POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID
 Authorization: Bearer $(gcloud auth application-default print-access-token)
 Content-Type: application/json --data @response-body.json

{
  "name": "projects/PROJECT_ID/topics/TOPIC_ID",
  "messageStoragePolicy": {
    "allowedPersistenceRegions": ["REGION"],
    "enforceInTransit": true
  }
}

{
  "name": "projects/PROJECT_ID/topics/TOPIC_ID",
  "messageStoragePolicy": {
    "allowedPersistenceRegions": [
      "REGION"
    ],
    "enforceInTransit": true
  }
}

更新訊息儲存政策

gcloud pubsub topics update TOPIC_ID \
    --recompute-message-storage-policy

gcloud pubsub topics update TOPIC_ID \
    --message-storage-policy-allowed-regions=REGION1,REGION2

 PATCH https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID
 Authorization: Bearer $(gcloud auth application-default print-access-token)
 Content-Type: application/json --data @response-body.json

{
  "name": "projects/PROJECT_ID/topics/TOPIC_ID",
  "messageStoragePolicy": {
    "allowedPersistenceRegions": ["REGION"], // Replace with your required region
    "enforceInTransit": true
  }
}

{
  "name": "projects/PROJECT_ID/topics/TOPIC_ID",
  "messageStoragePolicy": {
    "allowedPersistenceRegions": [
      "REGION"
    ],
    "enforceInTransit": true
  }
}

管理機構和主題政策之間的差異

查看機構政策和主題政策的差異

gcloud pubsub topics describe TOPIC_ID

解決機構和主題政策之間的差異

監控與疑難排解

為協助您瞭解訊息資料的儲存位置，Pub/Sub 提供按各 Cloud de Confiance 區域細分的指標。

您可以運用這些指標：

• 瞭解資料在全球的分布情形。
• 根據這些資料，最佳化發布端和訂閱端部署位置。

郵件儲存空間指標

未確認的已儲存訊息數量：

subscription/num_unacked_messages_by_region

儲存的資料量：

subscription/unacked_bytes_by_region

最舊訊息存在時間：

subscription/oldest_unacked_message_age_by_region

主題和快照可使用類似指標。此外，您也可以選擇保留已確認的訊息以供重播，並查看相關指標。例如：

subscription/num_retained_acked_messages_by_region

效能和可用性影響

訊息儲存政策不會影響整體服務水準協議，但如果發布商或訂閱者在政策不允許的區域 Cloud de Confiance 或外部執行作業，就會出現可用性控管的取捨問題。如果使用者在訊息儲存空間政策允許的區域內執行發布商用戶端，服務延遲或可用性不會有任何變化。

如要瞭解這些取捨，請考慮發布要求的轉送方式。一般來說，Pub/Sub 會盡可能將訊息儲存在最接近要求來源的位置。一般來說，在Cloud de Confiance 內發出的要求會繫結至相同區域的 Pub/Sub 執行個體。如果發布者位於單一區域，即使在訊息儲存政策中新增更多區域，也不會提高可用性。從 Cloud de Confiance by S3NS外部發布訊息時，系統會多一層轉送機制，將要求傳送至附近的 Cloud de Confiance by S3NS 區域，該區域必須提供 Pub/Sub 服務。

請考慮採用只允許 us-central1 區域的郵件儲存政策。

1. 在 us-east1 中執行的發布端用戶端發出 Publish 要求。
2. 要求會路由至 us-east1 中的 Pub/Sub 伺服器。
3. 要求會轉送至訊息儲存政策允許且距離最近的區域 (即「us-central1」)，而不是在「us-east1」中儲存資料。
4. Pub/Sub 會將發布的訊息儲存在 us-central1 中，並從該位置將訊息轉送給訂閱端。

這項機制會影響要求延遲時間和整體系統可用性。由於要求會經過更多網路連結，因此完成時間較長，失敗的機率也相對較高。這也表示訂閱者可能會稍晚收到訊息，因為訊息必須先傳送至最近的允許區域，才能進行傳送。如果政策允許單一區域，但發布商應用程式在多個區域中執行，分散式應用程式的可用性就會受到限制，只能在允許的單一區域中運作。

後續步驟

• 如要瞭解如何使用全域或位置端點，請參閱 Pub/Sub API 總覽。