配置グループの管理

コンソールで配置グループを管理する

IBM Cloud VPC コンソールを使用して、IBM Cloud の配置グループを管理することができます。

配置グループに対する管理タスクを実行するには、以下の手順を実行します。

1. IBM Cloud コンソールで、ナビゲーション・メニュー・アイコン ** インフラストラクチャ コンピュート > プレースメント・グループ に進みます。
2. 「VPC の配置グループ」ページで、管理する配置の「アクション」アイコン をクリックします。 以下のアクションから 選択できます。

配置グループを作成する前に、VPC が存在している必要があります。 先に VPC が作成されていなければ、配置グループの作成時にエラーが返され、配置グループは作成されません。

コンソールで配置グループを作成する

IBM Cloud VPC コンソールを使用して、IBM Cloud に配置グループを作成できます。 インスタンスで配置グループを使用するためには、先に配置グループを作成しておく必要があります。 配置グループを作成したら、インスタンスのプロビジョニング時に、その配置グループにインスタンスを関連付けることができます。

以下の手順を使用して、配置グループを作成します。

1. IBM Cloud コンソールで、ナビゲーション・メニュー・アイコン ** インフラストラクチャ コンピュート > プレースメント・グループ に進みます。
2. **「作成」**をクリックし、「VPC の新規配置 (New placement for VPC)」ページで、表 1 の情報を入力します。

CLIから配置グループを作成する

インスタンスで配置グループを使用するためには、先に配置グループを作成しておく必要があります。 配置グループを作成したら、インスタンスのプロビジョニング時に、その配置グループにインスタンスを関連付けることができます。

CLIから配置グループを作成する

コマンド・ライン・インターフェース (CLI) を使用して、IBM Cloud VPC に配置グループを作成できます。

CLI を使用して配置グループを作成するには、ibmcloud is placement-group-create コマンドを使用します。 配置グループの配置グループ戦略、配置グループの名前、リソース・グループ ID、リソース・グループの名前を指定します。

次の例では、ホスト分散戦略を使用する配置グループを、名前 MyPlacementGroup、リソース・グループ ID RESOURCE_GROUP_ID、リソース・グループ名 RESOURCE_GROUP_NAME を指定して作成しています。

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

API を使用した配置グループの作成

API を使用して、IBM Cloud VPC に配置グループを作成できます。

インスタンスで配置グループを使用するためには、先に配置グループを作成しておく必要があります。 配置グループを作成したら、インスタンスのプロビジョニング時に、その配置グループにインスタンスを関連付けることができます。

次の例では、ホスト分散の配置グループ戦略を使用する配置グループを作成しています。

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

host_spread および power_spread strategy 変数の詳細については、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 VPC コンソールを使用して、IBM Cloud の配置グループの名前を更新できます。

配置グループの名前を変更するには、以下のようにします。

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: $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
}

UI を使用した配置グループの削除

IBM Cloud VPC コンソールを使用して、IBM Cloud の配置グループを削除できます。 インスタンスが接続されている配置グループを削除することはできません。 先にすべてのインスタンスを削除する必要があります。 仮想プライベート・クラウドのインスタンスおよび関連付けられているリソースの削除方法について詳しくは、VPC の削除を参照してください。

以下の手順を使用して、配置グループを削除します。

1. IBM Cloud コンソールで、ナビゲーション・メニュー・アイコン ** インフラストラクチャ コンピュート > プレースメント・グループ に進みます。
2. 配置グループを選択して、**「削除」**をクリックします。
3. 確認メッセージが表示されます。 **「削除」**をクリックします。

CLI を使用した配置グループの削除

コマンド・ライン・インターフェース (CLI) を使用して、IBM Cloud VPC の配置グループを削除できます。 インスタンスが接続されている配置グループを削除することはできません。 先にすべてのインスタンスを削除する必要があります。 仮想プライベート・クラウドのインスタンスおよび関連付けられているリソースの削除方法について詳しくは、VPC の削除を参照してください。

CLI を使用して配置グループを削除するには、ibmcloud is placement-group-delete コマンドを使用します。 配置グループ 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: $iam_token"

