Amazon EC2 インスタンストポロジーの例 - Amazon Elastic Compute Cloud
例 1 - パラメータもフィルターもない例 2 — instance-type フィルター例 3 — zone-id フィルター例 4 — instance-type フィルターと zone-id フィルターの組み合わせ例 5 — プレイスメントグループ名パラメーター例6 — インスタンス ID

Amazon EC2 インスタンストポロジーの例

describe-instance-topology CLI コマンドを使用して、EC2 インスタンスのインスタンストポロジーを表示できます。

パラメータやフィルターなしで describe-instance-topology コマンドを使用すると、指定したリージョン内のこのコマンドで利用可能なインスタンスタイプに一致する、すべてのインスタンスが応答に含まれます。リージョンを設定するには、--region パラメータを含めるかデフォルトのリージョンを設定できます。デフォルトのリージョンの設定についての詳細は、「リソースのリージョンの指定」を参照してください。

指定したインスタンス ID またはプレイスメントグループ名と一致するインスタンスを返すパラメータを含めることができます。また、指定したインスタンスタイプやインスタンスファミリーに一致するインスタンス、または指定したアベイラビリティーゾーンやローカルゾーン内のインスタンスを返すフィルターを含めることもできます。1 つのパラメータまたはフィルター、もしくはパラメータとフィルターの組み合わせを含めることができます。

出力はページ分割されます。デフォルトでは、1 ページあたり最大 20 インスタンスです。--max-results パラメータを使用すると、1 ページあたり最大 100 インスタンスまで指定できます。

詳細については、AWS CLI コマンドリファレンスの「describe-instance-topology」を参照してください。

必要なアクセス許可

インスタンストポロジーを表示するには、次のアクセス許可が必要です。

  • ec2:DescribeInstanceTopology

例 1 - パラメータもフィルターもない

すべてのインスタンスのインスタンストポロジーを記述するには

パラメータやフィルターを指定せずに、describe-instance-topology CLI コマンドを使用します。

aws ec2 describe-instance-topology --region us-west-2

レスポンスは、この API でサポートされているインスタンスタイプと一致するインスタンスのみを返します。インスタンスは、異なるアベイラビリティーゾーン、ローカルゾーン (ZoneId)、およびプレイスメントグループ (GroupName) に配置できます。インスタンスがプレイスメントグループ内にない場合、GroupName フィールドは出力に表示されません。この出力例では、プレイスメントグループ内には 1 つのインスタンスのみが存在します。

