Amazon EC2 인스턴스 토폴로지의 예제 - Amazon Elastic Compute Cloud
예 1: DescribeInstanceTopology - 인스턴스 ID예 2: DescribeInstanceTopology - 배치 그룹 이름 파라미터예 3: DescribeInstanceTopology - 인스턴스 유형 필터예 4: DescribeInstanceTopology - 영역 ID 필터예 5: DescribeInstanceTopology - 인스턴스 유형 및 영역 ID 필터예 6: DescribeCapacityReservationTopology - 용량 예약 ID예 7: DescribeCapacityReservationTopology - 인스턴스 유형 필터

Amazon EC2 인스턴스 토폴로지의 예제

describe-instance-topology 명령을 사용하여 EC2 인스턴스의 토폴로지를 설명할 수 있습니다. 또한 describe-capacity-reservation-topology 명령을 사용하여 용량 예약의 토폴로지를 설명할 수 있습니다.

파라미터나 필터 없이 describe-instance-topology 또는 describe-capacity-reservation-topology 명령을 사용하면 지정된 리전에서 이 명령에 지원되는 인스턴스 유형과 일치하는 모든 인스턴스 또는 용량 예약(사용한 명령에 따라 다름)이 응답에 포함됩니다. --region 파라미터를 포함하거나 기본 리전을 설정하여 리전을 지정할 수 있습니다. 기본 리전 설정에 대한 자세한 내용은 Amazon EC2 리소스에 대한 리전 선택 섹션을 참조하세요.

지정된 인스턴스나 용량 예약 ID 또는 배치 그룹 이름과 일치하는 인스턴스나 용량 예약을 반환하는 파라미터를 포함할 수 있습니다. 지정된 인스턴스 유형이나 인스턴스 패밀리와 일치하는 인스턴스나 용량 예약 또는 지정된 가용 영역 또는 로컬 영역의 인스턴스나 용량 예약을 반환하는 필터를 포함할 수도 있습니다. 단일 파라미터 또는 필터나 파라미터와 필터 조합을 포함할 수 있습니다.

출력은 기본적으로 페이지당 최대 20개의 인스턴스 또는 용량 예약으로 페이지가 매겨집니다. --max-results 파라미터를 사용하여 페이지당 최대 100개의 인스턴스 또는 용량 예약을 지정할 수 있습니다.

자세한 내용은 describe-instance-topology 및 describe-reservation-topology-topology을(를) 참조하세요.

필수 권한

다음 권한이 필요합니다.

  • ec2:DescribeInstanceTopology - 인스턴스 토폴로지 설명

  • ec2:DescribeCapacityReservationTopology - 용량 예약 토폴로지 설명

예제 1: DescribeInstanceTopology - 인스턴스 ID

AWS CLI
특정 인스턴스의 토폴로지를 설명하려면

--instance-ids 파라미터와 함께 describe-instance-topology 명령을 사용합니다. 출력에는 지정된 인스턴스 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"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "GroupName": "HPC-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 인스턴스의 토폴로지를 설명하려면

Get-EC2InstanceTopology cmdlet을 사용합니다.

Get-EC2InstanceTopology `
    -InstanceId i-1111111111example, i-2222222222example

예제 2: DescribeInstanceTopology - 배치 그룹 이름 파라미터

AWS CLI
지정된 배치 그룹에 포함된 인스턴스의 토폴로지를 설명하려면

group-names 파라미터와 함께 describe-instance-topology 명령을 사용합니다. 출력에는 지정된 배치 그룹 중 하나에 있는 인스턴스만 포함됩니다.

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"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "GroupName": "HPC-group",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
지정된 배치 그룹에 포함된 인스턴스의 토폴로지를 설명하려면

Get-EC2InstanceTopology cmdlet을 사용합니다.

Get-EC2InstanceTopology `
    -GroupName ML-group, HPC-group

예제 3: DescribeInstanceTopology - 인스턴스 유형 필터

지정된 인스턴스 유형(정확히 일치)을 기준으로 필터링하거나 인스턴스 패밀리(와일드카드 사용)를 기준으로 필터링할 수 있습니다. 지정된 인스턴스 유형 필터와 인스턴스 패밀리 필터를 조합할 수도 있습니다.

