搭配 Apigee Hybrid 使用資料落地

總覽

Apigee 的資料落地功能可讓您指定 Apigee 資料的儲存地理位置 (區域),因此符合法規遵循和監管規定。選取控制平面位置後,資料落地功能會確保所有客戶內容都儲存在指定區域。

如要瞭解 Apigee 的資料落地功能,請參閱資料落地簡介

透過 Apigee Hybrid 確保資料落地

從混合式版本 1.12 開始,您可以在新的 Apigee Hybrid 安裝作業中使用資料落地功能。您無法轉換現有安裝項目,改為使用資料落地功能。

建立 Apigee 機構時

使用資料落地功能建立 Apigee 機構時,需要注意以下差異。請參閱步驟 2:建立機構

  • 控制層位置:您需要指定儲存客戶核心內容 (例如 Proxy 組合) 的位置。如需清單,請參閱「可用的 Apigee API 控制平面區域」。

    控制層位置是服務端點位置,例如美國的 us

    下表列出 Apigee 控制平面可用的主機代管管轄區和區域。

    美洲

    控制層代管管轄區說明 控制層主機代管管轄區名稱 詳細資料
    美國 us (multiple regions in United States) 服務端點:us-apigee.googleapis.com
    加拿大 ca (multiple regions in Canada) 服務端點:ca-apigee.googleapis.com
    消費者資料區域說明 消費者資料區域名稱 詳細資料
    愛荷華州 us-central1 節能綠葉圖示 二氧化碳排放量低2
    奧勒岡州 us-west1 節能綠葉圖示 二氧化碳排放量低2
    洛杉磯 us-west2
    鹽湖城 us-west3
    拉斯維加斯 us-west4
    南卡羅來納州 us-east1
    北維吉尼亞州 us-east4
    哥倫布 us-east5
    達拉斯 us-south1
    蒙特婁 northamerica-northeast1 節能綠葉圖示 二氧化碳排放量低2
    多倫多 northamerica-northeast2 節能綠葉圖示 二氧化碳排放量低

    歐洲

    控制層代管管轄區說明 控制層主機代管管轄區名稱 詳細資料
    歐盟 eu (multiple regions in the European Union) 服務端點:eu-apigee.googleapis.com
    德國 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 節能綠葉圖示 二氧化碳排放量低2
    法蘭克福 europe-west3
    荷蘭 europe-west4
    蘇黎世 europe-west6 節能綠葉圖示 二氧化碳排放量低2
    米蘭 europe-west8
    巴黎 europe-west9 節能綠葉圖示 二氧化碳排放量低2
    杜林 europe-west12
    華沙 europe-central2
    馬德里 europe-southwest1 節能綠葉圖示 二氧化碳排放量低2
    芬蘭 europe-north1 節能綠葉圖示 二氧化碳排放量低2

    亞太地區

    控制層代管管轄區說明 控制層主機代管管轄區名稱 詳細資料
    澳洲 au (multiple regions in Australia) 服務端點:au-apigee.googleapis.com
    印度 in (multiple regions in India) 服務端點:in-apigee.googleapis.com
    日本 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-central2
    特拉維夫市 me-west1
  • 消費者資料地區:您必須指定 API 消費者資料的儲存地區。這必須是控制層區域的子區域。如需可用的消費者資料地區清單,請參閱 Apigee 位置
  • 帳單類型:您只能在付費訂閱機構中使用資料所在地。

建立環境時

使用資料落地功能建立環境及安裝時,您必須在控制平面位置建立這些項目。請參閱步驟 3:建立環境群組

覆寫檔案調整項

使用資料落地功能時,您必須在每個覆寫檔案中加入 contractProvider 設定屬性,並將其指向控制平面位置的 API 路徑。例如:

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

請參閱「步驟 6:建立覆寫」。

呼叫 Apigee API 時

在混合式安裝中執行工作時,您需要對 Apigee API 進行 curl 呼叫,且必須從控制平面位置呼叫 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"