新增及移除 MIG 中的 VM

---

建立代管執行個體群組 (MIG) 後，您可能需要新增或移除群組中的 VM，以滿足工作負載需求。如果您已達到可新增至 MIG 的 VM 數量上限，且需要更多 VM，可以提高 MIG 的大小上限。

如要在 MIG 中新增或移除 VM，可以採取下列做法：

• 設定 MIG 的目標大小，自動新增或移除 VM：
  • 針對無狀態應用程式使用自動調度資源功能
  • 在 MIG 中建立大小調整要求
  • 手動設定 MIG 大小
• 手動新增、移除或捨棄特定執行個體：
  • 建立具有特定名稱的執行個體
  • 刪除特定執行個體
  • 捨棄特定執行個體

事前準備

• 如果尚未設定驗證，請先完成設定。 「驗證」是指驗證身分的程序，確認您有權存取 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. 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.

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  Terraform

  如要在本機開發環境中使用本頁的 Terraform 範例，請安裝並初始化 gcloud CLI，然後使用使用者憑證設定應用程式預設憑證。

  1. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  3. To initialize the gcloud CLI, run the following command:

     gcloud init

  4. 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.

  詳情請參閱 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」。

設定群組的目標大小

您可以使用自動調度器自動設定 MIG 的目標大小，也可以手動設定大小。

在 MIG 中自動新增及移除 VM

您可以設定代管執行個體群組，根據 VM 的工作負載自動新增或移除 VM。您的應用程式可緩解流量的增加，並且可在運算資源需求降低時節省成本。如要開始調度代管執行個體群組的資源，請參閱建立啟用自動調度功能的 MIG。

詳情請參閱自動調度執行個體群組資源。

建立大小調整要求

您可以透過大小調整要求，一次將多個 GPU VM 新增至 MIG。這項功能可協助您避免在 Compute Engine 佈建所有資源時，因部分容量而產生費用。MIG 規模調整要求會使用「彈性啟動」或「取決於預留項目」佈建模式。這些模型可讓您以折扣價取得 vCPU 和 GPU。

詳情請參閱關於 MIG 中的大小調整要求。

手動設定 MIG 大小

若代管執行個體群組尚未設定為自動調度資源，您可手動調整群組大小，來變更群組中的執行個體數。如果您增加大小，代管執行個體群組會使用目前執行個體範本新增執行個體。如果您減少大小，代管執行個體群組會從群組中刪除 VM。這個群組會先刪除 currentAction 為DELETING、CREATING 和 RECREATING 的執行個體，然後再刪除正在無排程動作的情況下執行的執行個體。

如果群組屬於後端服務的一部分，且該服務已啟用連線排除，在連線排除持續時間過後，最長可能需要等待 60 秒才能移除或刪除 VM 執行個體。

這項工作需要的權限

如要執行這項工作，您必須具備以下權限：

• 代管執行個體群組上的 compute.instanceGroupManagers.update

主控台

1. 前往 Google Cloud 控制台的「Instance groups」(執行個體群組) 頁面。

   前往「Instance groups」(執行個體群組) 頁面

2. 在清單的「Name」(名稱) 欄底下，找到要變更群組大小的執行個體群組並按一下其名稱。

3. 按一下「編輯」，修改這個代管執行個體群組。

4. 在「Number of instances」(執行個體數) 底下，指定您希望這個代管執行個體群組包含的執行個體數。若已啟用「Autoscaling」(自動調度資源)，群組會視需要自動新增或移除執行個體。但是，您可以變更「Minimum number of instances」(執行個體數量下限) 與「Maximum number of instances」(執行個體數量上限) 值，透過自動配置器間接調整群組大小。

5. 按一下 [Save] (儲存)，套用新範本。

gcloud

使用 resize 指令。

gcloud compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --zone ZONE

REST

呼叫可用區或區域 MIG 資源的 resize 方法。請將新的執行個體群組大小指定為參數。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resize?size=NEW_SIZE

如果該執行個體群組是地區代管執行個體群組，請將 zones/ZONE 替換成 regions/REGION。

提出調整代管執行個體群組大小的要求之後，VM 會在系統可以佈建或刪除時立即開始運作或停止。此程序可能會花費大量時間，花費時間視群組中的執行個體數而定。 在您的代管執行個體群組中驗證執行個體狀態。

注意： 由於新 VM 是使用目前的執行個體範本建立，因此，如果您在變更執行個體範本之後新增執行個體至群組，群組中可能會包含不同的 VM。現有 VM 會使用之前的執行個體範本，直到您重新建立 VM 為止，且新 VM 會將目前指定的執行個體範本用於 MIG。

