刪除 Apigee 組織

本頁面適用於 Apigee，但不適用於 Apigee Hybrid。

查看 Apigee Edge 說明文件。

本頁說明如何從 Google Cloud 雲端專案中完整刪除 Apigee 組織，包括釋出 Apigee 未自行清理的網路資源所需的後續步驟。刪除後需要執行的清理作業，取決於機構的佈建方式：

  • 佈建時已啟用虛擬私有雲對接的組織，在虛擬私有雲和 Apigee 租戶網路之間，也會有 Service Networking 虛擬私有雲對接連線。刪除組織後，該連線以及任何相關聯的保留對接範圍和虛擬私有雲網路仍會保留，如果不再需要，則必須另外清除。請參閱「後續步驟：已佈建虛擬私有雲對接的組織」。

  • 佈建時停用虛擬私有雲對接的組織會使用 Private Service Connect，而非 Service Networking 連線，因此沒有要移除的供應商對接。您仍須刪除佈建組織時建立的北向 Private Service Connect 負載平衡器 (轉送規則、目標 HTTPS Proxy、網址對應、後端服務、PSC 網路端點群組、SSL 憑證和預留 IP 位址)，否則轉送規則和預留 IP 位址會繼續產生費用。請參閱「後續步驟：佈建未啟用虛擬私有雲對等互連的組織」。

「事前準備」一節說明如何判斷貴機構屬於哪個類別。

事前準備

必要 IAM 權限

  • 在 Apigee 組織 (通常為 APIGEE_PROJECT_ID) 上：apigee.organizations.delete。roles/apigee.admin 角色包含這項權限，根據 Apigee 角色指南，這是唯一可以建立、刪除或更新組織的角色。

  • 此外，如果貴組織已佈建並啟用虛擬私有雲對接，且您打算按照「後續步驟：已佈建虛擬私有雲對接的組織」一節所述，清除 Service Networking 連線、虛擬私有雲對接範圍或虛擬私有雲網路，則必須在擁有對接虛擬私有雲網路的專案 (即網路專案，在共用虛擬私有雲設定中可能與 Apigee 專案不同) 中，啟用 servicenetworking.services.deleteConnection、compute.globalAddresses.delete 和 compute.networks.delete。

請先刪除依附資源

刪除組織前，請先刪除 Apigee 要求您移除的資源：

備份要保留的資料

備份日後可能需要的組織範圍資料或資源。保留期限過後，儲存在組織中的資料就無法復原。

判斷貴組織是否使用虛擬私有雲對接

刪除組織後，您需要執行的後續清理作業，取決於組織是否已啟用虛擬私有雲對等互連。刪除前，請先使用 organizations.get API 讀取組織設定：

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

這個呼叫和本頁中的所有其他 Apigee REST 呼叫，都會指定全域 apigee.googleapis.com 端點。如果貴組織位於資料落地區域，請在每個範例中替換對應的區域端點。

在回應中尋找 disableVpcPeering 欄位：

  • 如果回應包含 "disableVpcPeering": true，則表示組織已佈建，但未啟用虛擬私有雲對等互連。刪除組織後，請按照「後續步驟：佈建未啟用虛擬私有雲對接的組織」一節的指示操作。

  • 如果欄位為 false 或不存在，則表示組織已透過虛擬私有雲對等互連佈建。請記下同一回應中的下列兩個額外值，在清理時會用到：

    • authorizedNetwork 欄位：用於識別與 Apigee 對接的虛擬私有雲網路。這類廣告會以下列兩種形式之一呈現：
      • 完整資源路徑 projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME，其中編碼了網路專案和網路名稱。如果網路位於與 Apigee 組織不同的專案，則會使用這個表單，最常見的情況是在Shared VPC設定中，網路位於主專案。
      • 只有網路名稱 (例如 apigee-network)。如果只有名稱，則網路與 Apigee 組織位於同一個 Google Cloud 雲端專案，請將該專案 (APIGEE_PROJECT_ID) 視為 NETWORK_PROJECT_ID，以便執行清理步驟。
      請注意，authorizedNetwork 僅適用於已建立虛擬私有雲對接的組織。
    • 您原本為虛擬私有雲對接範圍保留的全域位址名稱 (例如 apigee-range)。您在首次佈建組織時保留了這個位址。

    刪除組織後，請按照「後續步驟：透過虛擬私有雲對接佈建的組織」一節操作。

刪除 Apigee 組織

呼叫 organizations.delete API 刪除組織。呼叫會傳回長時間執行的作業，並針對評估機構立即執行刪除作業；針對付費機構 (訂閱或即付即用)，則會執行受保留期限限制的虛刪除作業。

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

如要為付費組織使用最短 (24 小時) 保留期限，請附加 retention 查詢參數：

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION?retention=MINIMUM"

回應包含長時間執行的作業。您可以使用 organizations.operations.get 輪詢。

後續追蹤：未透過虛擬私有雲對接佈建的組織

如果組織的 disableVpcPeering 欄位為 true，刪除組織不會釋出任何 Service Networking 資源，因為未佈建虛擬私有雲對接的組織從未建立 Service Networking 連線，也沒有要移除的供應商對接。

