在主控台中管理放置群組

您可以使用 IBM Cloud 主控台來管理 IBM Cloud VPC 中的放置群組。

若要在放置群組上完成管理作業，請完成下列步驟。

1. 在 IBM Cloud 控制台中，請前往 **導覽選單圖示 > 基礎架構 > 運算 > 配置群組。
2. 在 VPC 的放置群組頁面上，針對您要管理的放置按一下「動作」圖示 。 您可以從以下操作中進行選擇：

在建立放置群組之前，VPC 必須存在。 如果未先建立 VPC，則會在建立放置群組時收到錯誤，且不會建立放置群組。

在主控台中建立放置群組

您可以使用 IBM Cloud 主控台，在 IBM Cloud VPC 中建立放置群組。 必須先建立放置群組，然後實例才能使用它。 建立放置群組之後，可以在佈建期間將實例連接至該放置群組。

請依照以下步驟建立投放群組：

1. 在 IBM Cloud 控制台中，請前往 **導覽選單圖示 > 基礎架構 > 運算 > 配置群組。
2. 按一下 建立，然後在「新建 VPC 的放置」頁面上的表 1 中輸入資訊。

從 CLI 建立放置群組

必須先建立放置群組，然後實例才能使用它。 建立放置群組之後，可以在佈建期間將實例連接至該放置群組。

從 CLI 建立放置群組

您可以使用指令行介面 (CLI) 在 IBM Cloud VPC 中建立放置群組。

若要使用 CLI 來建立放置群組，請使用 ibmcloud is placement-group-create 指令。 指定放置群組的放置群組策略、放置群組的名稱，以及資源群組 ID 或名稱。

以下範例以主機擴展策略建立一個放置群組，名稱為 MyPlacementGroup，資源群組 ID 為 RESOURCE_GROUP_ID。

ibmcloud is placement-group-create --strategy host_spread --name MyPlacementGroup --resource-group-id RESOURCE_GROUP_ID

使用 API 建立放置群組

您可以使用 API 在 IBM Cloud VPC 中建立放置群組。

必須先建立放置群組，然後實例才能使用它。 建立放置群組之後，可以在佈建期間將實例連接至該放置群組。

下列範例會建立使用主機分散放置群組策略的放置群組。

curl -X POST "$vpc_api_endpoint/v1/placement_groups?version=2021-04-20&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-placement-group"
      "strategy": "host_spread"
    }'

如需 host_spread 和 power_spread 策略變數的相關資訊，請參閱 Virtual Private Cloud API 文件中的 建立放置群組。

使用 Terraform 建立放置群組

您可以使用 Terraform 在 IBM Cloud VPC 中建立放置群組。

必須先建立放置群組，然後實例才能使用它。 建立放置群組之後，可以在佈建期間將實例連接至該放置群組。

resource "ibm_is_placement_group" "is_placement_group" {
  strategy = "host_spread"
  name = "my-placement-group"
  resource_group = data.ibm_resource_group.default.id
}

在主控台中變更放置群組名稱

您可以使用 IBM Cloud 主控台來更新 IBM Cloud VPC 中放置群組的名稱。

若要重新命名放置群組，請執行下列動作:

1. 在 IBM Cloud 控制台中，請前往 **導覽選單圖示 > 基礎架構 > 運算 > 配置群組。
2. 選取放置群組，然後按一下 重新命名。
3. 變更放置群組名稱。

從 CLI 變更放置群組名稱

您可以使用指令行介面 (CLI) 來更新 IBM Cloud VPC 中放置群組的名稱。

若要使用 CLI 來更新放置群組名稱，請使用 ibmcloud is placement-group-update 指令。 指定安置群組 ID 或名稱以及安置群組的新名稱。

下列範例會將 ID 為 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 的放置群組更新為 new-name 名稱。

ibmcloud is placement-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name NEW_NAME

使用 API 變更放置群組名稱

您可以使用 API 來更新 IBM Cloud VPC 中放置群組的名稱。 下列範例會以新名稱 my-updated=placement-group 來更新放置群組名稱。

curl -X PATCH "$vpc_api_endpoint/v1/placement_groups/$id?version=2021-05-04&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-updated-placement-group",
    }'

使用 Terraform 變更放置群組名稱

您可以使用 Terraform 來更新 IBM Cloud VPC 中放置群組的名稱。

下列範例會將 ID 為 is_placement_group 的放置群組更新為 my-placement-group-modified 名稱。

resource "ibm_is_placement_group" "is_placement_group" {
  strategy = "host_spread"
  name = "my-placement-group-modified"
  resource_group = data.ibm_resource_group.default.id
}

使用使用者介面刪除放置群組

您可以使用 IBM Cloud 主控台來刪除 IBM Cloud VPC 中的放置群組。 如果將實例連接至放置群組，則無法刪除該放置群組。 必須先移除所有實例。 如需刪除虛擬專用雲端實例及其相關聯資源的相關資訊，請參閱 刪除 VPC。

請依照以下步驟刪除投放群組：

1. 在 IBM Cloud 控制台中，請前往 **導覽選單圖示 > 基礎架構 > 運算 > 配置群組。
2. 選取該投放群組，然後按一下「刪除」。
3. 即會顯示一則確認訊息。 按一下刪除。

