プレイスメントグループの操作

AWS CLI を使用してプレイスメントグループを作成するには

create-placement-group コマンドを使用します。次の例では、cluster プレイスメント戦略を使用する、my-cluster という名前のプレイスメントグループを作成し、キー purpose と値 production を持つタグを適用します。

aws ec2 create-placement-group \
    --group-name my-cluster \
    --strategy cluster \
    --tag-specifications 'ResourceType=placement-group,Tags={Key=purpose,Value=production}'

AWS CLI を使用してパーティションプレイスメントグループを作成するには

create-placement-group コマンドを使用します。--strategy パラメータに値として partition を指定し、--partition-count パラメータに必要なパーティション数を指定します。この例では、パーティションプレイスメントグループは HDFS-Group-A という名で、パーティションは 5 つ作成されています。

aws ec2 create-placement-group \
    --group-name HDFS-Group-A \
    --strategy partition \
    --partition-count 5

AWS Tools for Windows PowerShell を使用してプレイスメントグループを作成するには

New-EC2PlacementGroup コマンドを使用します。

すべてのプレイスメントグループの説明を表示するには

describe-placement-groups AWS CLI コマンドを使用します。

aws ec2 describe-placement-groups

レスポンスの例

{
    "PlacementGroups": [
        {
            "GroupName": "my-cluster-pg",
            "State": "available",
            "Strategy": "cluster",
            "GroupId": "pg-0123456789example",
            "GroupArn": "arn:aws:ec2:eu-west-1:111111111111:placement-group/my-cluster-pg"
        },
            ...
     ]
}

特定のプレイスメントグループの説明を表示するには

describe-placement-groups AWS CLI コマンドを使用します。--group-id または --group-name パラメータを指定できます。

プレイスメントグループ ID を指定します。

aws ec2 describe-placement-groups --group-id pg-0123456789example

プレイスメントグループ名を指定します。

aws ec2 describe-placement-groups --group-name my-cluster-pg

レスポンスの例

{
    "PlacementGroups": [
        {
            "GroupName": "my-cluster-pg",
            "State": "available",
            "Strategy": "cluster",
            "GroupId": "pg-0123456789example",
            "GroupArn": "arn:aws:ec2:eu-west-1:111111111111:placement-group/my-cluster-pg"
        }
    ]
}

プレイスメントグループタグを表示するには

describe-tags コマンドを使用して、指定したリソースのタグを表示します。次の例では、すべてのプレイスメントグループのタグの説明を表示します。

aws ec2 describe-tags \
    --filters Name=resource-type,Values=placement-group			

{
    "Tags": [
        {
            "Key": "Environment",
            "ResourceId": "pg-0123456789EXAMPLE",
            "ResourceType": "placement-group",
            "Value": "Production"
        },
        {
            "Key": "Environment",
            "ResourceId": "pg-9876543210EXAMPLE",
            "ResourceType": "placement-group",
            "Value": "Production"
        }
    ]
}		

describe-tags コマンドを使用し、ID を指定してプレイスメントグループのタグを表示することもできます。次の例では、pg-0123456789EXAMPLE のタグの説明を表示します。

aws ec2 describe-tags \

    --filters Name=resource-id,Values=pg-0123456789EXAMPLE

{
    "Tags": [
        {
            "Key": "Environment",
            "ResourceId": "pg-0123456789EXAMPLE",
            "ResourceType": "placement-group",
            "Value": "Production"
        }
    ]
}

プレイスメントグループの説明を表示して、プレイスメントグループのタグを表示することもできます。

describe-placement-groups コマンドを使用して、指定したプレイスメントグループの設定を表示します。この設定には、プレイスメントグループに指定されたタグがすべて含まれます。

aws ec2 describe-placement-groups \
    --group-name my-cluster

{
    "PlacementGroups": [
        {
            "GroupName": "my-cluster",
            "State": "available",
            "Strategy": "cluster",
            "GroupId": "pg-0123456789EXAMPLE",
            "Tags": [
                {
                    "Key": "Environment",
                    "Value": "Production"
                }
            ]
        }
    ]
}			

AWS CLI を使用して既存のプレイスメントグループにタグを付けるには

