修改未來預留要求

主控台

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

   前往「預留項目」頁面

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

3. 在「名稱」欄中，按一下要修改的預訂要求名稱。

   系統會開啟所選未來預留要求詳細資料頁面。

4. 如要修改已核准未來預留項目的自動刪除選項、說明或名稱前置字元，請採取下列一或多項做法：

   • 如要修改自動刪除選項，請在「自動建立的預留項目自動刪除時間」列中，按一下 edit「編輯」，然後執行下列操作：

     1. 如要啟用、停用或修改自動刪除選項，請執行下列其中一項操作：

        • 如要啟用自動刪除選項，或變更 Compute Engine 自動刪除自動建立預留項目的時間，請按照下列步驟操作：

          1. 按一下「啟用自動刪除功能」切換鈕，將其設為開啟。

          2. 選用：如要變更「自動刪除時間」，請輸入新的日期和時間，系統會在該時間刪除自動建立的預留項目。日期和時間必須晚於預訂期間的結束時間。如果將這個欄位留空，自動建立的預留項目就會在預留期間結束後的兩小時內刪除。

        • 否則，請按一下「啟用自動刪除」切換鈕，將其設為關閉。

     2. 按一下「提交」。

   • 如要修改名稱前置字元，請在「前置字元」列中按一下「編輯」edit，然後執行下列操作：

     1. 在「前置字串」部分，輸入新的名稱前置字串。

     2. 按一下「提交」。

   • 如要修改說明，請在「說明」列中按一下「編輯」edit，然後執行下列操作：

     1. 在「說明」中，輸入新的說明。

     2. 按一下「提交」。

5. 按一下「編輯」edit或「編輯草稿」edit。

   系統會開啟頁面，供您編輯所選的未來預留要求。

6. 如要修改未來預留項目要求並提交給Trusted Cloud 審查，或儲存草稿要求，請執行下列一或多項操作：

   • 在「Prefix」(前置字串) 欄位中，輸入為這項未來預留項目要求佈建的自動建立預留項目，指定新的名稱前置字串。

   • 在「說明」中，輸入新的說明。

   • 修改未來預訂要求的開始時間或結束時間。請確認您做到了以下各項：

     • 開始時間不得晚於您提交未來預訂要求以供審查的日期和時間後一年。

     • 指定建議的開始時間值，確保預訂廣告空間進入鎖定時間前，您有足夠的時間。

     • 指定建議的最短預訂期限，提高 Trusted Cloud 在您提交審查要求後核准要求的可能性。

   • 在「Share type」(共用類型) 部分，選取「Local」(本機) 或「Shared」(共用)。如果選取「共用」，您可以新增或移除專案，與這些專案共用未來預留項目要求。最多可納入 100 個專案。

   • 在「Number of VM instances」(VM 執行個體數量) 欄位中，輸入要預留的 VM 總數。

   • 如果您要修改的預訂項目並非透過執行個體範本建立，則可以在「機器設定」部分變更下列項目：

     • 預留 VM 中使用的機器系列和機器類型。

     • 要附加至預留 VM 的 GPU。

     • 預留 VM 的本機 SSD 磁碟和磁碟介面類型。

   • 在「自動刪除系統自動產生的預留項目」部分，您可以啟用或停用未來預留項目要求的自動刪除功能。

7. 視您要修改的未來預訂要求採購狀態而定，請執行下列其中一項操作：

   • 如要修改未來預留項目要求草稿，請採取下列任一做法：

     • 如要儲存變更，請按一下「儲存草稿」。

     • 如要將草稿未來預留項目要求提交給Trusted Cloud 審查，請按一下「提交」。

   • 如無問題，請按一下「提交」。

提交修改要求後，系統會開啟「預留項目」頁面。 否則，系統會開啟未來預留項目的詳細資料頁面。

gcloud

如要修改未來的預留要求，請使用 gcloud beta compute future-reservations update 指令。

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

更改下列內容：

• FUTURE_RESERVATION_NAME：未來預訂要求的名稱。

