刪除私有雲

私有雲包含一或多個 vSphere 叢集。刪除私有雲會一併刪除整個私有雲。系統會刪除私有雲的所有元件，包括所有私有雲節點。

私有雲的元件包括：

  • 節點
  • 虛擬機器
  • 管理 VLAN 和子網路
  • 工作負載子網路
  • 儲存在私有雲的所有使用者資料
  • 所有外部存取規則

刪除私有雲的程序分為兩個階段：虛刪除和永久刪除。每個階段的流程如下：

  1. 虛刪除：私有雲會進入七天的虛刪除狀態。 在這個階段，系統會執行下列操作：
    • 系統會立即停止計費。
    • 與 NSX 區隔和工作負載的所有連線都會中斷。
    • 無法存取私有雲的使用者介面和 API。
    • 外部 IP 位址已停用。
    • 私有雲的設定和資料會保留，VM 也會繼續執行。
    • 您可以將私有雲還原至先前的狀態。
  2. 永久刪除：七天後，系統會永久刪除私有雲及其資源。如要在七天期限結束前，永久刪除處於軟刪除狀態的私有雲，可以使用 Privileged Access Manager，或聯絡支援團隊。

事前準備

如要保留任何資料，請將資料備份至其他私有雲、Google Cloud 儲存空間、地端儲存空間或其他儲存空間。

gcloud 和 API 需求

如要使用 gcloud 指令列工具或 API 管理 VMware Engine 資源，建議按照下列說明設定工具。

gcloud

  1. 設定預設專案 ID：

    gcloud config set project PROJECT_ID

  2. 設定預設地區和區域：

    gcloud config set compute/region REGION

    gcloud config set compute/zone ZONE

如要進一步瞭解 gcloud vmware 工具，請參閱 Cloud SDK 參考文件。

API

本文件集中的 API 範例會使用 cURL 指令列工具查詢 API。您必須在cURL要求中提供有效的存取權杖。取得有效存取權杖的方法有很多，以下步驟使用 gcloud 工具產生存取權杖：

  1. 登入 Google Cloud：

    gcloud auth login

  2. 產生存取權杖並匯出至 TOKEN：

    export TOKEN=`gcloud auth print-access-token`

  3. 確認 TOKEN 設定正確：

    echo $TOKEN

現在，您可以在對 API 發出的要求中使用授權權杖。例如：

curl -X GET -H "Authorization: Bearer \"$TOKEN\"" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

本說明文件中的 Python 程式碼範例會使用 VMware Engine 程式庫與 API 通訊。如要使用這種方法，必須先安裝程式庫，並設定應用程式預設憑證。

  1. 下載並安裝 Python 程式庫：

    pip install google-cloud-vmwareengine

  2. 在殼層中執行這些指令，設定 ADC 資訊：

    gcloud auth application-default login

    或者，使用服務帳戶金鑰檔案：

    export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"

如要進一步瞭解程式庫，請造訪參考頁面或查看 GitHub 上的程式碼範例。

刪除私有雲

如要立即使用工作負載網路 IP CIDR，請先關閉私有雲中的所有 VM，再開始刪除私有雲。

控制台

  1. 前往 Google Cloud 控制台的「Private clouds」頁面。

    前往 Private Cloud

  2. 按一下「選取專案」，然後選取要刪除私有雲的機構、資料夾或專案。

  3. 選取要刪除的私有雲。

  4. 在摘要頁面中，按一下「Delete this Private Cloud」(刪除這個 Private Cloud)。

  5. 在確認頁面中，系統會提示您驗證刪除動作的所有結果。請仔細閱讀這些資訊，並確認接受結果後再繼續刪除。準備好接受結果時，請選取所有核取方塊。

  6. 輸入刪除作業的等待時數 (1 到 8 小時)。在這段期間內，你可以點按「取消」來取消刪除。

  7. 如要確認您知道要刪除哪個私有雲，請輸入要刪除的私有雲名稱。

  8. 按一下「刪除」，將私有雲標示為待刪除。

刪除程序會在指定延遲時間 (以小時為單位) 過後開始執行，直到完成為止。

gcloud

如要使用 Google Cloud CLI 刪除私有雲，請使用 gcloud vmware private-clouds delete 指令。

  gcloud vmware private-clouds delete PRIVATE_CLOUD_ID \
     --location=ZONE [--delay-hours=HOURS]

更改下列內容：

  • PRIVATE_CLOUD_ID：這項要求的 Private Cloud ID
  • ZONE：這個 Private Cloud 的可用區
  • HOURS：延遲這項要求的小時數。預設為 3 小時，但你可以將時間設為 0 到 8 小時。如果將這個值設為 0，系統會立即開始處理刪除要求。

API

如要使用 VMware Engine API 刪除私有雲，請發出 DELETE 要求：

curl -X DELETE -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds?privateCloudId=PRIVATE_CLOUD_ID&mps;delayHours=HOUR

更改下列內容：

  • TOKEN：這項要求的授權權杖。
  • PROJECT_ID：這項要求所屬的專案
  • ZONE：Private Cloud 的可用區
  • PRIVATE_CLOUD_ID：私有雲的私有雲 ID
  • HOUR：延遲這項要求的時數，預設為 3 小時。你可以設定 0 到 8 之間的小時數。 如果將這個值設為 0，系統會立即啟動刪除要求。