create-tags コマンドを使用して、既存のリソースにタグ付けできます。次の例では、既存のプレイスメントグループに Key=Cost-Center と Value=CC-123 のタグが付けられています。

aws ec2 create-tags \
    --resources pg-0123456789EXAMPLE \
    --tags Key=Cost-Center,Value=CC-123

AWS CLI を使用してタグをプレイスメントグループから削除するには

delete-tags コマンドを使用して、既存のリソースからタグを削除できます。例については、AWS CLI コマンドリファレンスの例を参照してください。

プレイスメントグループタグを表示するには

Get-EC2Tag コマンドを使用します。

特定のプレイスメントグループのタグの説明を表示するには

Get-EC2PlacementGroup コマンドを使用します。

既存のプレイスメントグループ名にタグを付けるには

New-EC2Tag コマンドを使用します。

プレイスメントグループからタグを削除するには

Remove-EC2Tag コマンドを使用します。

プレイスメントグループ内でインスタンスを起動するには

run-instances コマンドを使用し、--placement "GroupName = my-cluster" パラメータを使用してプレイスメントグループ名を指定します。次の例で、プレイスメントグループ名は my-cluster です。

aws ec2 run-instances --placement "GroupName = my-cluster"

AWS CLI を使用してパーティションプレイスメントグループの特定のパーティション内でインスタンスを起動するには

run-instances コマンドを使用して、--placement "GroupName = HDFS-Group-A, PartitionNumber = 3" パラメータを使用するグループプレイスメントグループ名とパーティションを指定します。この例では、パーティションプレイスメントグループは HDFS-Group-A という名で、パーティション数は 3 です。

aws ec2 run-instances --placement "GroupName = HDFS-Group-A, PartitionNumber = 3"

AWS Tools for Windows PowerShell を使用してプレイスメントグループ内でインスタンスを起動するには

New-EC2Instance コマンドを使用し、-Placement_GroupName パラメータを使用してプレイスメントグループ名を指定します。

パーティションプレイスメントグループのインスタンスのパーティション番号を表示するには

describe-instancesコマンドを使用して --instance-id パラメータを指定します。

aws ec2 describe-instances --instance-id i-0123a456700123456

レスポンスにはプレイスメント情報が含まれています。この情報にはインスタンスのプレイスメントグループ名とパーティション番号が含まれます。

"Placement": {
     "AvailabilityZone": "us-east-1c",
     "GroupName": "HDFS-Group-A",
     "PartitionNumber": 3,
     "Tenancy": "default"
}

特定のパーティションプレイスメントグループとパーティション番号のインスタンスにフィルターを適用するには

describe-instances コマンドを使用して、--filters および placement-group-name フィルターを持つ placement-partition-number パラメータを指定します。この例では、パーティションプレイスメントグループは HDFS-Group-A という名で、パーティション数は 7 です。

aws ec2 describe-instances --filters "Name = placement-group-name, Values = HDFS-Group-A" "Name = placement-partition-number, Values = 7"

レスポンスは、指定されたプレイスメントグループ内の指定されたパーティション内にあるすべてのインスタンスをリストします。次の出力例は、返されたインスタンスのインスタンス ID、インスタンスタイプ、および配置情報のみを示しています。

"Instances": [
                {   
                    "InstanceId": "i-0a1bc23d4567e8f90",
                    "InstanceType": "r4.large",
                    },
                  
                    "Placement": {
                        "AvailabilityZone": "us-east-1c",
                        "GroupName": "HDFS-Group-A",
                        "PartitionNumber": 7,
                        "Tenancy": "default"
                    }

                {   
                    "InstanceId": "i-0a9b876cd5d4ef321",
                    "InstanceType": "r4.large",
                    },

                    "Placement": {
                        "AvailabilityZone": "us-east-1c",
                        "GroupName": "HDFS-Group-A",
                        "PartitionNumber": 7,
                        "Tenancy": "default"
                    }
              ],      

プレイスメントグループを削除するには

delete-placement-group コマンドを使用し、削除するプレイスメントグループの名前を指定します。次の例で、プレイスメントグループ名は my-cluster です。

aws ec2 delete-placement-group --group-name my-cluster

AWS Tools for Windows PowerShell を使用してプレイスメントグループを削除するには

Remove-EC2PlacementGroup コマンドを使用してプレイスメントグループを削除します。