• PLANNING_STATUS：未來預訂要求的規劃狀態。請指定下列其中一個值：

  • 如要修改草稿未來預留項目要求，但暫不提交審查：DRAFT。

  • 如要提交未來預留項目要求以供審查，請按一下 SUBMITTED。

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

替換下列一或多個預留位置，或移除這些預留位置和對應的旗標：

• 如要讓 Compute Engine 在預留項目期限結束後，自動刪除自動建立的預留項目，請採取下列任一做法：

  • 如要在預留時間結束後的兩小時內刪除預留項目 (預設)，請加入 --auto-delete-auto-created-reservations 旗標。

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    

  • 如要在預留項目期限結束後的特定時間刪除自動建立的預留項目，請加入 --auto-delete-auto-created-reservations 和 --auto-created-reservations-delete-time 旗標。

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
        --auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    

    請將 AUTO_CREATED_RESERVATIONS_DELETE_TIME 替換為採用 RFC 3339 時間戳記格式的日期和時間。

  • 如要在預留時間結束後的特定時間刪除自動建立的預留項目，請加入 --auto-delete-auto-created-reservations 和 --auto-created-reservations-duration 旗標。

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
        --auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    

    將 DURATION_BEFORE_DELETE 替換為天數、時數、分鐘數或秒數。舉例來說，指定 30m 代表 30 分鐘，指定 1d2h3m4s 則代表 1 天 2 小時 3 分鐘 4 秒。

• 如要禁止 Compute Engine 自動刪除為這項未來預留項目要求佈建的自動建立預留項目，請加入 --no-auto-delete-auto-created-reservations 標記。

  gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
      --no-auto-delete-auto-created-reservations \
      --planning-status=PLANNING_STATUS \
      --zone=ZONE
  

• 如要新增或移除附加至預留 N1 VM 的 GPU，或更新 GPU 類型，請執行下列其中一項操作：

  • 如要變更 GPU 數量和類型，請替換下列項目：

    • NUMBER_OF_ACCELERATORS：每個預留 VM 要新增的 GPU 數量。

    • ACCELERATOR_TYPE：要新增至預留 VM 的 GPU 類型。確認該區域提供 GPU，且未來預留項目要求位於該區域。否則修改要求會失敗。

  • 如要移除所有已連結至預留 N1 VM 的 GPU，請將 --accelerator 旗標替換為 --clear-accelerator 旗標。

• DESCRIPTION：日後預訂要求的新說明。

• 如要從預留 VM 新增或移除本機 SSD 磁碟，或編輯本機 SSD 磁碟介面類型，請執行下列其中一項操作：

  • 如要新增本機 SSD 磁碟或編輯磁碟介面類型，請將 INTERFACE 替換為下列其中一個值：

    • 如果開機磁碟映像檔具有最佳化 NVMe 驅動程式：nvme。

    • 否則請說出「scsi」。

    加入 --local-ssd 旗標，新增所需數量的本機 SSD 磁碟。最多可指定 24 個本機 SSD 磁碟。

  • 如要移除所有附加至預留 VM 的本機 SSD 磁碟，請移除所有 --local-ssd 旗標，並加入 --clear-local-ssd 旗標。

• MACHINE_TYPE：每個預留 VM 要使用的新機器類型。如果變更機器類型，請一併指定新機器系列的建議最短預訂期限。否則 Trusted Cloud 可能會拒絕您的修改要求。

• MINIMUM_CPU_PLATFORM：每個預留 VM 的新 CPU 平台基本要求。

• NAME_PREFIX：自動建立的預訂項目的新名稱前置字元，這些預訂項目是為您日後的預訂要求佈建。

• SHARE_SETTING：未來預訂要求的新分享類型。請指定下列其中一個值：

  • 單一專案的未來預留項目要求：local。為避免發生錯誤，您也必須將 --share-with 標記換成 --clear-share-settings 標記。

  • 共用未來預留項目要求：projects。為避免發生錯誤，您也必須在 --share-with 標記中指定至少一個消費者專案。