出力例

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "my-ml-cpg",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "p4d.24xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-3333333333example",
            "InstanceType": "trn1.32xlarge",
            "NetworkNodes": [
                "nn-1212121212example",
                "nn-1211122211example",
                "nn-1311133311example"
            ],
            "ZoneId": "usw2-az4",
            "AvailabilityZone": "us-west-2d"            
        },
        {
            "InstanceId": "i-444444444example",
            "InstanceType": "trn1.2xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-5434334334example",
                "nn-1235301234example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"          
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

例 2 — instance-type フィルター

指定したインスタンスタイプ (完全一致)、またはインスタンスファミリーでフィルタリング (ワイルドカードを使用) できます。指定したインスタンスタイプフィルターとインスタンスファミリーのフィルターを組み合わせることもできます。

例 2a — 指定したインスタンスタイプの完全一致フィルター

指定したインスタンスタイプに一致するすべてのインスタンスのインスタンストポロジーを記述するには

instance-type フィルターとともに describe-instance-topology CLI コマンドを使用します。この例では、出力は trn1n.32xlarge インスタンスに対してフィルタリングされます。レスポンスは、指定したインスタンスタイプと一致するインスタンスのみを返します。

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --filters Name=instance-type,Values=trn1n.32xlarge

出力例

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

例 2b — インスタンスファミリーのワイルドカードフィルター

インスタンスファミリーに一致するすべてのインスタンスのインスタンストポロジーを記述するには

instance-type フィルターとともに describe-instance-topology CLI コマンドを使用します。この例では、出力は trn1* インスタンスに対してフィルタリングされます。レスポンスは、指定したインスタンスファミリーに一致するインスタンスのみを返します。

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --filters Name=instance-type,Values=trn1*

出力例

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-3333333333example",
            "InstanceType": "trn1.32xlarge",
            "NetworkNodes": [
                "nn-1212121212example",
                "nn-1211122211example",
                "nn-1311133311example"
            ],
            "ZoneId": "usw2-az4",
            "AvailabilityZone": "us-west-2d"            
        },
        {
            "InstanceId": "i-444444444example",
            "InstanceType": "trn1.2xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-5434334334example",
                "nn-1235301234example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"          
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

例 2c — インスタンスファミリーと完全一致フィルターの組み合わせ

インスタンスファミリーまたは指定したインスタンスタイプに一致するすべてのインスタンスのインスタンストポロジーを記述するには

instance-type フィルターとともに describe-instance-topology CLI コマンドを使用します。この例では、出力は pd4d* または trn1n.32xlarge インスタンスに対してフィルタリングされます。レスポンスは、指定したフィルターのいずれかに一致するインスタンスを返します。

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --filters "Name=instance-type,Values=p4d*,trn1n.32xlarge"

出力例

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-4343434343example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

例 3 — zone-id フィルター

zone-id フィルターを使用して、アベイラビリティーゾーンまたはローカルゾーンでフィルタリングできます。アベイラビリティーゾーンフィルターとローカルゾーンフィルターを組み合わせることもできます。

例 3a — アベイラビリティーゾーンフィルター

指定したアベイラビリティーゾーンに一致するすべてのインスタンスのインスタンストポロジーを記述するには

zone-id フィルターとともに describe-instance-topology CLI コマンドを使用します。この例では、出力はアベイラビリティーゾーン ID use1-az1 でフィルタリングされます。レスポンスは、指定したアベイラビリティーゾーンに一致するインスタンスのみを返します。

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters Name=zone-id,Values=use1-az1

出力例

{
    "Instances": [
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

例 3b — ローカルゾーンフィルター

指定したローカルゾーンに一致するすべてのインスタンスのインスタンストポロジーを記述するには

zone-id フィルターとともに describe-instance-topology CLI コマンドを使用します。この例では、出力はローカルゾーン ID use1-atl2-az1 でフィルタリングされます。レスポンスは、指定したローカルゾーンに一致するインスタンスのみを返します。

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters Name=zone-id,Values=use1-atl2-az1

出力例

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "use1-atl2-az1",
            "AvailabilityZone": "us-east-1-atl-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

例 3c — アベイラビリティーゾーンフィルターとローカルゾーンフィルターの組み合わせ

指定したアベイラビリティーゾーンまたはローカルゾーンに一致するすべてのインスタンスのインスタンストポロジーを記述するには

zone-id フィルターとともに describe-instance-topology CLI コマンドを使用します。この例では、出力はアベイラビリティーゾーン ID use1-az1 およびローカルゾーン ID use1-atl2-az1 でフィルタリングされます。レスポンスは、指定したフィルターのいずれかに一致するインスタンスを返します。

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters Name=zone-id,Values=use1-az1,use1-atl2-az1

出力例

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "use1-atl2-az1",
            "AvailabilityZone": "us-east-1-atl-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

例 4 — instance-type フィルターと zone-id フィルターの組み合わせ

1 つのコマンドですべてのフィルターを組み合わせることができます。

指定したインスタンスタイプ、インスタンスファミリー、アベイラビリティーゾーンまたはローカルゾーンに一致するすべてのインスタンスのインスタンストポロジーを記述するには

instance-type および zone-id フィルターとともに describe-instance-topology CLI コマンドを使用します。この例では、出力はインスタンスファミリー p4d*、インスタンスタイプ trn1n.32xlarge、アベイラビリティーゾーン ID use1-az1 およびローカルゾーン ID use1-atl2-az1 に対してフィルタリングされます。レスポンスは、us-east-1a または us-east-1-atl-2a ゾーン内の p4d* または trn1n.32xlarge インスタンスに一致するインスタンスを返します。

aws ec2 describe-instance-topology \
    --region us-east-1 \
    --filters "Name=instance-type,Values=p4d*,trn1n.32xlarge" "Name=zone-id,Values=use1-az1,use1-atl2-az1"

出力例

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "use1-atl2-az1",
            "AvailabilityZone": "us-east-1-atl-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

例 5 — プレイスメントグループ名パラメーター

指定したプレイスメントグループ内のすべてのインスタンスのインスタンストポロジーを記述するには

group-names パラメータとともに describe-instance-topology CLI コマンドを使用します。次の例では、インスタンスは ML-group または HPC-group プレイスメントグループに属すことができます。レスポンスは、いずれかのプレイスメントグループに属するインスタンスを返します。

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --group-names ML-group HPC-group

出力例

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "GroupName": "HPC-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

例6 — インスタンス ID

指定したインスタンスのインスタンストポロジーを記述するには

--instance-ids パラメータとともに describe-instance-topology CLI コマンドを使用します。レスポンスは、指定したインスタンス ID と一致するインスタンスを返します。

aws ec2 describe-instance-topology \
    --region us-west-2 \
    --instance-ids i-1111111111example i-2222222222example

出力例

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "ML-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "GroupName": "HPC-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}