Terraform を使用した配置グループの削除

Terraform を使用して、IBM Cloud VPC の配置グループを削除できます。 インスタンスが接続されている配置グループを削除することはできません。 先にすべてのインスタンスを削除する必要があります。 仮想プライベート・クラウドのインスタンスおよび関連付けられているリソースの削除方法について詳しくは、VPC の削除を参照してください。

次の例では、PLACEMENT_GROUP という名前の配置グループを削除しています。

terraform destroy -target=ibm_is_placement_group.is_placement_group

UI を使用したすべての配置グループのリスト表示

リージョンの配置グループのリストを生成できます。

既存のすべての配置グループのリストを表示するには、以下のようにします。

1. IBM Cloud コンソールで、ナビゲーション・メニュー・アイコン ** インフラストラクチャ コンピュート > プレースメント・グループ に進みます。
2. 既存の配置グループがすべて表示されます。

CLI を使用したすべての配置グループのリスト表示

リージョンの配置グループのリストを生成できます。 コマンドラインインターフェイス（CLI）を使用して、 IBM Cloud VPC の既存のすべての配置グループを一覧表示できます。

CLI を使用して既存のすべての配置グループをリストするには、ibmcloud is placement-groups コマンドを使用します。 配置グループをリストするリソース・グループの名前と ID を指定します。

次の例では、リソース・グループの ID RESOURCE_GROUP_ID と名前 RESOURCE_GROUP に対応する既存のすべての配置グループをリストします。

ibmcloud is placement-groups --resource-group-id RESOURCE_GROUP_ID --resource-group-name RESOURCE_GROUP_NAME --all-resource-groups --output JSON

API を使用したすべての配置グループのリスト表示

リージョンの配置グループのリストを生成できます。 次の例では、すべての配置グループのリストを生成しています。

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

Terraform を使用したすべての配置グループのリスト表示

リージョンの配置グループのリストを生成できます。 Terraform を使用して、IBM Cloud VPC 内の既存のすべての配置グループをリストすることができます。

次の例では、既存のすべての配置グループをリストします。

data "ibm_is_placement_groups" "is_placement_groups" {
}

UI を使用した配置グループの詳細の表示

配置グループ名、割り当てられたリソースグループ、配置グループID、場所、配置グループが作成された日付、指定された配置グループ戦略など、配置グループの詳細を表示できます。

配置グループに関する詳細を表示するには、以下のステップを実行します。

1. IBM Cloud コンソールで、ナビゲーション・メニュー・アイコン ** インフラストラクチャ コンピュート > プレースメント・グループ に進みます。
2. 詳細を表示する配置グループの名前をクリックします。

CLI を使用した配置グループの詳細の表示

配置グループ名、割り当てられたリソースグループ、配置グループID、場所、配置グループが作成された日付、指定された配置グループ戦略など、配置グループの詳細を表示できます。

コマンドラインインターフェイス（CLI）を使用して、 IBM Cloud VPC の配置グループの詳細を取得できます。

CLI を使用して配置グループの詳細を取得するには、ibmcloud is placement-group コマンドを使用します。 配置グループ ID を指定します。

次の例では、PLACEMENT_GROUP という名前の配置グループの詳細を取得しています。

ibmcloud is placement-group PLACEMENT_GROUP --output JSON

API を使用した配置グループの詳細の表示

配置グループ名、割り当てられたリソースグループ、配置グループID、場所、配置グループが作成された日付、指定された配置グループ戦略など、配置グループの詳細を表示できます。

次の例では、URL 内に ID で指定した単一の配置グループを取得しています。

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

Terraform を使用した配置グループの詳細の表示

配置グループ名、割り当てられたリソースグループ、配置グループID、場所、配置グループが作成された日付、指定された配置グループ戦略など、配置グループの詳細を表示できます。

IBM Cloud VPC、Terraformを使って配置グループの詳細を取得することができます。

次の例では、ibm_is_placement_group.is_placement_group.name という ID の単一の配置グループの詳細を取得します。

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