Python

與使用 Google Cloud 控制台相比，使用 Google Cloud VMware Engine 程式庫刪除私有雲的程序只有一個步驟。呼叫私有雲刪除方法時，請務必小心謹慎。

from google.api_core import operation
from google.cloud import vmwareengine_v1


def delete_private_cloud_by_full_name(cloud_name: str) -> operation.Operation:
    """
    Deletes VMware Private Cloud.

    Args:
        cloud_name: identifier of the Private Cloud you want to delete.
            Expected format:
            projects/{project_name}/locations/{zone}/privateClouds/{cloud}

    Returns:
        An Operation object related to started private cloud deletion operation.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.DeletePrivateCloudRequest()
    request.force = True
    request.delay_hours = 3
    request.name = cloud_name
    return client.delete_private_cloud(request)


def delete_private_cloud(
    project_id: str, zone: str, cloud_name: str
) -> operation.Operation:
    """
    Deletes VMWare Private Cloud.

    Args:
        project_id: name of the project hosting the private cloud.
        zone: zone in which the private cloud is located in.
        cloud_name: name of the private cloud to be deleted.

    Returns:
        An Operation object related to started private cloud deletion operation.
    """
    return delete_private_cloud_by_full_name(
        f"projects/{project_id}/locations/{zone}/privateClouds/{cloud_name}"
    )

使用 Privileged Access Manager 加快刪除私有雲

您可以透過 Privileged Access Manager 取得短期特殊權限，永久刪除處於暫時刪除狀態的私有雲，不必等待七天的暫時刪除期限結束。如要進一步瞭解 Privileged Access Manager，請參閱「Privileged Access Manager 總覽」。

如要使用 Privileged Access Manager 加速刪除私有雲，您需要授權，其中定義了您可以要求哪些角色、哪些使用者可以要求這些角色，以及哪些使用者可以核准要求。詳情請參閱「在 Privileged Access Manager 中建立權利」。

權利必須授予包含權限的角色，才能刪除 Google Cloud VMware Engine 私有雲，例如 vmwareengine.privateClouds.delete。舉例來說，roles/vmwareengine.vmwareengineAdmin 角色就具備這項權限。

如要要求、核准及撤銷提供暫時存取權的授權，請參閱「要求及管理授權」。要求授權時，您必須提供理由，且授權必須由指定核准者核准。補助金的有效期限為指定時間長度。

取得具備必要權限的有效授權後，您可以使用控制台、Google Cloud CLI 或 API，按照「刪除私有雲」一文所述步驟，永久刪除已軟刪除的私有雲。如果私有雲已處於軟刪除狀態，刪除後就會永久刪除該私有雲及其資源。

取消刪除私有雲

您可以在軟刪除期間取消刪除私有雲。 請按照下列步驟操作。

控制台

  1. 前往 Google Cloud 控制台的「Private clouds」頁面。

前往 Private Cloud

  1. 選取已標示為要刪除的私有雲。
  2. 在摘要頁面中，按一下「取消刪除」，即可取消刪除私有雲。

gcloud

如要使用 Google Cloud CLI 取消刪除私有雲，請使用 gcloud vmware private-clouds undelete 指令：

  gcloud vmware private-clouds undelete PRIVATE_CLOUD_ID \
     --location=ZONE

更改下列內容：

  • PRIVATE_CLOUD_ID：這項要求的 Private Cloud ID
  • ZONE：這個 Private Cloud 的可用區

API

如要使用 VMware Engine API 取消刪除私有雲，請發出 POST 要求：

curl -X POST -H "Authorization: Bearer TOKEN"  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/privateClouds?privateCloudId=PRIVATE_CLOUD_ID:undelete

更改下列內容：

  • TOKEN：這項要求的授權權杖。
  • PROJECT_ID：這項要求的專案 ID
  • ZONE：Private Cloud 的可用區
  • PRIVATE_CLOUD_ID：這項要求的 Private Cloud ID

Python

from google.api_core import operation
from google.cloud import vmwareengine_v1


def cancel_private_cloud_deletion_by_full_name(cloud_name: str) -> operation.Operation:
    """
    Cancels in progress deletion of VMware Private Cloud.

    Args:
        cloud_name: identifier of the Private Cloud you want to cancel deletion for.
            Expected format:
            projects/{project_name}/locations/{zone}/privateClouds/{cloud}

    Returns:
        An Operation object related to canceling private cloud deletion operation.
    """
    client = vmwareengine_v1.VmwareEngineClient()
    request = vmwareengine_v1.UndeletePrivateCloudRequest()
    request.name = cloud_name
    return client.undelete_private_cloud(request)


def cancel_private_cloud_deletion(
    project_id: str, zone: str, cloud_name: str
) -> operation.Operation:
    """
    Cancels in progress deletion of VMWare Private Cloud.

    Args:
        project_id: name of the project hosting the private cloud.
        zone: zone in which the private cloud is located in.
        cloud_name: name of the private cloud to cancel deletion for.

    Returns:
        An Operation object related to canceling private cloud deletion operation.
    """
    return cancel_private_cloud_deletion_by_full_name(
        f"projects/{project_id}/locations/{zone}/privateClouds/{cloud_name}"
    )