• CONSUMER_PROJECT_IDS：以逗號分隔的專案 ID 清單，您想與這些專案分享未來的預訂要求，例如 project-1,project-2。最多可指定 100 個消費者專案。

• START_TIME：預訂期間的新開始時間，格式為 RFC 3339 時間戳記。開始時間不得晚於您提交修改要求以供審查的日期和時間後一年。如要確保有足夠時間在未來預訂項目獲得核准後，以及進入鎖定時間前，選擇取消、刪除或修改預訂項目，請指定建議開始時間。

• END_TIME：預訂期間的新結束時間，格式為 RFC 3339 時間戳記。為提高Trusted Cloud 核准要求的可能性，請指定建議的最短預訂時間。如要指定時間長度而非結束時間，請將 --end-time 旗標換成 --duration=END_DURATION 旗標。將 END_DURATION 替換為預訂期間長度 (以秒為單位)。舉例來說，如要指定 1,209,600 秒 (14 天)，請輸入 1209600。

• TOTAL_COUNT：您希望在指定期間、VM 設定和專案中預留的 VM 總數。如要增加總數，請確認您有足夠的配額來預留資源。否則 Trusted Cloud 會拒絕你的修改要求。

舉例來說，假設您有名為 fr-03 的共用未來預留項目要求草稿，位於 us-central1-a 區域。假設您想修改這項共用未來預留項目要求，進行下列變更：

• 將要求轉換為單一專案的未來預留項目要求。

• 停用自動刪除選項。

• 預留 100 個 VM。

• 將未來預留要求提交至 Trusted Cloud 進行審查。

如要修改 fr-03，請執行下列指令：

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --share-setting=local \
    --total-count=100 \
    --zone=us-central1-a

REST

如要修改未來的預留項目要求，請對 beta.futureReservations.update 方法發出 PATCH 要求。

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

更改下列內容：

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

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

• FUTURE_RESERVATION_NAME：未來預訂要求的名稱。

• UPDATE_FIELDS：以逗號分隔的欄位清單，用於更新要求主體中的欄位。您必須將每個半形逗號編碼為 %2C。如果您在 updateMask 查詢參數和要求主體中指定欄位，系統就會更新該欄位的值。否則，如果您只在 updateMask 查詢參數中指定欄位，系統就會刪除該欄位。

  舉例來說，如要更新未來預訂要求中的 autoDeleteAutoCreatedReservations、totalCount 和 endTime 欄位，請指定下列項目：

  autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
  

• PLANNING_STATUS：未來預訂要求的規劃狀態。請指定下列其中一個值：

  • 如要修改草稿未來預留項目要求，但暫不提交審查：DRAFT。

  • 如要提交修改要求以供審查，請按照SUBMITTED操作。

替換下列一或多個預留位置，或移除預留位置和對應的欄位：

• AUTO_DELETE_AUTO_CREATED_RESERVATIONS：如果將這個欄位設為 true，Compute Engine 會自動刪除為您日後的預訂要求佈建的自動建立預訂。預設情況下，系統會在預訂時間結束後的兩小時內刪除資料。如要變更這項設定，請採取下列任一做法：

  • 如要在預留期間結束後的特定時間刪除自動建立的預留項目，請將 autoDeleteAutoCreatedReservations 設為 true，並指定 autoCreatedReservationsDeleteTime 欄位。

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDeleteTime": "DELETE_TIME",
      "name": "FUTURE_RESERVATION_NAME",
      "planningStatus": "PLANNING_STATUS"
    }
    

    將 DELETE_TIME 替換為 Compute Engine 刪除預留項目的日期和時間。日期和時間必須格式化為 RFC 3339 時間戳記。

  • 如要在預留期間開始後的特定時間刪除自動建立的預留項目，請將 autoDeleteAutoCreatedReservations 設為 true，並指定 autoCreatedReservationsDuration 欄位。

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus
    
    {
      "autoDeleteAutoCreatedReservations": "true",
      "autoCreatedReservationsDuration": {
        "seconds": "DURATION_BEFORE_DELETE"
      },
      "name": "FUTURE_RESERVATION_NAME",
      "planningStatus": "PLANNING_STATUS"
    }
    

    將 DURATION_BEFORE_DELETE 改為以秒為單位的時間長度。例如，如要指定 604,800 秒 (7 天)，請使用 604800。

