大量建立 VM

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

gcloud

如要在某個區域中大量建立 VM，請使用下列 gcloud compute instances bulk create 指令：

gcloud compute instances bulk create \
    ( --name-pattern="NAME_PATTERN" | --predefined-names=[PREDEFINED_NAMES] ) \
    --region=REGION \
    --count=COUNT \
    [ --min-count=MIN_COUNT \ ]
    [--location-policy=LOCATION_POLICY \ ]
    [--target-distribution-shape=TARGET_DISTRIBUTION_SHAPE ]

更改下列內容：

• NAME_PATTERN：VM 的名稱模式。使用一系列的井字號 (#) 字元，讓 Compute Engine 將其替換為一系列的數字。舉例來說，如果您將 vm-# 用於名稱模式，系統會產生名稱為 vm-1 和 vm-2 的 VM，數量上限為 --count 指定的 VM 數量，且該數量必須小於或等於名稱模式允許的 VM 數量。

  使用名稱模式時，Compute Engine 會檢查先前要求建立的現有 VM 名稱，以避免名稱衝突。

• PREDEFINED_NAMES：要建立的 VM 預先定義名稱清單。如果使用此標記並指定 COUNT，COUNT 必須等於提供的名稱數量。

• REGION：建立 VM 的地區。

• COUNT：要建立的 VM 數量。這個值必須小於或等於 NAME_PATTERN 允許的 VM 數量。或者，如果使用 --predefined-names，您不必指定 COUNT，但如果您要指定，則該值必須等於提供的名稱數量。

• MIN_COUNT：要建立的 VM 最小數量。下表說明要求的行為，取決於您設定此標記的方式：

  值	說明
  未設定	預設值為 COUNT。如果 Compute Engine 無法建立 COUNT 指定的 VM 數量，要求就會失敗，且不會建立任何 VM。
  1	Compute Engine 會盡可能建立多個 VM，最多可達 COUNT。
  大於 1 且小於 COUNT	Compute Engine 會建立至少 MIN_COUNT 個 VM，最多可達 COUNT 個 VM。如果無法建立 MIN_COUNT VM，要求就會失敗，且不會建立任何 VM。

• LOCATION_POLICY：在區域內要納入或排除的可用區。使用鍵/值組合清單，其中區域為鍵，政策為值。政策的有效值為 allow (預設值) 和 deny。以下是此標記的範例值：

  --location-policy=us-east1-b=allow,us-east1-c=deny
  

• TARGET_DISTRIBUTION_SHAPE：VM 在指定可用區中的分布情形。使用 --location-policy 標記指定區域。下表列出此標記的有效值：

  值	說明
  ANY_SINGLE_ZONE	強制將 VM 放置在單一可用區，並優先使用未使用的保留空間。這可用於避免跨區網路輸出，或減少網路延遲時間。這是預設值。
  BALANCED	嘗試在區域內的所有可用區中平均分配 VM。
  ANY	允許在區域中的多個可用區分散 VM。選擇有可用資源的區域，並盡可能增加未使用的區域保留項目。

REST

如要在某個區域大量建立 VM，請使用下列 instances.bulkInsert 方法：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instances/bulkInsert

{
  ...
  "namePattern": "NAME_PATTERN",
  "perInstanceProperties": {
    "PREDEFINED_NAME_1": {},
    "PREDEFINED_NAME_2": {},
    ...
  },
  "count": COUNT,
  "minCount": MIN_COUNT,
  "locationPolicy": {
    "LOCATION_POLICY"
    },
    "targetShape": "TARGET_DISTRIBUTION_SHAPE"
  ...
}

更改下列內容：

• PROJECT_ID：專案 ID。

• REGION：建立 VM 的地區。

• NAME_PATTERN：VM 的名稱模式。請指定這個或 perInstanceProperties。使用一系列的井字號 (#) 字元，讓 Compute Engine 取代一系列的數字。舉例來說，如果名稱模式使用 vm-#，就會產生 vm-1 和 vm-2 等名稱的 VM，最多可達 --count 指定的 VM 數量，且該數量必須小於或等於名稱模式允許的 VM 數量。

  使用名稱模式時，Compute Engine 會檢查先前要求建立的現有 VM 名稱，以避免名稱衝突。

• PREDEFINED_NAME_1、PREDEFINED_NAME_2、...：已定義的 VM 建立名稱清單。請指定這個或 namePattern。如果使用這個標記並指定 COUNT，COUNT 必須等於提供的名稱數量。

• COUNT：要建立的 VM 數量。這個值必須小於或等於 NAME_PATTERN 允許的 VM 數量。或者，如果使用 perInstanceProperties，您不必指定 COUNT，但如果指定，則 COUNT 的數量必須與提供的名稱數量相同。

• MIN_COUNT：要建立的 VM 最小數量。下表說明要求的行為，取決於您設定此標記的方式：

  值	說明
  未設定	預設值為 COUNT。如果 Compute Engine 無法建立 COUNT 指定的 VM 數量，要求就會失敗，且不會建立任何 VM。
  1	Compute Engine 會盡可能建立多個 VM，最多可達 COUNT。
  大於 1 且小於 COUNT	Compute Engine 會建立至少 MIN_COUNT 個 VM，最多可達 COUNT 個 VM。如果無法建立 MIN_COUNT VM，要求就會失敗，且不會建立任何 VM。

• LOCATION_POLICY：在區域內要納入或排除的可用區。使用鍵/值組合清單，其中區域為鍵，政策為值。政策的有效值為 ALLOW (預設值) 和 DENY。以下是這個欄位的範例值：

  "locations": {
    "zones/us-central1-a": { "preference": "ALLOW" },
    "zones/us-central1-c": { "preference": "DENY"  },
    ...
  },
  

• TARGET_DISTRIBUTION_SHAPE：VM 在指定區域的分布情形。使用 locationPolicy 欄位指定區域。下表列出這個欄位的有效值：

  值	說明
  ANY_SINGLE_ZONE	強制將 VM 放置在單一可用區，並優先使用未使用的保留空間。這可用於避免跨區網路輸出，或減少網路延遲時間。這是預設值。
  BALANCED	嘗試在區域內的所有可用區中平均分配 VM。
  ANY	允許在區域中的多個可用區分散 VM。選擇有可用資源的區域，並盡量減少未使用的區域保留項目。

gcloud

如要在特定區域中大量建立 VM，請使用下列 gcloud compute instances bulk create 指令。

gcloud compute instances bulk create \
    ( --name-pattern="NAME_PATTERN" | --predefined-names=[PREDEFINED_NAMES] ) \
    --zone=ZONE \
    --count=COUNT \
    [ --min-count=MIN_COUNT ]

更改下列內容：

• NAME_PATTERN：VM 的名稱模式。使用一系列的井字號 (#) 字元，讓 Compute Engine 將其替換為一系列的數字。舉例來說，如果您將 vm-# 用於名稱模式，系統會產生名稱為 vm-1 和 vm-2 的 VM，數量上限為 --count 指定的 VM 數量，且該數量必須小於或等於名稱模式允許的 VM 數量。

  使用名稱模式時，Compute Engine 會檢查先前要求建立的現有 VM 名稱，以避免名稱衝突。

• PREDEFINED_NAMES：要建立的 VM 預先定義名稱清單。如果使用此標記並指定 COUNT，COUNT 必須等於提供的名稱數量。

• ZONE：建立 VM 的可用區。

• COUNT：要建立的 VM 數量。這個值必須小於或等於 NAME_PATTERN 允許的 VM 數量。或者，如果使用 --predefined-names，您不必指定 COUNT，但如果您要指定，則該值必須等於提供的名稱數量。

• MIN_COUNT：要建立的 VM 最小數量。下表說明要求的行為，取決於您設定此標記的方式：

  值	說明
  未設定	預設值為 COUNT。如果 Compute Engine 無法建立 COUNT 指定的 VM 數量，要求就會失敗，且不會建立任何 VM。
  1	Compute Engine 會盡可能建立多個 VM，最多可達 COUNT。
  大於 1 且小於 COUNT	Compute Engine 會建立至少 MIN_COUNT 個 VM，最多可達 COUNT 個 VM。如果無法建立 MIN_COUNT VM，要求就會失敗，且不會建立任何 VM。

REST

如要在某個區域中大量建立 VM，請使用下列 instances.bulkInsert 方法。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  ...
  "namePattern": "NAME_PATTERN",
  "perInstanceProperties": {
    "PREDEFINED_NAME_1": {},
    "PREDEFINED_NAME_2": {},
    ...
  },
  "count": COUNT,
  "minCount": MIN_COUNT,
  ...
}

更改下列內容：

• PROJECT_ID：專案 ID。

• ZONE：建立 VM 的可用區。

• NAME_PATTERN：VM 的名稱模式。請指定這個或 perInstanceProperties。使用一系列的井字號 (#) 字元，讓 Compute Engine 取代一系列的數字。舉例來說，如果名稱模式使用 vm-#，就會產生 vm-1 和 vm-2 等名稱的 VM，最多可達 --count 指定的 VM 數量，且該數量必須小於或等於名稱模式允許的 VM 數量。

  使用名稱模式時，Compute Engine 會檢查先前要求建立的現有 VM 名稱，以避免名稱衝突。

• PREDEFINED_NAME_1、PREDEFINED_NAME_2、...：已定義的 VM 建立名稱清單。請指定這個或 namePattern。如果使用這個標記並指定 COUNT，COUNT 必須等於提供的名稱數量。

• COUNT：要建立的 VM 數量。這個值必須小於或等於 NAME_PATTERN 允許的 VM 數量。或者，如果使用 perInstanceProperties，您不必指定 COUNT，但如果指定，則 COUNT 的數量必須與提供的名稱數量相同。

• MIN_COUNT：要建立的 VM 最小數量。下表說明要求的行為，取決於您設定此標記的方式：

  值	說明
  未設定	預設值為 COUNT。如果 Compute Engine 無法建立 COUNT 指定的 VM 數量，要求就會失敗，且不會建立任何 VM。
  1	Compute Engine 會盡可能建立多個 VM，最多可達 COUNT。
  大於 1 且小於 COUNT	Compute Engine 會建立至少 MIN_COUNT 個 VM，最多可達 COUNT 個 VM。如果無法建立 MIN_COUNT VM，要求就會失敗，且不會建立任何 VM。

gcloud

如要在特定地區建立含有自訂主機名稱的 VM，請使用下列 gcloud beta compute instances bulk create 指令。

gcloud beta compute instances bulk create \
    ( --name-pattern="NAME_PATTERN" | --predefined-names=[PREDEFINED_NAMES] ) \
    --per-instance-hostnames=[VM_NAME=HOSTNAME,...] \
    --zone=REGION \
    --count=COUNT \
    [ --min-count=MIN_COUNT ]
    [--location-policy=LOCATION_POLICY \ ]
    [--target-distribution-shape=TARGET_DISTRIBUTION_SHAPE ]

更改下列內容：

• NAME_PATTERN：VM 的名稱模式。使用一系列的井字號 (#) 字元，讓 Compute Engine 將其替換為一系列的數字。舉例來說，如果您將 vm-# 用於名稱模式，系統會產生名稱為 vm-1 和 vm-2 的 VM，數量上限為 --count 指定的 VM 數量，且該數量必須小於或等於名稱模式允許的 VM 數量。

  使用名稱模式時，Compute Engine 會檢查先前要求建立的現有 VM 名稱，以避免名稱衝突。

• PREDEFINED_NAMES：要建立的 VM 預先定義名稱清單。如果使用此標記並指定 COUNT，COUNT 必須等於提供的名稱數量。

• [VM_NAME=HOSTNAME, ...]：VM 的預先定義名稱和要指派給 VM 的完整網域主機名稱的鍵/值組合清單。自訂主機名稱必須符合 RFC 1035 要求，才算是有效主機名稱。

• REGION：建立 VM 的可用區。

• COUNT：要建立的 VM 數量。這個值必須小於或等於 NAME_PATTERN 允許的 VM 數量。或者，如果使用 --predefined-names，您不必指定 COUNT，但如果您要指定，則該值必須等於提供的名稱數量。

• MIN_COUNT：要建立的 VM 最小數量。下表說明要求的行為，取決於您設定此標記的方式：

  值	說明
  未設定	預設值為 COUNT。如果 Compute Engine 無法建立 COUNT 指定的 VM 數量，要求就會失敗，且不會建立任何 VM。
  1	Compute Engine 會盡可能建立多個 VM，最多可達 COUNT。
  大於 1 且小於 COUNT	Compute Engine 會建立至少 MIN_COUNT 個 VM，最多可達 COUNT 個 VM。如果無法建立 MIN_COUNT VM，要求就會失敗，且不會建立任何 VM。

• LOCATION_POLICY：在區域內要納入或排除的可用區。使用鍵/值組合清單，其中區域為鍵，政策為值。政策的有效值為 ALLOW (預設值) 和 DENY。以下是這個欄位的範例值：

  "locations": {
    "zones/us-central1-a": { "preference": "ALLOW" },
    "zones/us-central1-c": { "preference": "DENY"  },
    ...
  },
  

• TARGET_DISTRIBUTION_SHAPE：VM 在指定區域的分布情形。使用 locationPolicy 欄位指定區域。下表列出這個欄位的有效值：

  值	說明
  ANY_SINGLE_ZONE	強制將 VM 放置在單一可用區，並優先使用未使用的保留空間。這可用於避免跨區網路輸出，或減少網路延遲時間。這是預設值。
  BALANCED	嘗試在區域內的所有可用區中平均分配 VM。
  ANY	允許在區域中的多個可用區分散 VM。選擇有可用資源的區域，並盡可能增加未使用的區域保留項目。

REST

如要在特定區域中大量建立自訂主機名稱的 VM，請使用下列 instances.bulkInsert 方法：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instances/bulkInsert

{
  ...
  "namePattern": "NAME_PATTERN",
  "perInstanceProperties": {
    "PREDEFINED_NAME_1": {"hostname": HOSTNAME_1},
    "PREDEFINED_NAME_2": {"hostname": HOSTNAME_2},
    ...
  },
  "count": COUNT,
  "minCount": MIN_COUNT,
  "locationPolicy": {
    "LOCATION_POLICY"
    },
    "targetShape": "TARGET_DISTRIBUTION_SHAPE"
  ...
}

更改下列內容：

• PROJECT_ID：專案 ID。

• REGION：建立 VM 的地區。

• NAME_PATTERN：VM 的名稱模式。請指定這個或 perInstanceProperties。使用一系列的井字號 (#) 字元，讓 Compute Engine 取代一系列的數字。舉例來說，如果名稱模式使用 vm-#，就會產生 vm-1 和 vm-2 等名稱的 VM，最多可達 --count 指定的 VM 數量，且該數量必須小於或等於名稱模式允許的 VM 數量。

  使用名稱模式時，Compute Engine 會檢查先前要求建立的現有 VM 名稱，以避免名稱衝突。

• PREDEFINED_NAME_1、PREDEFINED_NAME_2、...：已定義的 VM 建立名稱清單。請指定這個或 namePattern。如果使用這個標記並指定 COUNT，COUNT 必須等於提供的名稱數量。

• HOSTNAME_1、HOSTNAME_2、...：您要為 VM 指派的全合格網域主機名稱。自訂主機名稱必須符合 RFC 1035 要求，才算是有效主機名稱。

  舉例來說，如要建立兩個 VM vm-1 和 vm-2，並分別使用自訂主機名稱 my-host1234.example.com 和 test.example.com，請在 perInstanceProperties 中指定 hostname 屬性，如下所示：

  {
  ...
  "perInstanceProperties": {
  "vm-1": { "hostname": "my-host1234.example.com" },
  "vm-2": { "hostname": "test.example.com" },
  ...
  },
  

• COUNT：要建立的 VM 數量。這個值必須小於或等於 NAME_PATTERN 允許的 VM 數量。或者，如果使用 perInstanceProperties，您不必指定 COUNT，但如果指定，則 COUNT 的數量必須與提供的名稱數量相同。

• MIN_COUNT：要建立的 VM 最小數量。下表說明要求的行為，取決於您設定此標記的方式：

  值	說明
  未設定	預設值為 COUNT。如果 Compute Engine 無法建立 COUNT 指定的 VM 數量，要求就會失敗，且不會建立任何 VM。
  1	Compute Engine 會盡可能建立多個 VM，最多可達 COUNT。
  大於 1 且小於 COUNT	Compute Engine 會建立至少 MIN_COUNT 個 VM，最多可達 COUNT 個 VM。如果無法建立 MIN_COUNT VM，要求就會失敗，且不會建立任何 VM。

• LOCATION_POLICY：在區域內要納入或排除的可用區。使用鍵/值組合清單，其中區域為鍵，政策為值。政策的有效值為 ALLOW (預設值) 和 DENY。以下是這個欄位的範例值：

  "locations": {
    "zones/us-central1-a": { "preference": "ALLOW" },
    "zones/us-central1-c": { "preference": "DENY"  },
    ...
  },
  

• TARGET_DISTRIBUTION_SHAPE：VM 在指定區域的分布情形。使用 locationPolicy 欄位指定區域。下表列出這個欄位的有效值：

  值	說明
  ANY_SINGLE_ZONE	強制將 VM 放置在單一可用區，並優先使用未使用的保留空間。這可用於避免跨區網路輸出，或減少網路延遲時間。這是預設值。
  BALANCED	嘗試在區域內的所有可用區中平均分配 VM。
  ANY	允許在區域中的多個可用區分散 VM。選擇有可用資源的區域，並盡量減少未使用的區域保留項目。

gcloud

1. 從要求傳回的 Operation 中，取得 operationGroupId 屬性的值。

2. 使用 operationGroupId 屬性做為篩選器，搭配 gcloud compute operations list 指令，即可在專案中的所有作業和所有區域中搜尋與區域或區域要求相關聯的 VM：

   gcloud compute operations list \
      --filter=(operationGroupId=OPERATION_GROUP_ID)
   

3. 如要取得 VM 的其他屬性，請執行下列任一操作：

   • 在作業清單中，targetLink 代表 VM 的路徑。使用 gcloud compute instances describe 指令，並將這個路徑做為 VM 名稱，即可取得 VM 的屬性：

     gcloud compute instances describe VM_NAME
     

   • 使用 gcloud compute instances list 指令搭配篩選器，從作業清單中取得 VM 名稱：

     gcloud compute instances list VM_NAME \
        --filter=(name=VM_NAME_1) OR (name=VM_NAME_2)
     

   • 使用 gcloud compute instances list 指令取得所有可用區和區域的 VM 屬性，並依據執行個體專屬的標籤或名稱進行篩選：

     gcloud compute instances list \
        --filter=(name=VM_NAME_1) OR (name=VM_NAME_2)
     

REST

1. 從要求傳回的 Operation 中，取得 operationGroupId 屬性的值。

2. 使用 operationGroupId 屬性，取得與區域或可用區要求相關聯的 VM 作業清單：

   • 如果您傳送區域要求，則如要搜尋專案中的所有作業和所有區域，請使用 globalOperations.aggregatedList 方法，並加入 operationGroupId 屬性做為篩選器：

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/aggregated/operations?filter=(operationGroupId=OPERATION_GROUP_ID)
     

   • 如果您傳送區域要求，請使用 zoneOperations.get 方法，並在要求主體中加入 operationGroupId 屬性，以列出該區域中的作業：

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/bulkInsert
     
     {
     ...
     "operationGroupId":"OPERATION_GROUP_ID"
     ...
     }
     

3. 如要取得 VM 的其他屬性，請執行下列任一操作：

   • 在作業清單中，targetLink 代表 VM 的路徑。使用 instances.get 方法，並將這個路徑設為 VM 的名稱，即可取得所有 VM 的屬性：

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/VM_NAME
     

   • 使用 instances.get 方法搭配篩選器，從作業清單中取得 VM 名稱：

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances?filter=(name=VM_NAME_1) OR (name=VM_NAME_2)
     

   • 使用 instances.aggregatedList 方法取得所有區域和區域中的 VM 屬性，並依據執行個體專屬的標籤或名稱進行篩選：

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/aggregated/instances?filter=(name=VM_NAME_1) OR (name=VM_NAME_2)