예제 3a - 지정된 인스턴스 유형에 대한 정확히 일치 필터

AWS CLI
특정 인스턴스 유형을 사용하여 인스턴스의 토폴로지를 설명하려면

instance-type 필터와 함께 describe-instance-topology 명령을 사용합니다. 출력에는 지정된 인스턴스 유형의 인스턴스만 포함됩니다.

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"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 인스턴스 유형을 사용하여 인스턴스의 토폴로지를 설명하려면

Get-EC2InstanceTopology cmdlet을 사용합니다.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="trn1n.32xlarge"}

예제 3b - 인스턴스 패밀리의 와일드카드 필터

AWS CLI
특정 인스턴스 패밀리를 사용하여 인스턴스의 토폴로지를 설명하려면

instance-type 필터와 함께 describe-instance-topology 명령을 사용합니다. 출력에는 지정된 인스턴스 패밀리의 인스턴스만 포함됩니다.

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"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-3333333333example",
            "InstanceType": "trn1.32xlarge",
            "NetworkNodes": [
                "nn-1212121212example",
                "nn-1211122211example",
                "nn-1311133311example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az4",
            "AvailabilityZone": "us-west-2d"            
        },
        {
            "InstanceId": "i-444444444example",
            "InstanceType": "trn1.2xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-5434334334example",
                "nn-1235301234example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"          
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 인스턴스 패밀리를 사용하여 인스턴스의 토폴로지를 설명하려면

Get-EC2InstanceTopology cmdlet을 사용합니다.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="trn1*"}

예제 3c - 조합된 인스턴스 패밀리와 정확히 일치 필터

AWS CLI
특정 인스턴스 패밀리 또는 인스턴스 유형을 사용하여 인스턴스의 토폴로지를 설명하려면

instance-type 필터와 함께 describe-instance-topology 명령을 사용합니다. 출력에는 지정된 기준을 충족하는 인스턴스만 포함됩니다.

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"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-4343434343example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 인스턴스 패밀리 또는 인스턴스 유형을 사용하여 인스턴스의 토폴로지를 설명하려면

Get-EC2InstanceTopology cmdlet을 사용합니다.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"}

예제 4: DescribeInstanceTopology - 영역 ID 필터

zone-id 필터를 사용하여 가용 영역 또는 로컬 영역을 기준으로 필터링할 수 있습니다. 가용 영역 필터와 로컬 영역 필터를 조합할 수도 있습니다.

예제 4a - 가용 영역 필터

AWS CLI
특정 가용 영역에 있는 인스턴스의 토폴로지를 설명하려면

zone-id 필터와 함께 describe-instance-topology 명령을 사용합니다. 출력에는 지정된 가용 영역의 인스턴스만 포함됩니다.

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"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 가용 영역에 있는 인스턴스의 토폴로지를 설명하려면

Get-EC2InstanceTopology cmdlet을 사용합니다.

Get-EC2InstanceTopology `
    -Filter @{Name="zone-id"; Values="use1-az1"}

예제 4b - 로컬 영역 필터

AWS CLI
특정 로컬 영역에 있는 인스턴스의 토폴로지를 설명하려면

zone-id 필터와 함께 describe-instance-topology 명령을 사용합니다. 출력에는 지정된 로컬 영역의 인스턴스만 포함됩니다.

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"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-atl2-az1",
            "AvailabilityZone": "us-east-1-atl-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 로컬 영역에 있는 인스턴스의 토폴로지를 설명하려면

Get-EC2InstanceTopology cmdlet을 사용합니다.

Get-EC2InstanceTopology `
    -Filter @{Name="zone-id"; Values="use1-atl2-az1"}

예제 4c - 조합된 가용 영역 필터 및 로컬 영역 필터

AWS CLI
특정 영역에 있는 인스턴스의 토폴로지를 설명하려면

zone-id 필터와 함께 describe-instance-topology 명령을 사용합니다. 출력에는 지정된 영역 중 하나에 있는 인스턴스만 포함됩니다.

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"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-atl2-az1",
            "AvailabilityZone": "us-east-1-atl-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 영역에 있는 인스턴스의 토폴로지를 설명하려면