• DESCRIPTION：未來預訂要求的新說明。

• NAME_PREFIX：自動建立的預訂項目的新名稱前置字元，這些預訂項目是為您日後的預訂要求佈建。

• CONSUMER_PROJECT_ID_1 和 CONSUMER_PROJECT_ID_2：您要與之共用未來預留要求專案的 ID。專案必須與擁有者專案位於相同機構。最多可指定 100 個消費者專案。

• SHARE_TYPE：未來預訂要求的新分享類型。執行下列其中一個步驟：

  • 如要指定單一專案的未來預留項目要求，請執行下列步驟：

    • 指定 LOCAL。

    • 移除 shareSettings.projects 欄位。

  • 如要指定共用的未來預留項目要求，請按照下列步驟操作：

    • 指定 SPECIFIC_PROJECTS。

    • 在 shareSettings.projects 欄位中指定至少一個消費端專案。消費者專案必須與擁有者專案位於同一個機構。最多可指定 100 個消費者專案。

• 如要變更要附加至預留 N1 VM 的 GPU 數量和類型，請替換下列項目：

  • NUMBER_OF_ACCELERATORS：每個預留 VM 要新增的 GPU 數量。

  • ACCELERATOR_TYPE：要新增至預留 VM 的 GPU 類型。確認該區域提供 GPU，且未來預留項目要求位於該區域。否則修改要求會失敗。

• INTERFACE_1 和 INTERFACE_2：附加至每個預留 VM 的本機 SSD 磁碟介面類型。請指定下列其中一個值：

  • 如果開機磁碟映像檔具有最佳化 NVMe 驅動程式：NVME。

  • 否則請說出「SCSI」。

    最多可指定 24 個本機 SSD 磁碟。

• MACHINE_TYPE：每個預留 VM 要使用的新機器類型。如果變更機器類型，請一併指定建議的最低預訂期限，適用於新的機器系列。否則， Trusted Cloud 不太可能核准你的修改要求。

• MINIMUM_CPU_PLATFORM：每個預留 VM 的新 CPU 平台基本要求。

• TOTAL_COUNT：您希望在指定期間、VM 設定和專案中預留的 VM 總數。如要增加總數，請確認您有足夠的配額來預留資源。否則 Trusted Cloud 會拒絕你的修改要求。

• START_TIME：預訂期間的新開始時間，格式為 RFC 3339 時間戳記。開始時間不得晚於您提交修改要求以供審查的日期和時間後一年。如要確保有足夠時間在未來預訂項目獲得核准後，以及進入鎖定時間前，選擇取消、刪除或修改預訂項目，請指定建議開始時間。

• END_TIME：預訂期間的新結束時間，格式為 RFC 3339 時間戳記。為提高Trusted Cloud 在提交要求後核准要求的可能性，請指定最短預訂時間。如要指定時間長度而非結束時間，請將 endTime 欄位換成 duration 欄位：

  PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "planningStatus": "PLANNING_STATUS",
    "timeWindow": {
      "duration": {
        "seconds": "END_DURATION"
      }
    }
  }
  

  將 END_DURATION 替換為以秒為單位的時間長度。舉例來說，如要指定 1,209,600 秒 (14 天)，請輸入 1209600。

舉例來說，假設您有名為 fr-03 的共用未來預留項目要求草稿，位於 us-central1-a 區域。假設您想修改這項共用未來預留項目要求，進行下列變更：

• 將要求轉換為單一專案的未來預留項目要求。

• 停用自動刪除選項。

• 預留 100 個 VM。

• 將未來預留要求提交至 Trusted Cloud 進行審查。

如要修改 fr-03，請按照下列方式提出 PATCH 要求：

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": false,
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}