取消或刪除未來預留要求

本文說明如何取消或刪除未來的預訂要求。

在未來預留項目要求達到鎖定時間前，您可以執行下列任一操作，防止 Compute Engine 佈建所要求的資源：

  • 取消未來預留項目要求。這項功能有助於在建立新要求時，參考已取消的要求。不過，取消未來的預留要求後，您就無法在專案中，或要求共用的專案中，建立與取消要求屬性相符的新要求，除非您刪除取消的要求。詳情請參閱「建立限制」一節。

  • 刪除未來預留項目要求。如果您不再需要要求，這項功能就非常實用。刪除後，系統會永久刪除未來預留項目要求，並解除建立新要求的限制。

如果未來預留項目已完成，且預留期限已到期，您可以刪除該項目，解除建立新要求的限制。不過，刪除已兌換的未來預留項目不會刪除自動建立的預留項目。如要在預留期間結束後刪除自動建立的預留項目，請參閱「刪除預留項目」。

事前準備

  • 如果尚未設定驗證，請先完成設定。 驗證可確認您的身分，以便存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，可以選取下列任一選項，向 Compute Engine 進行驗證：

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. 安裝 Google Cloud CLI。 完成後，執行下列指令來初始化 Google Cloud CLI： 

      gcloud init

      若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

    2. Set a default region and zone.

    REST

    如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

      安裝 Google Cloud CLI。 完成後，執行下列指令來初始化 Google Cloud CLI： 

      gcloud init

      若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

    詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。

必要的角色

如要取得取消或刪除未來預留項目要求所需的權限，請要求管理員在專案中授予您「Compute Future Reservation Admin 」(roles/compute.futureReservationAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備取消或刪除未來預留要求所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要取消或刪除未來預留項目要求，您必須具備下列權限：

  • 如要取消未來預留項目： compute.futureReservations.cancel 在專案上
  • 如要刪除未來預留項目： compute.futureReservations.delete 在專案上

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

取消未來預留項目要求

只有在下列情況下，才能取消未來預訂要求：

  • 要求待審核或已遭拒。

  • 要求已獲准，但狀態尚未變更為 PROCURING。

取消未來的預訂要求後，你只能查看詳細資料或刪除要求。

如要取消未來的預訂要求，請選取下列其中一個選項：

gcloud

如要取消未來的預訂要求，請使用 gcloud compute future-reservations cancel 指令。

gcloud compute future-reservations cancel FUTURE_RESERVATION_NAME \
    --zone=ZONE

更改下列內容：

  • FUTURE_RESERVATION_NAME：現有未來預留項目要求的名稱。

  • ZONE：未來預訂要求所在的可用區。

REST

如要取消未來預留項目要求，請對 futureReservations.cancel 方法發出 POST 要求。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel

更改下列內容：

  • PROJECT_ID：未來預訂要求所在的專案 ID。

  • ZONE：未來預訂要求所在的可用區。

  • FUTURE_RESERVATION_NAME：未來預留項目要求的名稱。

刪除未來預留項目要求

只有在下列情況下，您才能刪除未來預留要求：

  • 要求尚未達到鎖定時間 (PROCURING)，且未處於待核准狀態。

  • 要求已完成，預訂期間也已結束。

如要刪除待核准的未來預留項目要求，請先取消要求，再刪除要求。

刪除已兌換的未來預留項目不會刪除自動建立的預留項目。如要在預留期間結束後刪除自動建立的預留項目，請參閱「刪除預留項目」。

如要同時刪除多個未來預留要求，請使用Google Cloud 控制台。如要刪除單一未來預留要求，請選取下列任一選項：

控制台

  1. 前往 Google Cloud 控制台的「Reservations」(預留項目) 頁面。

    前往「Reservations」(預留項目) 頁面

  2. 點選「Future reservations」(未來預留項目) 分頁標籤。

  3. 選取要刪除的每個未來預訂要求。

  4. 按一下 「刪除預訂」。

  5. 按一下「Delete」(刪除) 確認操作。

    刪除未來預留項目要求最多需要一分鐘。

gcloud

如要刪除未來預留要求，請使用 gcloud compute future-reservations delete 指令。

gcloud compute future-reservations delete FUTURE_RESERVATION_NAME \
    --zone=ZONE

更改下列內容：

  • FUTURE_RESERVATION_NAME：現有未來預留項目要求的名稱。

  • ZONE：未來預訂要求所在的可用區。

REST

如要刪除未來預留項目要求，請對 futureReservations.delete 方法發出 DELETE 要求。

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

更改下列內容：

  • PROJECT_ID：未來預訂要求所在的專案 ID。

  • ZONE：未來預訂要求所在的可用區。

  • FUTURE_RESERVATION_NAME：現有未來預留項目要求的名稱。

後續步驟