您仍須刪除在佈建組織時，於自有專案中建立的北向 Private Service Connect 負載平衡器。這些資源並非 Apigee 所有，organizations.delete 也不會發布任何這類資源。請按照依附關係的反向順序刪除：

  1. 轉送規則
  2. 目標 HTTPS Proxy
  3. 網址對應
  4. 後端服務
  5. PSC 網路端點群組
  6. SSL 憑證
  7. 預留 IP 位址

完成北向清理作業後，請前往「保留期和重新佈建」。

後續追蹤：已佈建虛擬私有雲對接的組織

刪除 Apigee 組織不會釋出您在佈建組織時建立的 Service Networking 虛擬私有雲對接連線。連線會保留在虛擬私有雲網路中，以及保留的對接範圍和您專用於對接的任何虛擬私有雲網路。如果不再需要這些資源，請按照設定私人服務存取權和Service Networking 的標準程序完成清理作業。本節其餘部分僅提供 Apigee 拆除作業專用的值和警告。

收集所需的值

下列清理步驟會重複使用相同的幾個值，插入連結的 Service Networking 和虛擬私有雲指南中的程序。請先決定各個值，然後將其設為殼層變數，以便逐字複製連結的指令：

  • NETWORK_PROJECT_ID：擁有對接虛擬私有雲網路的專案。這不一定與 Apigee 服務專案相同：在Shared VPC設定中，網路位於主專案中。請根據您在「判斷貴組織是否使用虛擬私有雲對接」中記錄的 authorizedNetwork 值，衍生出這個值：

    • 如果 authorizedNetwork 是完整資源路徑 projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME，請從該路徑擷取 NETWORK_PROJECT_ID。
    • 如果 authorizedNetwork 只是網路名稱 (例如 apigee-network)，則網路與 Apigee 組織位於相同專案，請使用 Apigee 專案 (APIGEE_PROJECT_ID)。

  • NETWORK_NAME：虛擬私有雲網路名稱 (例如 apigee-network)。請從 authorizedNetwork 的完整路徑中擷取，或在 authorizedNetwork 僅為名稱時使用裸值。

  • APIGEE_RANGE_NAME：為虛擬私有雲對等互連範圍分配的全域位址名稱 (例如 apigee-range)，在佈建組織時建立。您可以在 gcloud services vpc-peerings list 傳回的 reservedPeeringRanges 清單中，查看附加至對接的保留範圍。

  • NETWORK_PROJECT_NUMBER：NETWORK_PROJECT_ID 的數值專案編號。Service Networking REST API 需要 consumerNetwork 欄位中的專案編號 (而非專案 ID)：

    gcloud projects describe NETWORK_PROJECT_ID \
  --format="value(projectNumber)"

只要連結的程序要求提供網路、網路專案或用戶網路，請替換這些值。

Apigee 拆除作業的相關警告

完成清理

請按照連結中的程序操作，並替換「收集所需的值」中的變數：

  • 刪除 Service Networking 連線。請按照刪除私人連線一文中的步驟操作。由於您已按照「刪除 Apigee 組織」一節的說明刪除 Apigee 組織，因此評估組織已符合移除服務執行個體的指南必要條件，並會立即刪除。如果是付費組織，刪除作業屬於虛刪除，只有在保留期限過後，連線刪除作業才會成功。請參閱「保留期限和重新佈建」，或使用 ?retention=MINIMUM 刪除組織，將期限縮短為 24 小時。當程序要求提供網路和網路專案時，請使用 NETWORK_NAME 和 NETWORK_PROJECT_ID；當基礎 services.connections.deleteConnection REST 呼叫要求提供 consumerNetwork 時，請使用 projects/NETWORK_PROJECT_NUMBER/global/networks/NETWORK_NAME。

  • (選用) 釋出保留的對接範圍。按照刪除已分配的 IP 位址範圍一文中的說明操作，並使用 APIGEE_RANGE_NAME 和 NETWORK_PROJECT_ID。預留範圍是客戶擁有的資源，在 Apigee 組織和 Service Networking 連線刪除後仍會保留；保留該範圍不會中斷任何 Google Cloud 服務。

  • (選用) 刪除虛擬私有雲網路。如果您透過這個網路中的代管執行個體群組或內部負載平衡器轉送北向流量，請先刪除這些資源，否則網路刪除作業會失敗，並顯示依附資源錯誤：轉送規則、目標 Proxy、網址對應、後端服務、代管執行個體群組、執行個體範本、健康狀態檢查、防火牆規則和保留位址。接著，請按照虛擬私有雲網路指南中的「刪除網路」一節操作，並使用 NETWORK_NAME 和 NETWORK_PROJECT_ID。

保留期和重新佈建

如 organizations.delete 參考資料所述：

  • Apigee 會立即刪除評估組織。
  • Apigee 會虛刪除付費組織 (訂閱或即付即用)，預設保留期限為 7 天。在保留期間內，您可以向 Apigee 提交支援單來還原組織。在刪除要求中傳遞 ?retention=MINIMUM，可將時間範圍縮短為 24 小時。
  • 在保留期間內，您無法在同一個 Google Cloud 專案中重新建立 Apigee 組織。

後續步驟

Apigee 參考資料：

Service Networking 和私人服務存取權參考資料：