調整大小時停用建立重試模式

Beta 版

這項產品適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。 正式發布前的產品是依「原樣」提供，支援服務可能受限。 詳情請參閱「推出階段說明」。

根據預設，如果初始建立 VM 執行個體失敗，代管執行個體群組會繼續重試建立 VM，直到成功建立 VM 為止。不過，如果您不想使用自動建立重試，可在調整執行個體群組大小時停用建立重試模式。在這個模式下，代管執行個體群組只會進行一次嘗試，來建立所有執行個體。如果執行個體建立期間發生錯誤，代管執行個體群組會放棄建立該執行個體，並從群組的代管執行個體清單中移除該執行個體，同時縮減代管執行個體群組的目標大小。

只有在第一次嘗試建立 VM 期間，才會套用這個模式。如果在啟用這個模式時成功建立了 VM，VM 的行為會與使用一般調整大小要求建立的其他所有 VM 一樣。重要的是，如果執行中的 VM 日後意外停轉，且需要重新建立，這個模式不會影響在這種情況下重新建立的行為。

如果您的系統會自動建立不需要確切 VM 數量的 VM 群組，停用建立重試模式將特別有用。您可能希望代管執行個體群組的大小能快速穩定下來，並彈性調整群組中的 VM 數量，而不是無限期等待，直到所有要求的執行個體都建立完成為止。由於配額錯誤或其他不相關的問題，這項作業可能會暫時或永久延遲。

限制

• 如果區域性 MIG 具有 EVEN 目標分配型態，您就無法停用建立重試。
• 如果區域 MIG 的目標分配型態為 BALANCED 或 ANY_SINGLE_ZONE，您必須先停用主動式執行個體重新分配功能，才能停用建立重試模式。
• 您無法為自動調度資源的 MIG 停用建立重試功能。

如要在建立重試模式停用時調整代管執行個體群組大小，請使用 Google Cloud CLI 或 REST。

重要事項： Google 建議您不要同時執行兩項大小調整作業，並使用不同的建立重試模式，否則可能會導致目標大小超出預期。舉例來說，如果您發出調整大小指令，但未啟用建立重試機制，且在指令完成前，發出第二個調整大小指令並啟用建立重試機制，則第二個指令不會使第一個指令失效。部分執行個體會建立，但不會重試，如果其中任何一個執行個體建立失敗，群組的目標大小就會相應減少。

這項工作需要的權限

如要執行這項工作，您必須具備以下權限：

• 代管執行個體群組上的 compute.instanceGroupManagers.update

gcloud

使用加上 --no-creation-retries 旗標的 beta resize 指令。

gcloud beta compute instance-groups managed resize INSTANCE_GROUP_NAME \
    --size NEW_SIZE \
    --no-creation-retries \
    [--region REGION | --zone ZONE]

更改下列內容：

• INSTANCE_GROUP_NAME：要調整大小的 MIG 名稱。
• NEW_SIZE：代管執行個體群組中執行個體的目標數量。
• ZONE：如果是可用區 MIG，則為 MIG 所在的可用區。
• REGION：如果是區域 MIG，則為 MIG 所在的區域。

REST

如果是區域 MIG，請使用 beta instanceGroupManagers.resizeAdvanced 方法；如果是區域 MIG，請使用 beta regionInstanceGroupManagers.resizeAdvanced 方法。在要求主體中指定新群組大小與 noCreationRetries 欄位。

舉例來說，請發出下列呼叫，停用建立重試模式，然後調整區域 MIG 的大小。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeAdvanced

{
 "targetSize": NEW_SIZE,
 "noCreationRetries": true
}

更改下列內容：

• PROJECT_ID：您的專案 ID。
• ZONE：MIG 所在的可用區。如果是區域 MIG，請將 zones/ZONE 替換為 regions/REGION，並指定區域。詳情請參閱關於區域 MIG 一文。
• INSTANCE_GROUP_NAME：要調整大小的 MIG 名稱。

• NEW_SIZE：代管執行個體群組中執行的執行個體目標數量。

  您可以使用 listManagedInstances 方法查看正在建立的執行個體以及執行的模式。建立重試模式停用時，您建立的執行個體會具有 CREATING_WITHOUT_RETRIES 的 currentAction。

新增、移除或捨棄特定執行個體

下列各節說明如何在 MIG 中新增、移除或捨棄特定執行個體。