使用 CLI 刪除放置群組

您可以使用指令行介面 (CLI) 來刪除 IBM Cloud VPC 中的放置群組。 如果將實例連接至放置群組，則無法刪除該放置群組。 必須先移除所有實例。 如需刪除虛擬專用雲端實例及其相關聯資源的相關資訊，請參閱 刪除 VPC。

若要使用 CLI 來刪除放置群組，請使用 ibmcloud is placement-group-delete 指令。 指定安置群組 ID 或名稱。

以下範例會刪除 ID 或名稱為 PLACEMENT_GROUP 的放置群組。

ibmcloud is placement-group-delete PLACEMENT_GROUP --output JSON

使用 API 刪除放置群組

如果將實例連接至放置群組，則無法刪除該放置群組。 必須先移除所有實例。 如需刪除虛擬專用雲端實例及其相關聯資源的相關資訊，請參閱 刪除 VPC。

下列範例會刪除放置群組。

curl -X DELETE "$vpc_api_endpoint/v1/placement_groups/$id?version=2021-04-20&generation=2" -H "Authorization: Bearer $iam_token"

使用 Terraform 刪除放置群組

您可以使用 Terraform 來刪除 IBM Cloud VPC 中的放置群組。 如果將實例連接至放置群組，則無法刪除該放置群組。 必須先移除所有實例。 如需刪除虛擬專用雲端實例及其相關聯資源的相關資訊，請參閱 刪除 VPC。

下列範例會刪除名為 PLACEMENT_GROUP 的放置群組。

terraform destroy -target=ibm_is_placement_group.is_placement_group

使用使用者介面列出所有放置群組

您可以產生區域的放置群組清單。

若要顯示所有現有放置群組的清單，請執行下列動作:

1. 在 IBM Cloud 控制台中，請前往 **導覽選單圖示 > 基礎架構 > 運算 > 配置群組。
2. 即會顯示所有現有的放置群組。

使用 CLI 列出所有放置群組

您可以產生區域的放置群組清單。 您可以使用指令行介面 (CLI) 來列出 IBM Cloud VPC 中的所有現有放置群組。

若要使用 CLI 列出所有現有放置群組，請使用 ibmcloud is placement-groups 指令。

下列範例列出所有現有的放置群組。

ibmcloud is placement-groups --output JSON

使用 API 列出所有放置群組

您可以產生區域的放置群組清單。 下列範例會產生所有放置群組的清單。

curl -X GET "$vpc_api_endpoint/v1/placement_groups?version=2021-04-20&generation=2" -H "Authorization: Bearer $iam_token"

使用 Terraform 列出所有放置群組

您可以產生區域的放置群組清單。 您可以使用 Terraform 來列出 IBM Cloud VPC 中的所有現有放置群組。

下列範例列出所有現有的放置群組。

data "ibm_is_placement_groups" "is_placement_groups" {
}

使用使用者介面檢視放置群組詳細資料

您可以檢視放置群組的詳細資料，例如放置群組名稱、指派的資源群組、放置群組 ID、位置、建立放置群組的日期，以及指定的放置群組策略。

若要檢視放置群組的詳細資料，請完成下列步驟。

1. 在 IBM Cloud 控制台中，請前往 **導覽選單圖示 > 基礎架構 > 運算 > 配置群組。
2. 按一下您要檢視其詳細資料的放置群組名稱。

使用 CLI 檢視放置群組詳細資料

您可以檢視放置群組的詳細資料，例如放置群組名稱、指派的資源群組、放置群組 ID、位置、建立放置群組的日期，以及指定的放置群組策略。

您可以使用指令行介面 (CLI) 來擷取 IBM Cloud VPC 中放置群組的詳細資料。

若要使用 CLI 擷取放置群組的詳細資料，請使用 ibmcloud is placement-group 指令。 指定安置群組 ID 或名稱。

以下範例擷取 ID 或名稱為 PLACEMENT_GROUP 的安置群組的詳細資訊。

ibmcloud is placement-group PLACEMENT_GROUP --output JSON

使用 API 檢視放置群組詳細資料

您可以檢視放置群組的詳細資料，例如放置群組名稱、指派的資源群組、放置群組 ID、位置、建立放置群組的日期，以及指定的放置群組策略。

以下範例擷取由 URL 中的識別碼指定的單一放置群組。

curl -X GET "$vpc_api_endpoint/v1/placement_groups/$id?version=2021-04-20&generation=2" -H "Authorization: Bearer $iam_token"

使用 Terraform 檢視放置群組詳細資料

您可以檢視放置群組的詳細資料，例如放置群組名稱、指派的資源群組、放置群組 ID、位置、建立放置群組的日期，以及指定的放置群組策略。

您可以使用 Terraform 來擷取 IBM Cloud VPC 中放置群組的詳細資料。

下列範例會擷取 ID 為 ibm_is_placement_group.is_placement_group.name 之單一放置群組的詳細資料。

data "ibm_is_placement_group" "d_is_placement_group" {
  name = ibm_is_placement_group.is_placement_group.name
}