Get-EC2InstanceTopology cmdlet을 사용합니다.

Get-EC2InstanceTopology `
    -Filter @{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}

예제 5: DescribeInstanceTopology - 인스턴스 유형 및 영역 ID 필터

단일 명령으로 필터를 조합할 수 있습니다.

AWS CLI
특정 인스턴스 유형, 인스턴스 패밀리 및 영역을 사용하여 인스턴스의 토폴로지를 설명하려면

instance-type 및 zone-id 필터와 함께 describe-instance-topology 명령을 사용합니다. 응답에는 지정된 인스턴스 유형에 해당하고 지정된 영역 중 하나에 있는 모든 인스턴스가 포함됩니다.

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"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-atl2-az1",
            "AvailabilityZone": "us-east-1-atl-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "trn1n.32xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3214313214example"
            ],
            "CapacityBlockId": "null",
            "ZoneId": "use1-az1",
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 인스턴스 유형, 인스턴스 패밀리 및 영역을 사용하여 인스턴스의 토폴로지를 설명하려면

Get-EC2InstanceTopology cmdlet을 사용합니다.

Get-EC2InstanceTopology `
    -Filter @{Name="instance-type"; Values="p4d*", "trn1n.32xlarge"} `
            @{Name="zone-id"; Values="use1-az1", "use1-atl2-az1"}

예제 6: DescribeCapacityReservationTopology - 용량 예약 ID

AWS CLI
특정 용량 예약의 토폴로지를 설명하려면

capacity-reservation-id 파라미터와 함께 describe-capacity-reservation-topology 명령을 사용합니다. 출력에는 지정된 용량 예약 ID와 일치하는 용량 예약만 포함됩니다.

aws ec2 describe-capacity-reservation-topology \
    --region us-east-1 \
    --capacity-reservation-id cr-1111111111example cr-2222222222example

출력의 예시는 다음과 같습니다.

{
    "CapacityReservations": [
        {
            "CapacityReservationId": "cr-1111111111example",
            "CapacityBlockId": "null",
            "State": "active",
            "InstanceType": "p5.48xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example"
            ],
            "AvailabilityZone": "us-east-1a"
        },
        {
            "CapacityReservationId": "cr-2222222222example",
            "CapacityBlockId": "null",
            "State": "active",
            "InstanceType": "p5en.48xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example"
            ],
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 용량 예약의 토폴로지를 설명하려면

Get-EC2CapacityReservationTopology cmdlet을 사용합니다.

Get-EC2CapacityReservationTopology `
    -CapacityReservationId cr-1111111111example cr-2222222222example

예제 7: DescribeCapacityReservationTopology - 인스턴스 유형 필터

지정된 인스턴스 유형(정확히 일치)을 기준으로 필터링하거나 인스턴스 패밀리(와일드카드 사용)를 기준으로 필터링할 수 있습니다. 지정된 인스턴스 유형 필터와 인스턴스 패밀리 필터를 조합할 수도 있습니다.

AWS CLI
특정 인스턴스 유형으로 용량 예약의 토폴로지를 설명하려면

instance-type 필터와 함께 describe-capacity-reservation-topology 명령을 사용합니다. 응답에는 지정된 인스턴스 유형의 모든 인스턴스가 포함됩니다.

aws ec2 describe-capacity-reservation-topology \
    --region us-east-1 \
    --filters Name=instance-type,Values=p5en.48xlarge

출력의 예시는 다음과 같습니다.

{
    "CapacityReservations": [
        {
            "CapacityReservationId": "cr-2222222222example",
            "CapacityBlockId": "null",
            "State": "active",
            "InstanceType": "p5en.48xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example"
            ],
            "AvailabilityZone": "us-east-1a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}
PowerShell
특정 인스턴스 유형으로 용량 예약의 토폴로지를 설명하려면

Get-EC2CapacityReservationTopology cmdlet을 사용합니다.

Get-EC2CapacityReservationTopology `
    -Filter @{Name="instance-type"; Values="p5en.48xlarge"}