在 MIG 中使用指定名稱建立執行個體

如果工作負載或自動化調度管理系統需要特定執行個體名稱，您可以將這些執行個體新增至現有的 MIG。本節說明如何根據可用性新增執行個體。如果資源無法使用，則 MIG 會新增部分執行個體，並在資源可用時建立其餘執行個體。如要一次將具有特定名稱的 GPU 執行個體新增至 MIG，請參閱本文的「建立調整大小要求」一節。

如果 MIG 重新建立這些執行個體，您指派的名稱會保留下來。如要進一步瞭解如何保留 MIG 執行個體的狀態，請參閱有狀態的 MIG。

限制

如果您建立具有特定名稱的執行個體：

• 您必須在建立執行個體時關閉自動調度資源功能。
• 您必須將 MIG 的更新政策設為「投機」。
• 如要更新區域 MIG：
  • 您必須停用主動式執行個體重新分配功能。
  • 您無法選取要在哪個可用區建立 VM。
• 專案內不得使用重複的 VM 執行個體名稱。

您可以使用 gcloud CLI 或 REST，將特定名稱的 VM 新增至現有 MIG。

這項工作需要的權限

如要執行這項工作，您必須具備以下權限：

• 代管執行個體群組的 compute.instanceGroupManagers.update

gcloud

使用 instance-groups managed create-instance 指令。

gcloud compute instance-groups managed create-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--region REGION | --zone ZONE]

更改下列內容：

• INSTANCE_GROUP_NAME 是要新增執行個體的區域或區域 MIG 名稱。
• INSTANCE_NAME 是您要指派給新執行個體的名稱。

REST

對 regionInstanceGroupManagers.createInstances 方法發出 POST 要求。如果是區域代管執行個體群組，請使用 instanceGroupManagers.createInstances 方法。在要求主體中，包含 instances 欄位，並提供一或多個執行個體的名稱。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/createInstances
{
  "instances": [
    {
      "name": "INSTANCE_NAME_1"
    },
    {
      "name": "INSTANCE_NAME_2"
    }
  ]
}

從群組中刪除特定執行個體

您可以刪除代管執行個體群組中的個別 VM 執行個體。刪除執行個體會縮減執行個體群組的指定 targetSize，並且會將 VM 從所屬的任何目標集區移除。

從代管執行個體群組中刪除特定執行個體，並不會變更任何指定的自動配置器設定。如果您從代管執行個體群組刪除執行個體，自動配置器可能會偵測到群組中其他執行個體的工作負載增加，並將群組大小重新增加到先前的等級。為避免發生此問題，請先停止自動配置器，然後再嘗試刪除執行個體。

如果群組屬於後端服務的一部分，且該服務已啟用連線排除，在連線排除持續時間過後，最長可能需要等待 60 秒才能移除或刪除 VM 執行個體。

這項工作需要的權限

如要執行這項工作，您必須具備以下權限：

• 代管執行個體群組的 compute.instanceGroupManagers.update

主控台

1. 前往 Google Cloud 控制台的「Instance groups」(執行個體群組) 頁面。

   前往「Instance groups」(執行個體群組) 頁面

2. 在清單的「Name」(名稱) 欄底下，按一下個別待刪除執行個體所屬執行個體群組的名稱。按一下名稱會開啟頁面，其中包含執行個體群組的屬性及群組內執行個體的清單。

3. 在「成員」部分中，從執行個體清單選取一或多個要刪除的執行個體。

4. 按一下「Delete instance」(刪除執行個體)。即可刪除您所選取的執行個體。

gcloud

如要使用 gcloud CLI 刪除執行個體，請使用 instance-groups managed delete-instances 指令。

gcloud compute instance-groups managed delete-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \ 
    [--region REGION | --zone ZONE]

指令會傳回每個執行個體的作業狀態：

• 如果 gcloud CLI 刪除執行個體，則會傳回 SUCCESS。
• 如果要求中指定的任何執行個體不是群組成員、任何成員已遭刪除或捨棄，或要求因任何其他原因而失敗，系統會為所有執行個體傳回 FAIL。
• 只有在使用 --skip-instances-on-validation-error 旗標，且執行個體不是群組成員，或已遭刪除或捨棄時，才會傳回 SKIPPED。
• 如果 gcloud CLI 無法從執行個體名稱解析區域，則只會針對地區群組傳回 MEMBER_NOT_FOUND。

