Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

搭配 Apigee Hybrid 使用資料落地

本主題說明如何設定新的 Apigee Hybrid 安裝作業，以符合資料落地規定。

關於資料落地

您可以將資料落地功能與新的 Apigee hybrid 安裝作業搭配使用。您無法將現有安裝作業轉換為使用資料落地。

資料落地功能可讓您指定 Apigee 資料的儲存地理位置 (區域)，滿足法規遵循和監管要求。透過資料落地，選取控制層位置即可確保所有客戶內容都儲存在指定區域。另請參閱「資料落地簡介」。

資料落地設定的基本步驟

如要設定 Apigee Hybrid 的資料落地功能，請按照下列基本步驟操作：

建立具備資料落地權的 Apigee 組織
使用 Apigee API 建立環境
啟用新資料管道
設定覆寫檔案

建立 Apigee 組織並設定資料落地

建立 Apigee 組織時，您可以選擇為組織啟用資料落地功能。建立具有資料落地功能的組織時，您必須指定兩個重要位置屬性：控制層位置和消費者資料區域。您也必須指定帳單類型。詳情請參閱「步驟 2：建立組織」。

控制層位置：您必須指定客戶核心內容 (例如 Proxy 繫結) 的儲存位置。如需清單，請參閱「可用的 Apigee API 控制層區域」。

控制層位置是指服務端點的位置，例如 us 代表美國。

下表列出 Apigee 控制層可用的託管管轄區和區域。

美洲

控制層託管管轄區說明	控制層託管管轄區名稱	詳細資料
美國	`us (multiple regions in United States)`	服務端點：`apigee.us.rep.googleapis.com` 注意：另請參閱「搭配使用 VPC Service Controls 與資料落地功能」。
加拿大	`ca (multiple regions in Canada)`	服務端點：`ca-apigee.googleapis.com`

消費者資料區域說明	消費者資料區域名稱	詳細資料
愛荷華州	`us-central1`	低二氧化碳排放
奧勒岡州	`us-west1`	低二氧化碳排放
洛杉磯	`us-west2`
鹽湖城	`us-west3`
拉斯維加斯	`us-west4`
南卡羅來納州	`us-east1`
北維吉尼亞州	`us-east4`
哥倫布	`us-east5`
達拉斯	`us-south1`
蒙特婁	`northamerica-northeast1`	低二氧化碳排放
多倫多	`northamerica-northeast2`	低二氧化碳排放

歐洲

控制層託管管轄區說明	控制層託管管轄區名稱	詳細資料
歐盟	`eu (multiple regions in the European Union)`	服務端點：`apigee.eu.rep.googleapis.com` 注意：另請參閱「搭配使用 VPC Service Controls 與資料落地」。
德國	`de (multiple regions in Germany)`	服務端點：`de-apigee.googleapis.com`
法國	`fr (single region europe-west9)`	服務端點：`fr-apigee.googleapis.com`
瑞士	`ch (single region europe-west6)`	服務端點：`ch-apigee.googleapis.com`

消費者資料區域說明	消費者資料區域名稱	詳細資料
比利時	`europe-west1`	低二氧化碳排放
法蘭克福	`europe-west3`
荷蘭	`europe-west4`
蘇黎世	`europe-west6`	低二氧化碳排放
米蘭	`europe-west8`
巴黎	`europe-west9`	低二氧化碳排放
杜林	`europe-west12`
華沙	`europe-central2`
馬德里	`europe-southwest1`	低二氧化碳排放
芬蘭	`europe-north1`	低二氧化碳排放

亞太地區

控制層託管管轄區說明	控制層託管管轄區名稱	詳細資料
澳洲	`au (multiple regions in Australia)`	服務端點：`au-apigee.googleapis.com`
印度	`in (multiple regions in India)`	服務端點：`apigee.in.rep.googleapis.com` 注意：另請參閱「搭配使用 VPC Service Controls 與資料落地」。
日本	`jp (multiple regions in Japan)`	服務端點：`jp-apigee.googleapis.com`

消費者資料區域說明	消費者資料區域名稱	詳細資料
雪梨	`australia-southeast1`
墨爾本	`australia-southeast2`
孟買	`asia-south1`
德里	`asia-south2`
東京	`asia-northeast1`
大阪	`asia-northeast2`

中東

控制層託管管轄區說明	控制層託管管轄區名稱	詳細資料
卡達	`qa (single region me-central1)`	服務端點：`qa-apigee.googleapis.com`
沙烏地阿拉伯	`sa (single region me-central2)`	服務端點：`sa-apigee.googleapis.com`
以色列	`il (single region me-west1)`	服務端點：`il-apigee.googleapis.com`

消費者資料區域說明	消費者資料區域名稱	詳細資料
杜哈	`me-central1`
達曼	`me-central2`
特拉維夫	`me-west1`

消費者資料區域：您必須指定 API 消費者資料的儲存區域。這必須是控制層區域的子區域。如需可用消費者資料區域的清單，請參閱「 Apigee 位置」。
帳單類型：只有付費訂閱機構才能使用資料落地功能。

使用 Apigee API 建立環境

如果使用 Apigee API 建立新環境，則必須指定控制層位置。請參閱「建立環境」。如果使用 UI 建立環境，則不需要任何特殊步驟。

設定控制層 `contractProvider`

將 contractProvider 設定屬性新增至每個覆寫檔案，並套用變更。Apigee Management API 的服務端點。例如：https://us-apigee.googleapis.com。

例如：

instanceID: "my_hybrid_example"
namespace: apigee

gcp:
  projectID: hybrid-example
  region: us-central1

k8sCluster:
  name: apigee-hybrid
  region: us-central1

org: hybrid-example

contractProvider: https://us-apigee.googleapis.com

請參閱「步驟 7：建立覆寫」

呼叫 Apigee API 時

在混合式安裝中，如要透過 curl 呼叫 Apigee API 來執行工作，您必須從控制層位置呼叫 API：

curl -H "Authorization: Bearer $TOKEN" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups"

例如：

curl -H "Authorization: Bearer $TOKEN" \
  "https://us-apigee.googleapis.com/v1/organizations/my-hybrid-org/envgroups"

網址許可清單

如果您使用轉送 Proxy 搭配資料落地功能，則必須在轉送 Proxy 中額外加入許可清單：

CONTROL_PLANE_LOCATION-apigee.googleapis.com
ANALYTICS_REGION-pubsub.googleapis.com
Apigee Hybrid 所需的網址，請參閱「允許 Hybrid 的 Google Cloud 網址」。