本文說明如何在 Compute Engine 中使用預留項目。如要瞭解如何在其他 Google Cloud 產品中使用預訂,請參閱下列說明文件:
建立預留項目後,或 Compute Engine 自動為您建立預留項目以滿足未來預留需求時,Compute Engine 會為您保留預留資源。接著,您可以使用這些預留資源,建立符合預留項目屬性的 Compute Engine 執行個體。這項動作稱為「預訂保留」。在預留容量完全用盡前,您都可以使用預留容量建立執行個體。
限制
您無法使用預留項目建立下列 Compute Engine 資源:
Spot VM 或先占執行個體
單一用戶群節點
事前準備
-
如果尚未設定驗證,請先完成設定。
「驗證」是指驗證身分的程序,確認您有權存取 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
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
如要建立預留項目:
專案的
compute.reservations.create
-
如要建立執行個體,請按照下列步驟操作:
- 專案的
compute.instances.create
權限 - 如要使用自訂映像檔建立 VM,請按一下映像檔上的
compute.images.useReadOnly
: - 如要使用快照建立 VM,請按一下快照上的
compute.snapshots.useReadOnly
- 如要使用執行個體範本建立 VM,請按一下執行個體範本上的
compute.instanceTemplates.useReadOnly
- 如要將舊版網路指派給 VM:專案的
compute.networks.use
- 如要為 VM 指定靜態 IP 位址,請在專案中擁有
compute.addresses.use
權限 - 使用舊版網路時,如要將外部 IP 位址指派給 VM,請在專案中設定
compute.networks.useExternalIp
- 為 VM 指定子網路:專案或所選子網路的
compute.subnetworks.use
- 使用虛擬私有雲網路時,如要將外部 IP 位址指派給 VM,請在專案或所選子網路上擁有
compute.subnetworks.useExternalIp
權限 - 如要為專案中的 VM 設定 VM 執行個體中繼資料,請執行下列指令:
compute.instances.setMetadata
- 如要為 VM 設定標記,請在 VM 上按一下
compute.instances.setTags
- 如要為 VM 設定標籤,請在 VM 上執行下列步驟:
compute.instances.setLabels
- 如要設定 VM 使用的服務帳戶,請在 VM 上執行
compute.instances.setServiceAccount
- 如要為 VM 建立新磁碟,請取得專案的
compute.disks.create
權限 - 如要以唯讀或讀寫模式連接現有磁碟,請對磁碟擁有
compute.disks.use
權限 - 如要以唯讀模式連接現有磁碟,請對磁碟擁有
compute.disks.useReadOnly
權限
- 專案的
-
如要建立執行個體範本:
按一下專案上的
compute.instanceTemplates.create
如要建立會耗用自動預留項目的執行個體 (無論該預留項目是如何建立),請參閱「耗用自動耗用的預留項目」。
如要建立使用特定保留項目的執行個體,請參閱「使用明確指定的預留項目」。
如要建立執行個體,以耗用 Compute Engine 自動建立的特定預留項目 (在本例中,是為了滿足日曆模式中的未來預留項目),請參閱「耗用日曆模式中要求的自動建立預留項目」。
如要建立範例預留項目,請完成下列步驟:
在 Google Cloud 控制台,前往「Reservations」(預留項目) 頁面。
其餘步驟會自動顯示在Google Cloud 控制台。
在「隨需預留項目」分頁 (預設) 中,按一下
「建立預留項目」。「Create a reservation」(建立預留項目) 頁面隨即顯示。在「Name」(名稱) 欄位中,輸入預留項目的名稱,例如:輸入
reservation-01
。選取要預留資源的「Region」(區域) 和「Zone」(可用區)。例如,分別選取「us-central1」和「us-central1-a」。
在「分享類型」部分,執行下列任一操作:
如要建立單一專案預留項目,請選取「本機」。
如要建立共用預訂,請選取「共用」,然後指定要共用預訂的專案。
在「Use with VM instance」(搭配 VM 執行個體使用) 區段中,選取「Use reservation automatically」(自動使用保留項目) (如果尚未選取)。
在「Number of VM instances」(VM 執行個體數量) 欄位中,輸入
3
。在「一般用途」分頁中,選取「N2」。
在「Machine type」(機型) 部分,選取「Preset」(預設) 分頁 (預設),然後選取「n2-standard-32」。
展開「CPU platform and GPU」(CPU 平台和 GPU),然後在「CPU platform」(CPU 平台) 欄位中選取「Intel Cascade Lake or later」(Intel Cascade Lake 以上版本)。
點選「建立」。
如要建立使用範例預留項目的執行個體,請完成下列步驟:
前往 Google Cloud 控制台的「建立執行個體」頁面。
「建立執行個體」頁面隨即顯示,並顯示「機器設定」窗格。
在「機器設定」窗格中,執行下列操作:
在「Name」(名稱) 欄位中,輸入執行個體的名稱。在本範例中,請輸入
instance-01
。指定要預留資源的「Region」(區域) 和「Zone」(可用區)。 在本範例中,請分別選取 us-central1 和 us-central1-a。
在「一般用途」分頁中,選取「N2」。
在「Machine type」(機型) 部分,選取「Preset」(預設) 分頁 (預設),然後選取「n2-standard-32」。
展開「Advanced options」(進階選項) 區段,然後在「CPU platform」(CPU 平台) 欄位中,選取「Intel Cascade Lake or later」(Intel Cascade Lake 以上版本)。
選用:根據預設,系統會自動使用相符的預留項目。不過,如要指定這項設定,請按照下列步驟操作:
在導覽選單中,按一下「進階」。系統會顯示「進階」窗格。
在「預留項目」部分,選取「使用自動選取功能」。
點選「建立」。
如要建立範例預留項目,請使用
gcloud compute reservations create
指令:gcloud compute reservations create reservation-01 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --vm-count=3 \ --zone=us-central1-a
如要建立使用範例預訂項目的執行個體,請使用
gcloud compute instances create
指令,並將--reservation-affinity
旗標設為any
。由於any
是預設設定,因此您也可以省略這個旗標。gcloud compute instances create instance-01 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --reservation-affinity=any \ --zone=us-central1-a
如要建立範例預留項目,請對
reservations.insert
方法發出POST
要求:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "reservation-01", "specificReservation": { "count": "3", "instanceProperties": { "machineType": "n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", } } }
如要建立使用範例預留項目的執行個體,請對
instances.insert
方法發出POST
要求。在要求主體中,加入設為ANY_RESERVATION
的consumeReservationType
欄位。不過,由於ANY_RESERVATION
是預設設定,您也可以省略這個欄位。POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances { "name": "instance-01", "machineType": "zones/us-central1-a/machineTypes/n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/debian-cloud/global/images/family/debian-12" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "ANY_RESERVATION" } }
--reservation-affinity
旗標設為specific
。--reservation
旗標設為預訂的網址。ConsumeReservationType
欄位設為SPECIFIC_RESERVATION
。Key
欄位設為compute.googleapis.com/reservation-name
。Values
欄位設為預訂網址。setConsumeReservationType
欄位設為SPECIFIC_RESERVATION
。setKey
欄位設為compute.googleapis.com/reservation-name
。addValues
欄位設為預訂網址。consumeReservationType
欄位設為SPECIFIC_RESERVATION
。key
欄位設為compute.googleapis.com/reservation-name
。values
欄位設為預訂網址。consume_reservation_type
欄位設為SPECIFIC_RESERVATION
。key
欄位設為compute.googleapis.com/reservation-name
。values
欄位設為預訂網址。如要建立範例預留項目,請完成下列步驟:
在 Google Cloud 控制台,前往「Reservations」(預留項目) 頁面。
其餘步驟會自動顯示在Google Cloud 控制台。
在「隨需預留項目」分頁 (預設) 中,按一下
「建立預留項目」。「Create a reservation」(建立預留項目) 頁面隨即顯示。在「Name」(名稱) 欄位中,輸入預留項目的名稱,例如:輸入
reservation-02
。指定要預留資源的「區域」和「可用區」。在本範例中,請分別選取「us-central1」和「us-central1-a」。
在「分享類型」部分,執行下列任一操作:
如要建立單一專案預留項目,請選取「本機」。
如要建立共用預訂,請選取「共用」,然後指定要共用預訂的專案。
在「Use with VM instance」(搭配 VM 執行個體使用) 部分,選取「Select specific reservation」(選取特定保留項目)。
在「Number of VM instances」(VM 執行個體數量) 欄位中,輸入
3
。在「一般用途」分頁中,選取「N2」。
在「Machine type」(機型) 部分,選取「Preset」(預設) 分頁 (預設),然後選取「n2-standard-32」。
展開「CPU platform and GPU」(CPU 平台和 GPU),然後在「CPU platform」(CPU 平台) 欄位中選取「Intel Cascade Lake or later」(Intel Cascade Lake 以上版本)。
點選「建立」。
如要建立使用範例預留項目的執行個體,請完成下列步驟:
前往 Google Cloud 控制台的「建立執行個體」頁面。
「建立執行個體」頁面隨即顯示,並顯示「機器設定」窗格。
在「機器設定」窗格中,執行下列操作:
在「Name」(名稱) 欄位中,輸入執行個體的名稱。在本範例中,請輸入
instance-02
。指定要預留資源的「區域」和「可用區」。在本範例中,請分別選取「us-central1」和「us-central1-a」。
在「一般用途」分頁中,選取「N2」。
在「Machine type」(機型) 部分,選取「Preset」(預設) 分頁 (預設),然後選取「n2-standard-32」。
展開「Advanced options」(進階選項) 區段,然後在「CPU platform」(CPU 平台) 欄位中,選取「Intel Cascade Lake or later」(Intel Cascade Lake 以上版本)。
在導覽選單中,按一下「進階」。系統會顯示「進階」窗格。
在「Reservations」(預留項目) 部分,選取「Choose a reservation」(選取預留項目),然後點選「Choose reservation」(選取預留項目)。
在隨即顯示的「選擇預留項目」窗格中,執行下列操作:
選取您在前述步驟中建立的特定預留項目。如要使用其他專案中的共用預留項目,請在「專案」清單中選取預留項目所在的專案。
按一下「選擇」。
點選「建立」。
如要建立範例預訂,請使用
gcloud compute reservations create
指令搭配--require-specific-reservation
旗標:gcloud compute reservations create reservation-02 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --require-specific-reservation \ --vm-count=3 \ --zone=us-central1-a
如要建立使用範例預留項目的執行個體,請使用
gcloud compute instances create
指令搭配--reservation
和--reservation-affinity=specific
旗標:gcloud compute instances create instance-02 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --reservation-affinity=specific \ --reservation=RESERVATION_URL \ --zone=us-central1-a
將
RESERVATION_URL
替換為預訂的網址。請指定下列其中一個值:如果您在同一個專案中建立預留項目:
reservation-02
如果保留項目位於其他專案:
projects/PROJECT_ID/reservations/reservation-02
如要建立範例執行個體,以使用單一專案的特定預留項目,請使用下列程式碼範例:
如要建立範例執行個體來使用共用的特定預留項目,請使用下列程式碼範例:
如要建立範例預留項目做為單一專案預留項目,並建立執行個體來使用該預留項目,請使用下列程式碼範例:
如要建立範例預留項目做為共用預留項目,並建立執行個體來使用該預留項目,請使用下列程式碼範例:
如要建立及使用範例預留項目做為單一專案預留項目,請使用下列程式碼範例:
如要建立及使用範例預留項目做為共用預留項目,請使用下列程式碼範例:
如要建立範例預留項目,請對
instances.insert
方法發出POST
要求。在要求主體中,加入設為true
的specificReservationRequired
欄位:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "reservation-02", "specificReservation": { "count": "3", "instanceProperties": { "machineType": "n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", } }, "specificReservationRequired": true }
如要建立使用範例預留項目的執行個體,請對
instances.insert
方法發出POST
要求。在要求主體的reservationAffinity
欄位中,加入下列項目:consumeReservationType
欄位設為SPECIFIC_RESERVATION
。key
欄位設為compute.googleapis.com/reservation-name
。values
欄位設為預訂網址。
要求類似於下列內容:
POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances { "name": "instance-02", "machineType": "zones/us-central1-a/machineTypes/n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/debian-cloud/global/images/family/debian-12" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "SPECIFIC_RESERVATION", "key": "compute.googleapis.com/reservation-name", "values": [ "RESERVATION_URL" ] } }
將
RESERVATION_URL
替換為預訂的網址。請指定下列其中一個值:如果您在同一個專案中建立預留項目:
reservation-02
如果保留項目位於其他專案:
projects/PROJECT_ID/reservations/reservation-02
執行個體必須明確指定保留項目。
執行個體必須在預留項目結束時間前停止或刪除。
執行個體必須使用取決於預留項目佈建模式。建立執行個體時,您可以指定這個模型,如下所示:
在 Google Cloud 控制台中,如果您在日曆模式中為未來預留項目指定支援的機器類型,系統會自動選取與預留項目綁定的模型。
在 gcloud CLI 中,加入設為
reservation-bound
的--provisioning-model
旗標。在 REST API 中,加入設為
RESERVATION_BOUND
的provisioningModel
欄位。
建立五個 A3 Ultra 執行個體的範例要求,並提交審查:
在 Google Cloud 控制台,前往「Reservations」(預留項目) 頁面。
點按「Future reservations」(未來預留項目) 分頁標籤。
點按
「Create future reservation」(建立未來預留項目)。「Create a future reservation」(建立未來預留項目) 頁面隨即顯示。在「硬體設定」部分,選取「指定機器類型」,然後指定 A3 Ultra 執行個體。
在「Obtainability method」(取得方法) 區段中,完成下列步驟:
選取「搜尋最多 90 天的運算資源」。
在「Region」(區域) 和「Zone」(可用區) 清單中,指定要預留資源的區域和可用區。在本範例中,請分別選取 us-central1 和 us-central1-a。
在「Total capacity needed」(所需總容量) 欄位中輸入
5
。在「預留期間」部分,指定預留項目的預留期間。
指定其餘欄位,然後按一下「提交」。
在要求開始時間,如要建立 A3 Ultra 執行個體來使用範例自動建立的預留項目,請按照下列步驟操作:
前往 Google Cloud 控制台的「建立執行個體」頁面。
在「Name」(名稱) 欄位中,輸入執行個體的名稱。在本範例中,請輸入
example-instance
。指定要預留資源的「Region」(區域) 和「Zone」(可用區)。在本範例中,請分別選取 us-central1 和 us-central1-a。
按一下「GPU」分頁標籤,然後在「GPU type」(GPU 類型) 清單中,選取「NVIDIA H200 141GB」。這項動作會指定 A3 Ultra 執行個體,並將佈建模式設為「取決於預留項目」。
在導覽選單中,按一下「進階」。
在「Reservations」(預留項目) 部分,選取「Choose a reservation」(選取預留項目),然後點選「Choose a reservation」(選取預留項目)。
在「Choose a reservation」(選擇預留項目) 窗格中,執行下列操作:
選取特定預留項目。如要使用其他專案中的共用預留項目,請在「專案」清單中選取預留項目所在的專案。
按一下「選擇」。
在「佈建模式」部分,展開「VM 佈建模式進階設定」部分。
在「On VM termination」(VM 終止時) 清單中,選取「Stop」(停止) (預設) 或「Delete」(刪除)。
點選「建立」。
如要建立五個 A3 Ultra VM 的範例要求,並提交審查,請使用
gcloud beta compute future-reservations create
指令:gcloud beta compute future-reservations create example-fr \ --auto-delete-auto-created-reservations \ --deployment-type=DENSE \ --planning-status=SUBMITTED \ --require-specific-reservation \ --reservation-mode=CALENDAR \ --reservation-name=example-reservation \ --share-type=local \ --start-time=2025-10-05T00:00:00Z \ --end-time=2025-10-19T00:00:00Z \ --machine-type=a3-ultragpu-8g \ --total-count=5 \ --zone=us-central1-a
假設 Google Cloud 核准要求,Compute Engine 會自動建立空白預留項目。在 2025 年 10 月 5 日的要求開始時間,Compute Engine 會增加預留項目中的預留 GPU VM 數量。然後即可使用預留項目。
在要求開始時間,如要建立 A3 Ultra 執行個體來使用範例自動建立的預訂項目,請使用
gcloud compute instances create
指令搭配下列旗標:--instance-termination-action
標記。--provisioning-model
旗標設為RESERVATION_BOUND
。--reservation
標記。--reservation-affinity
旗標設為specific
。
指令類似於下列內容。如要瞭解建立 A3 Ultra 執行個體的完整需求,請參閱「建立 A3 Ultra 或 A4 執行個體」。
gcloud compute instance create example-instance \ --machine-type=a3-ultragpu-8g \ --instance-termination-action=TERMINATION_ACTION \ --provisioning-model=RESERVATION_BOUND \ --reservation-affinity=specific \ --reservation=RESERVATION_URL \ --zone=us-central1-a \ ...
這項指令包含下列值:
TERMINATION_ACTION
:Compute Engine 在預訂期結束時,是停止 (STOP
) 還是刪除 (DELETE
) VM。RESERVATION_URL
:預訂網址,格式如下:如果專案中已有自動建立的預留項目:
example-reservation
。如果自動建立的預留項目位於其他專案:
projects/PROJECT_ID/reservations/example-reservation
。
如要建立五個 A3 Ultra 執行個體的要求範例,並提交審查,請對 Beta 版
futureReservations.insert
方法發出POST
要求:POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "name": "example-request-calendar-mode", "autoDeleteAutoCreatedReservations": true, "deploymentType": "DENSE", "planningStatus": "SUBMITTED", "reservationMode": "CALENDAR", "reservationName": "example-reservation", "shareSettings": { "shareType": "LOCAL" }, "specificReservationRequired": true, "specificSkuProperties": { "machineType": "a3-ultragpu-8g", "totalCount": 5 }, "timeWindow": { "startTime": "2025-10-05T00:00:00Z", "endTime": "2025-10-19T00:00:00Z" } }
假設 Google Cloud 核准要求,Compute Engine 會自動建立空白預留項目。在 2025 年 10 月 5 日的要求開始時間,Compute Engine 會增加預留項目中的預留 GPU VM 數量。然後即可使用預留項目。
在要求開始時間,如要建立 A3 Ultra 執行個體來使用範例自動建立的預留項目,請對
instances.insert
方法提出POST
要求。在要求主體中加入下列欄位:reservationAffinity.consumeReservationType
欄位設為SPECIFIC_RESERVATION
。reservationAffinity.key
欄位設為compute.googleapis.com/reservation-name
。「
reservationAffinity.values
」欄位設為預訂網址。scheduling.instanceTerminationAction
欄位。scheduling.provisioningModel
欄位設為RESERVATION_BOUND
。
要求類似如下。如要瞭解建立 A3 Ultra 執行個體的完整需求,請參閱「建立 A3 Ultra 或 A4 執行個體」。
POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/ { { "machineType": "projects/example-project/zones/us-central1-a/machineTypes/a3-ultragpu-8g", "name": "example-instance", "reservationAffinity": { "consumeReservationType": "SPECIFIC_RESERVATION", "key": "compute.googleapis.com/reservation-name", "values":[ "RESERVATION_URL" ], }, "scheduling": { "instanceTerminationAction": "TERMINATION_ACTION", "provisioningModel": "RESERVATION_BOUND" }, ... } }
要求主體包含下列值:
RESERVATION_URL
:預訂網址,格式如下:如果專案中已有自動建立的預留項目:
example-reservation
。如果自動建立的預留項目位於其他專案:
projects/PROJECT_ID/reservations/example-reservation
。
TERMINATION_ACTION
:Compute Engine 在預訂期結束時,是停止 (STOP
) 還是刪除 (DELETE
) VM。
將預留項目複製為單一執行個體的明確指定預留項目。
建立測試執行個體,以使用預留項目。
如要查看目前使用預留項目的運算執行個體數量,以及還能使用預留項目的執行個體數量,請查看預留項目。
如要監控每 30 分鐘更新一次的預訂用量資料,並在預訂用完或未使用時收到快訊,請監控預訂用量。
如要查看每 24 小時更新的預訂項目用量資料,請執行下列任一操作:
- 如要在 Cloud Storage bucket 中接收用量報表,以便分析用量趨勢及找出未使用的預訂項目,請查看預訂項目用量報表。
- 如要查看過去和預測的預留項目用量,以便分析用量趨勢及規劃日後的容量需求,請使用 Capacity Planner。
Go
如要在本機開發環境中使用本頁的 Go 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Java
如要在本機開發環境中使用本頁的 Java 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Node.js
如要在本機開發環境中使用本頁的 Node.js 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Python
如要在本機開發環境中使用本頁的 Python 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
REST
如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。
必要的角色
如要取得使用預留資源所需的權限,請要求管理員授予您專案的 Compute 執行個體管理員 (v1) (
roles/compute.instanceAdmin.v1
) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。這個預先定義的角色具備使用預訂項目所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
如要使用預留項目,必須具備下列權限:
使用預留項目
以下各節的範例說明如何建立單一運算執行個體,藉此使用預留項目。您也可以使用其他部署選項建立符合保留項目屬性的執行個體,或是更新現有執行個體的屬性,使其符合自動使用的保留項目,藉此使用保留項目。
如要使用預留項目,請採取下列其中一種做法:
使用自動耗用的預留項目
建立自動耗用的預留項目後,符合預留項目屬性的運算執行個體就會自動耗用該預留項目。這項消耗行為適用於新執行個體和現有執行個體。建立預留項目時,或是 Compute Engine 自動建立預留項目來滿足未來預留項目時,這個預留項目類型是預設設定。
如果單一專案自動預留項目和共用自動預留項目的屬性相符,專案中的執行個體會先使用單一專案預留項目,然後再使用共用預留項目。詳情請參閱「預留項目的消耗順序」。
如要建立及使用範例自動預留項目,請選取下列任一選項:
主控台
以下範例說明如何在區域
us-central1-a
中建立自動保留項目,保留三個 N2 執行個體,每個執行個體有 32 個 vCPU,並以 Intel Cascade Lake 做為最低 CPU 平台。並說明如何建立單一執行個體來使用預留項目。如要建立範例自動預留項目並加以使用,請按照下列步驟操作:
gcloud
以下範例說明如何在區域
us-central1-a
中建立自動保留項目,保留三個 N2 執行個體,每個執行個體有 32 個 vCPU,並以 Intel Cascade Lake 做為最低 CPU 平台。並說明如何建立單一執行個體來使用預留項目。如要建立範例自動預留項目並加以使用,請按照下列步驟操作:
Go
如要使用執行個體範本建立範例自動預留項目,並使用相同範本建立執行個體來使用預留項目,請使用下列程式碼範例:
Java
下列範例說明如何在
us-central1-a
區域中,建立具有四個 vCPU 的 N1 執行個體,並將 Intel Skylake 設為最低 CPU 平台。執行個體會自動使用相符的預留項目。如要建立範例執行個體,請使用下列程式碼範例:
Node.js
下列範例說明如何在
us-central1-a
區域中,建立具有四個 vCPU 的 N1 執行個體,並將 Intel Skylake 設為最低 CPU 平台。執行個體會自動使用相符的預留項目。如要建立範例執行個體,請使用下列程式碼範例:
Python
以下範例說明如何在區域
us-central1-a
中建立自動預留項目,供三個 N1 執行個體使用,每個執行個體有一個 vCPU,且最低 CPU 平台為 Intel Ivy。並說明如何建立單一執行個體來使用預留項目。如要建立範例自動預留項目並加以使用,請按照下列步驟操作:
REST
以下範例說明如何在區域
us-central1-a
中建立自動保留項目,保留三個 N2 執行個體,每個執行個體有 32 個 vCPU,並以 Intel Cascade Lake 做為最低 CPU 平台。並說明如何建立單一執行個體來使用預留項目。如要建立範例自動預留項目並加以使用,請按照下列步驟操作:
使用明確指定的預留項目
明確指定的預留項目允許新的運算執行個體使用相符的預留項目,但前提是執行個體必須指定該預留項目。只有在執行個體的屬性與預留項目屬性相符時,系統才會成功建立執行個體。否則會發生錯誤。
根據您要使用的建立方法,建立特定保留項目和指定這些項目的執行個體,方法如下:
建立方式 建立預留項目時 建立執行個體時 Google Cloud 控制台 在「Use with VM instance」(搭配 VM 執行個體使用) 部分,選取「Select specific reservation」(選取特定保留項目)。 在「進階」窗格的「預留項目」部分,選取「選擇預留項目」。 Google Cloud CLI 加上 --require-specific-reservation
旗標。請加入下列旗標:
Go 加入設為 true
的SpecificReservationRequired
欄位。在 ReservationAffinity
欄位中,加入下列欄位:Java 加入設為 true
的setSpecificReservationRequired
欄位。在 ReservationAffinity
欄位中,加入下列欄位:Node.js 和 REST API 加入設為 true
的specificReservationRequired
欄位。在 reservationAffinity
欄位中,加入下列欄位:Python 和 Terraform 加入設為 true
的specific_reservation_required
欄位。在 reservation_affinity
欄位中,加入下列欄位:如要建立範例專屬預留項目和使用該項目的執行個體,請選取下列任一選項:
主控台
以下範例說明如何在
us-central1-a
區域中,為三個 N2 執行個體建立特定預訂,這些執行個體具有 32 個 vCPU,且最低 CPU 平台為 Intel Cascade Lake。並說明如何建立單一執行個體來使用預留項目。如要建立範例專屬預留項目並加以使用,請按照下列步驟操作:
gcloud
以下範例說明如何在
us-central1-a
區域中,為三個 N2 執行個體建立特定預訂,這些執行個體具有 32 個 vCPU,且最低 CPU 平台為 Intel Cascade Lake。並說明如何建立單一執行個體來使用預留項目。如要建立範例專屬預留項目並加以使用,請按照下列步驟操作:
Go
以下範例說明如何在
us-central1-a
區域中建立具有 32 個 vCPU 的 N2 執行個體,並將 Intel Cascade Lake 設為最低 CPU 平台,以使用相符的特定預訂項目:Java
下列範例說明如何在
us-central1-a
區域中建立 N1 執行個體,並指定四個 vCPU 和 Intel Skylake 做為最低 CPU 平台,以使用相符的特定預訂項目:Node.js
下列範例說明如何在
us-central1-a
區域中建立具有 4 個 vCPU 的 N1 執行個體,並將 Intel Skylake 設為最低 CPU 平台,以使用特定相符的預訂項目:Python
以下範例說明如何在
us-central1-a
區域中建立具有 32 個 vCPU 的 N2 執行個體,並將 Intel Cascade Lake 設為最低 CPU 平台,以使用相符的特定預訂項目:如要建立範例專屬預留項目並加以使用,請按照下列步驟操作:
REST
以下範例說明如何在
us-central1-a
區域中,為三個 N2 執行個體建立特定預訂,這些執行個體具有 32 個 vCPU,且最低 CPU 平台為 Intel Cascade Lake。並說明如何建立單一執行個體來使用預留項目。如要建立範例專屬預留項目並加以使用,請按照下列步驟操作:
在日曆模式中,針對要求耗用自動建立的預留項目
這類預留項目可供新的運算執行個體耗用,而 Compute Engine 會自動建立預留項目,以滿足日曆模式中的未來預留項目。
如要使用這類預留項目,請按照下列方式建立執行個體:
以下範例會在日曆模式中建立 A3 Ultra 執行個體的未來預留要求。這個範例也顯示建立獨立 A3 Ultra 執行個體時要指定的欄位,以便使用系統為要求自動建立的預訂項目。
如要使用自動建立的範例預留項目,請選取下列其中一個選項:
主控台
gcloud
REST
測試執行個體屬性是否與自動耗用的預留項目相符
如要測試運算執行個體的屬性是否與自動耗用的預留項目相符,請按照下列步驟操作:
如果可以建立測試執行個體,表示其屬性與測試保留項目的屬性相符。否則會發生錯誤。
確認測試執行個體和測試保留項目的屬性相符後,請刪除保留項目和測試執行個體。
確認預留項目使用情形
如要驗證預訂項目用量,請採取下列一或多項做法:
後續步驟
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-11 (世界標準時間)。
-