如果您預期刪除要求可能會與並行作業衝突，請使用 --skip-instances-on-validation-error 旗標。這個旗標會指定是否要繼續處理要求，即使要求包含的執行個體不是群組成員，或是已遭刪除或捨棄 (例如自動調度器刪除的執行個體)。根據預設，如果您省略這個標記，且要求中指定了這類執行個體，作業就會失敗。如果要求含有格式錯誤的執行個體名稱，或參照群組所在區域/地區以外的執行個體，作業一律會失敗。

舉例來說，下列指令要求刪除四個執行個體，但其中三個已不在群組中：

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1 \
    --skip-instances-on-validation-error

在本範例中，有三個執行個體未通過驗證，因此系統略過這些執行個體，並刪除 example-instance-3：

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE           INSTANCE               STATUS   VALIDATION_ERROR
example-project  us-central1-a  example-instance-1     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-1 that was already deleted.
example-project  us-central1-a  example-instance-2     SKIPPED  Cannot delete instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-2 that was already abandoned.
example-project  us-central1-a  example-instance-3     SUCCESS
example-project  us-central1-a  example-instance-4     SKIPPED  Cannot find instance https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-instance-4.

如果您省略 --skip-instances-on-validation-error 旗標，且有任何執行個體未通過驗證，系統就不會刪除任何執行個體：

gcloud compute instance-groups managed delete-instances example-mig \
    --instances=example-instance-1,example-instance-2,example-instance-3,example-instance-4 \
    --region=us-central1

Updated [https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceGroupManagers/example-mig].
PROJECT          ZONE             INSTANCE              STATUS
example-project  us-central1-a    example-instance-1    FAIL
example-project  us-central1-a    example-instance-2    FAIL
example-project  us-central1-a    example-instance-3    FAIL
example-project  us-central1-a    example-instance-4    FAIL

REST

對 regionInstanceGroupManagers.deleteInstances 方法發出 POST 要求。對於區域代管執行個體群組，請使用 instanceGroupManagers.deleteInstances 方法。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/deleteInstances

{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
   ]
}

如果您預期刪除要求可能會與並行作業衝突，請使用 skipInstancesOnValidationError 欄位。這個欄位會指定要求是否應繼續執行，即使要求包含的執行個體並非群組成員，或是已遭刪除或捨棄 (例如自動調度器正在刪除的執行個體)。根據預設，如果您省略這個標記，且要求中指定了這類執行個體，作業就會失敗。如果要求含有格式錯誤的執行個體名稱，或參照群組所在區域/地區以外的執行個體，作業一律會失敗。

舉例來說，即使其中一個執行個體已刪除或正在刪除，下列刪除 2 個執行個體的要求仍會成功：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/deleteInstances

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ],
 "skipInstancesOnValidationError": true
}

您可以查看作業，瞭解作業中略過的執行個體。如果是區域 MIG，請使用 regionOperations.get 方法。如果是區域 MIG，請使用 zoneOperations.get 方法。警告會列在作業的警告欄位中。

提出刪除代管執行個體群組中執行個體的要求之後，執行個體會在系統可以刪除時立即停止。此程序可能會花費大量時間，花費時間視您從群組中刪除的執行個體數而定。 驗證群組的狀態或驗證代管執行個體的狀態。

從 MIG 捨棄執行個體

您可以將 VM 執行個體與代管執行個體群組區分開，以更輕鬆地找出個別執行個體的問題，而不會影響整個群組。 從群組捨棄執行個體也會將執行個體從指派給代管執行個體群組的負載平衡器移除。 手動指派給特定個別執行個體的目標集區不會移除。

您無法將已捨棄的 VM 執行個體重新加入群組。 捨棄執行個體會減少執行個體群組的指定 targetSize，但不會變更任何指定的自動配置器設定。具有自動調度資源功能的代管執行個體群組，會視需要繼續自動新增或移除執行個體。如果區域 MIG 的自動調度資源模式設為 ONLY_SCALE_OUT，且您放棄 VM 執行個體，將 MIG 目標大小縮減為自動調度資源建議的大小，則自動調度資源可能會在放棄 VM 的相同區域中建立新的 VM 執行個體。在這種情況下，如要避免建立新的 VM 執行個體，請嘗試從其他區域捨棄 VM 執行個體。

如果群組屬於後端服務的一部分，且該服務已啟用連線排除，在連線排除持續時間過後，最長可能需要等待 60 秒才能移除或刪除 VM 執行個體。

這項工作需要的權限

如要執行這項工作，您必須具備以下權限：

• 代管執行個體群組的 compute.instanceGroupManagers.update

主控台

1. 前往 Google Cloud 控制台的「Instance groups」(執行個體群組) 頁面。

   前往「Instance groups」(執行個體群組) 頁面

2. 確認您要移除哪些執行個體，然後在清單的「Name」(名稱) 欄底下，按一下其所屬執行個體群組的名稱。按一下名稱會開啟頁面，其中包含執行個體群組的屬性及群組內執行個體的清單。

3. 在「成員」區段中，從執行個體清單中選取一或多個要從群組移除的執行個體。

4. 按一下 [Remove from group] (從群組中移除)。所選執行個體會退出群組，但仍會繼續在群組外執行。

gcloud

如要從執行個體群組中移除執行個體，「而不刪除 VM」，請使用 instance-groups managed abandon-instances 指令。

gcloud compute instance-groups managed abandon-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

REST

對 regionInstanceGroupManagers.abandonInstances 方法發出 POST 要求。對於區域代管執行個體群組，請使用 instanceGroupManagers.abandonInstances 方法。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/abandonInstances

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

提出從代管執行個體群組中捨棄執行個體的要求之後，群組會盡快移除執行個體。 驗證群組的狀態或驗證代管執行個體的狀態。

提高群組大小上限

根據預設，區域 MIG 的大小上限為 1,000 個 VM，區域 MIG 的大小上限則為 2,000 個 VM。您可以進一步提高這些限制，將可用區 MIG 的 VM 數量上限設為 2,000 個，區域 MIG 的 VM 數量上限則為 4,000 個。

如要提高限制，請將群組的 listManagedInstancesResults 欄位設為 PAGINATED。如果群組仍需要更多 VM，請建立多個 MIG 或與支援團隊聯絡。

注意： 將群組的 listManagedInstancesResults 欄位設為 PAGINATED 時，listManagedInstances 方法的行為會有所變更。使用預設的 PAGELESS 設定時，清單方法會忽略 maxResults 查詢參數，並一律傳回所有執行個體。使用 PAGINATED 設定時，清單方法會傳回分頁結果，且 maxResults 上限為 500，與 Compute Engine 中的其他清單相同。您必須確保對這些方法的所有呼叫都瞭解分頁，並使用 pageToken 查詢參數，逐頁瀏覽大量執行個體清單。

Google Cloud CLI 或 Google Cloud 控制台已完全支援分頁，因此不會受到影響。

主控台

1. 前往 Google Cloud 控制台的「Instance groups」(執行個體群組) 頁面。

   前往「Instance groups」(執行個體群組) 頁面

2. 在清單的「Name」(名稱) 欄底下，按一下要提高大小限制的執行個體群組名稱。

3. 按一下「編輯」修改執行個體群組。

4. 按一下「顯示進階設定」，展開進階設定部分。

5. 在「代管執行個體清單的 API 呼叫結果」下方，選取「分頁」選項。

6. 點選「儲存」來套用變更。

gcloud

如果是現有的 MIG，請使用 update 指令：

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --list-managed-instances-results=PAGINATED

如果是新的 MIG，請使用 create 指令：

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --list-managed-instances-results=PAGINATED

Terraform

如要提高 MIG 的大小上限，請將 list_managed_instances_results 引數設為 PAGINATED。

下列範例會提高區域 MIG 的大小限制。如要進一步瞭解範例中使用的資源，請參閱google_compute_instance_group_manager資源。如果是區域 MIG，請使用 google_compute_region_instance_group_manager 資源。

resource "google_compute_instance_group_manager" "default" {
  name                           = "my-igm"
  base_instance_name             = "test"
  target_size                    = 7
  zone                           = "us-central1-f"
  list_managed_instances_results = "PAGINATED"
  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
}

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

REST

如果是現有的區域 MIG，請使用 instanceGroupManagers.patch 方法；如果是區域 MIG，請使用 regionInstanceGroupManagers.patch 方法，例如：

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME

{
  "listManagedInstancesResults": "PAGINATED",
}

如果是新的區域 MIG，請使用 instanceGroupManagers.insert 方法；如果是區域 MIG，請使用 regionInstanceGroupManagers.insert 方法。

如要切換回無分頁清單結果，您也必須還原群組的預設大小限制。如要切換回預設大小，請先確認群組未超過預設大小限制，然後將 listManagedInstancesResults 欄位設為 PAGELESS。

後續步驟

• 瞭解如何使用代管型執行個體，例如刪除、捨棄及重新建立代管型執行個體。
• 查看代管執行個體群組和代管執行個體相關資訊。
• 排解代管執行個體群組問題。