AWS CLI를 사용한 Global Accelerator 예시 - AWS Command Line Interface
작업

AWS CLI를 사용한 Global Accelerator 예시

다음 코드 예시에서는 에서 Global Accelerator에서 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 관련 시나리오의 컨텍스트에 따라 표시되며, 개별 서비스 함수를 직접적으로 호출하는 방법을 보여줍니다.

각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

주제

작업

다음 코드 예시에서는 add-custom-routing-endpoints 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터의 엔드포인트 그룹에 VPC 서브넷 엔드포인트를 추가하는 방법

다음 add-custom-routing-endpoints 예시는 사용자 지정 라우팅 액셀러레이터의 엔드포인트 그룹에 VPC 서브넷 엔드포인트를 추가합니다.

aws globalaccelerator add-custom-routing-endpoints \
    --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd \
    --endpoint-configurations "EndpointId=subnet-1234567890abcdef0"

출력:

{
    "EndpointDescriptions": [
        {
            "EndpointId": "subnet-1234567890abcdef0"
        }
    ],
    "EndpointGroupArn":"arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd"
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 VPC subnet endpoints for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 advertise-byoip-cidr 코드를 사용하는 방법을 보여줍니다.

AWS CLI

주소 범위를 광고하는 방법

다음 advertise-byoip-cidr 예시에서는 AWS 리소스와 함께 사용하도록 프로비저닝한 주소 범위를 광고AWS하라는 요청을 보여줍니다.

aws globalaccelerator advertise-byoip-cidr \
    --cidr 198.51.100.0/24

출력:

{
    "ByoipCidr": {
        "Cidr": "198.51.100.0/24",
        "State": "PENDING_ADVERTISING"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Bring Your Own IP Address in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 AdvertiseByoipCidr 섹션을 참조하세요.

다음 코드 예시에서는 allow-custom-routing-traffic 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터에 대해 VPC 서브넷의 특정 Amazon EC2 인스턴스 대상으로 트래픽을 허용하는 방법

다음 allow-custom-routing-traffic 예시에서는 사용자 지정 라우팅 액셀러레이터에서 특정 Amazon EC2 인스턴스(대상) IP 주소와 포트가 트래픽을 수신할 수 있는 VPC 서브넷 엔드포인트에 대해 트래픽을 허용하도록 지정합니다.

aws globalaccelerator allow-custom-routing-traffic \
    --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example \
    --endpoint-id subnet-abcd123example \
    --destination-addresses "172.31.200.6" "172.31.200.7" \
    --destination-ports 80 81

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS Global Accelerator 개발자 안내서의 VPC subnet endpoints for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 create-accelerator 코드를 사용하는 방법을 보여줍니다.

AWS CLI

액셀러레이터 생성

다음 create-accelerator 예시에서는 두 개의 BYOIP 고정 IP 주소를 가진 두 개의 태그를 사용하여 액셀러레이터를 생성합니다. 액셀러레이터를 만들거나 업데이트하려면 US-West-2 (Oregon) 리전을 지정해야 합니다.

aws globalaccelerator create-accelerator \
    --name ExampleAccelerator \
    --tags Key="Name",Value="Example Name" Key="Project",Value="Example Project" \
    --ip-addresses 192.0.2.250 198.51.100.52

출력:

{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleAccelerator",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1542394847.0,
        "LastModifiedTime": 1542394847.0
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Accelerators in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 CreateAccelerator 섹션을 참조하세요.

다음 코드 예시에서는 create-custom-routing-accelerator 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터 생성

다음 create-custom-routing-accelerator 예시에서는 태그 Name 및 Project를 사용하여 사용자 지정 라우팅 액셀러레이터를 생성합니다.

aws globalaccelerator create-custom-routing-accelerator \
    --name ExampleCustomRoutingAccelerator \
    --tags Key="Name",Value="Example Name" Key="Project",Value="Example Project" \
    --ip-addresses 192.0.2.250 198.51.100.52

출력:

{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleCustomRoutingAccelerator",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1542394847.0,
        "LastModifiedTime": 1542394847.0
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 create-custom-routing-endpoint-group 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터에 대한 엔드포인트 그룹을 생성하는 방법

다음 create-custom-routing-endpoint-group 예시에서는 사용자 지정 라우팅 액셀러레이터에 대한 엔드포인트 그룹을 만듭니다.

aws globalaccelerator create-custom-routing-endpoint-group \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \
    --endpoint-group-region us-east-2 \
    --destination-configurations "FromPort=80,ToPort=81,Protocols=TCP,UDP"

출력:

{
    "EndpointGroup": {
        "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd",
        "EndpointGroupRegion": "us-east-2",
        "DestinationDescriptions": [
            {
                "FromPort": 80,
                "ToPort": 81,
                "Protocols": [
                    "TCP",
                    "UDP"
                ]
            }
        ],
        "EndpointDescriptions": []
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Endpoint groups for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 create-custom-routing-listener 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터에 대한 리스너를 생성하는 방법

다음 create-custom-routing-listener 예시에서는 사용자 지정 라우팅 액셀러레이터를 위해 포트 범위가 5000에서 10000인 리스너를 생성합니다.

aws globalaccelerator create-custom-routing-listener \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --port-ranges FromPort=5000,ToPort=10000

출력:

{
    "Listener": {
        "PortRange": [
            "FromPort": 5000,
            "ToPort": 10000
        ],
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Listeners for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 create-endpoint-group 코드를 사용하는 방법을 보여줍니다.

AWS CLI

엔드포인트 그룹을 생성하는 방법

다음 create-endpoint-group 예시에서는 하나의 엔드포인트가 있는 엔드포인트 그룹을 만듭니다.

aws globalaccelerator create-endpoint-group \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \
    --endpoint-group-region us-east-1 \
    --endpoint-configurations EndpointId=i-1234567890abcdef0,Weight=128

출력:

{
    "EndpointGroup": {
        "TrafficDialPercentage": 100.0,
        "EndpointDescriptions": [
            {
                "Weight": 128,
                "EndpointId": "i-1234567890abcdef0"
            }
        ],
        "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu",
        "EndpointGroupRegion": "us-east-1"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Endpoint groups in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 create-listener 코드를 사용하는 방법을 보여줍니다.

AWS CLI

리스너 생성

다음 create-listener 예시는 두 개의 포트를 가진 리스너를 생성합니다.

aws globalaccelerator create-listener \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --port-ranges FromPort=80,ToPort=80 FromPort=81,ToPort=81 \
    --protocol TCP

출력:

{
    "Listener": {
        "PortRanges": [
            {
                "ToPort": 80,
                "FromPort": 80
            },
            {
                "ToPort": 81,
                "FromPort": 81
            }
        ],
        "ClientAffinity": "NONE",
        "Protocol": "TCP",
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Listeners in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 CreateListener를 참조하세요.

다음 코드 예시에서는 deny-custom-routing-traffic 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터에서 트래픽을 수신할 수 없는 대상 주소를 지정하는 방법

다음 deny-custom-routing-traffic 예시에서는 사용자 지정 라우팅 액셀러레이터의 트래픽을 수신할 수 없는 서브넷 엔드포인트의 대상 주소를 지정합니다. 둘 이상의 대상 주소를 지정하려면 주소를 공백으로 구분합니다. 성공적인 deny-custom-routing-traffic 호출에 대한 응답이 없습니다.

aws globalaccelerator deny-custom-routing-traffic \
    --endpoint-group-arn "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example" \
    --endpoint-id "subnet-abcd123example" \
    --destination-addresses "198.51.100.52"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS Global Accelerator 개발자 안내서의 VPC subnet endpoints for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 deprovision-byoip-cidr 코드를 사용하는 방법을 보여줍니다.

AWS CLI

주소 범위를 프로비저닝 해제하는 방법

다음 deprovision-byoip-cidr 예시에서는 AWS 리소스와 함께 사용하도록 프로비저닝한 지정된 주소 범위를 해제합니다.

aws globalaccelerator deprovision-byoip-cidr \
    --cidr "198.51.100.0/24"

출력:

{
    "ByoipCidr": {
        "Cidr": "198.51.100.0/24",
        "State": "PENDING_DEPROVISIONING"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Bring your own IP address in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 describe-accelerator-attributes 코드를 사용하는 방법을 보여줍니다.

AWS CLI

액셀러레이터의 속성을 설명하는 방법

다음 describe-accelerator-attributes 예시에서는 액셀러레이터의 속성 세부 정보를 검색합니다.

aws globalaccelerator describe-accelerator-attributes \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

출력:

{
    "AcceleratorAttributes": {
        "FlowLogsEnabled": true
        "FlowLogsS3Bucket": flowlogs-abc
        "FlowLogsS3Prefix": bucketprefix-abc
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 describe-accelerator 코드를 사용하는 방법을 보여줍니다.

AWS CLI

액셀러레이터 설명

다음 describe-accelerator 예시에서는 지정된 액셀러레이터에 대한 세부 정보를 검색합니다.

aws globalaccelerator describe-accelerator \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

출력:

{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleAccelerator",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1542394847,
        "LastModifiedTime": 1542395013
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 describe-custom-routing-accelerator-attributes 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터의 속성 설명

다음 describe-custom-routing-accelerator-attributes 예시에서는 사용자 지정 라우팅 액셀러레이터의 속성을 설명합니다.

aws globalaccelerator describe-custom-routing-accelerator-attributes \
   --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

출력:

{
    "AcceleratorAttributes": {
    "FlowLogsEnabled": false
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 describe-custom-routing-accelerator 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터 설명

다음 describe-custom-routing-accelerator 예시에서는 지정된 사용자 지정 라우팅 액셀러레이터에 대한 세부 정보를 검색합니다.

aws globalaccelerator describe-custom-routing-accelerator \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

출력:

{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleCustomRoutingAccelerator",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1542394847,
        "LastModifiedTime": 1542395013
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 describe-custom-routing-endpoint-group 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터의 엔드포인트 그룹 설명

다음 describe-custom-routing-endpoint-group 예시에서는 사용자 지정 라우팅 액셀러레이터에 대한 엔드포인트 그룹을 설명합니다.

aws globalaccelerator describe-custom-routing-endpoint-group \
    --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz/endpoint-group/ab88888example

출력:

{
    "EndpointGroup": {
        "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz/endpoint-group/ab88888example",
        "EndpointGroupRegion": "us-east-2",
        "DestinationDescriptions": [
            {
                "FromPort": 5000,
                "ToPort": 10000,
                "Protocols": [
                    "UDP"
                ]
            }
        ],
        "EndpointDescriptions": [
            {
                "EndpointId": "subnet-1234567890abcdef0"
            }
        ]
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Endpoint groups for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 describe-custom-routing-listener 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터의 리스너 설명

다음 describe-custom-routing-listener 예시에서는 사용자 지정 라우팅 액셀러레이터에 대한 리스너를 설명합니다.

aws globalaccelerator describe-custom-routing-listener \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234

출력:

{
    "Listener": {
        "PortRanges": [
            "FromPort": 5000,
            "ToPort": 10000
        ],
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Listeners for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 describe-endpoint-group 코드를 사용하는 방법을 보여줍니다.

AWS CLI

엔드포인트 그룹 설명

다음 describe-endpoint-group 예시에서는 Amazon EC2 인스턴스, ALB 및 NLB 엔드포인트가 있는 엔드포인트 그룹에 대한 세부 정보를 검색합니다

aws globalaccelerator describe-endpoint-group \
    --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/ab88888example

출력:

{
    "EndpointGroup": {
        "TrafficDialPercentage": 100.0,
        "EndpointDescriptions": [
        {
            "Weight": 128,
            "EndpointId": "i-1234567890abcdef0"
        },
        {
            "Weight": 128,
            "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz"
        },
        {
            "Weight": 128,
            "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs"
        }
        ],
        "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/4321abcd-abcd-4321-abcd-4321abcdefg",
        "EndpointGroupRegion": "us-east-1"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Endpoint groups in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 describe-listener 코드를 사용하는 방법을 보여줍니다.

AWS CLI

리스너 설명

다음 describe-listener 예시에서는 리스터를 설명합니다.

aws globalaccelerator describe-listener \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234

출력:

{
    "Listener": {
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234",
        "PortRanges": [
            {
                "FromPort": 80,
                "ToPort": 80
            }
        ],
        "Protocol": "TCP",
        "ClientAffinity": "NONE"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Listeners in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 DescribeListener 섹션을 참조하세요.

다음 코드 예시에서는 list-accelerators 코드를 사용하는 방법을 보여줍니다.

AWS CLI

액셀러레이터 나열

다음 list-accelerators 예시에서는 AWS 계정의 액셀러레이터를 나열합니다. 이 계정에는 두 개의 액셀러레이터가 있습니다.

aws globalaccelerator list-accelerators

출력:

{
    "Accelerators": [
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/5555abcd-abcd-5555-abcd-5555EXAMPLE1",
            "Name": "TestAccelerator",
            "IpAddressType": "IPV4",
            "Enabled": true,
            "IpSets": [
                {
                    "IpFamily": "IPv4",
                    "IpAddresses": [
                        "192.0.2.250",
                        "198.51.100.52"
                    ]
                }
            ],
            "DnsName": "5a5a5a5a5a5a5a5a.awsglobalaccelerator.com",
            "Status": "DEPLOYED",
            "CreatedTime": 1552424416.0,
            "LastModifiedTime": 1569375641.0
        },
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::888888888888:accelerator/8888abcd-abcd-8888-abcd-8888EXAMPLE2",
            "Name": "ExampleAccelerator",
            "IpAddressType": "IPV4",
            "Enabled": true,
            "IpSets": [
                {
                    "IpFamily": "IPv4",
                    "IpAddresses": [
                        "192.0.2.100",
                        "198.51.100.10"
                    ]
                }
            ],
            "DnsName": "6a6a6a6a6a6a6a.awsglobalaccelerator.com",
            "Status": "DEPLOYED",
            "CreatedTime": 1575585564.0,
            "LastModifiedTime": 1579809243.0
        },
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Accelerators in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListAccelerators 섹션을 참조하세요.

다음 코드 예시에서는 list-byoip-cidr 코드를 사용하는 방법을 보여줍니다.

AWS CLI

주소 범위를 나열하는 방법

다음 list-byoip-cidr 예시에서는 Global Accelerator에서 사용하도록 프로비저닝한 기존 보유 IP 주소 사용(BYOIP) 주소 범위를 나열합니다.

aws globalaccelerator list-byoip-cidrs

출력:

{
    "ByoipCidrs": [
        {
            "Cidr": "198.51.100.0/24",
            "State": "READY"
        }
        {
            "Cidr": "203.0.113.25/24",
            "State": "READY"
        }
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Bring your own IP address in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListByoipCidr 섹션을 참조하세요.

다음 코드 예시에서는 list-custom-routing-accelerators 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터를 나열하는 방법

다음 list-custom-routing-accelerators 예시에서는 AWS 계정의 사용자 지정 라우팅 액셀러레이터를 나열합니다.

aws globalaccelerator list-custom-routing-accelerators

출력:

{
    "Accelerators": [
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/5555abcd-abcd-5555-abcd-5555EXAMPLE1",
            "Name": "TestCustomRoutingAccelerator",
            "IpAddressType": "IPV4",
            "Enabled": true,
            "IpSets": [
                {
                    "IpFamily": "IPv4",
                    "IpAddresses": [
                        "192.0.2.250",
                        "198.51.100.52"
                    ]
                }
            ],
            "DnsName": "5a5a5a5a5a5a5a5a.awsglobalaccelerator.com",
            "Status": "DEPLOYED",
            "CreatedTime": 1552424416.0,
            "LastModifiedTime": 1569375641.0
        },
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::888888888888:accelerator/8888abcd-abcd-8888-abcd-8888EXAMPLE2",
            "Name": "ExampleCustomRoutingAccelerator",
            "IpAddressType": "IPV4",
            "Enabled": true,
            "IpSets": [
                {
                    "IpFamily": "IPv4",
                    "IpAddresses": [
                        "192.0.2.100",
                        "198.51.100.10"
                    ]
                }
            ],
            "DnsName": "6a6a6a6a6a6a6a.awsglobalaccelerator.com",
            "Status": "DEPLOYED",
            "CreatedTime": 1575585564.0,
            "LastModifiedTime": 1579809243.0
        },
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 list-custom-routing-endpoint-groups 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터에서 리스너의 엔드포인트 그룹 나열

다음 list-custom-routing-endpoint-groups 예시에서는 사용자 지정 라우팅 액셀러레이터의 리스너에 대한 엔드포인트 그룹을 나열합니다.

aws globalaccelerator list-custom-routing-endpoint-groups \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234

출력:

{
    "EndpointGroups": [
        {
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234/endpoint-group/ab88888example",
            "EndpointGroupRegion": "eu-central-1",
            "DestinationDescriptions": [
                {
                    "FromPort": 80,
                    "ToPort": 80,
                    "Protocols": [
                        "TCP",
                        "UDP"
                    ]
                }
            ]
            "EndpointDescriptions": [
                {
                    "EndpointId": "subnet-abcd123example"
                }
            ]
        }
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Endpoint groups for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 list-custom-routing-listeners 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터의 리스너 나열

다음 list-custom-routing-listeners 예시에서는 사용자 지정 라우팅 액셀러레이터의 리스너를 나열합니다.

aws globalaccelerator list-custom-routing-listeners \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

출력:

{
    "Listeners": [
        {
            "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234",
            "PortRanges": [
                {
                    "FromPort": 5000,
                    "ToPort": 10000
                }
            ],
            "Protocol": "TCP"
        }
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Listeners for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 list-custom-routing-port-mappings-by-destination 코드를 사용하는 방법을 보여줍니다.

AWS CLI

특정 사용자 지정 라우팅 액셀러레이터 대상의 포트 매핑 나열

다음 list-custom-routing-port-mappings-by-destination 예시에서는 사용자 지정 라우팅 액셀러레이터에 대한 특정 대상 EC2 서버(대상 주소)에 대한 포트 매핑을 제공합니다.

aws globalaccelerator list-custom-routing-port-mappings-by-destination \
    --endpoint-id subnet-abcd123example \
    --destination-address 198.51.100.52

출력:

{
    "DestinationPortMappings": [
        {
            "AcceleratorArn": "arn:aws:globalaccelerator::402092451327:accelerator/24ea29b8-d750-4489-8919-3095f3c4b0a7",
                "AcceleratorSocketAddresses": [
                    {
                        "IpAddress": "192.0.2.250",
                        "Port": 65514
                    },
                    {
                        "IpAddress": "192.10.100.99",
                        "Port": 65514
                    }
                ],
                "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example",
                "EndpointId": "subnet-abcd123example",
                "EndpointGroupRegion": "us-west-2",
                "DestinationSocketAddress": {
                    "IpAddress": "198.51.100.52",
                    "Port": 80
                },
                "IpAddressType": "IPv4",
                "DestinationTrafficState": "ALLOW"
        }
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 How custom routing accelerators work in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 list-custom-routing-port-mappings 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터의 정적 포트 매핑 나열

다음 list-custom-routing-port-mappings 예시에서는 사용자 지정 라우팅 액셀러레이터의 포트 매핑의 일부 목록을 제공합니다.

aws globalaccelerator list-custom-routing-port-mappings \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

출력:

{
    "PortMappings": [
        {
            "AcceleratorPort": 40480,
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu",
            "EndpointId": "subnet-1234567890abcdef0",
            "DestinationSocketAddress": {
                "IpAddress": "192.0.2.250",
                "Port": 80
            },
            "Protocols": [
                "TCP",
                "UDP"
            ],
            "DestinationTrafficState": "ALLOW"
        }
        {
            "AcceleratorPort": 40481,
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu",
            "EndpointId": "subnet-1234567890abcdef0",
            "DestinationSocketAddress": {
               "IpAddress": "192.0.2.251",
              "Port": 80
            },
            "Protocols": [
                "TCP",
                "UDP"
            ],
            "DestinationTrafficState": "ALLOW"
        }
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 How custom routing accelerators work in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 list-endpoint-groups 코드를 사용하는 방법을 보여줍니다.

AWS CLI

엔드포인트 그룹을 나열하는 방법

다음 list-endpoint-groups 예시에서는 리스너의 엔드포인트 그룹을 나열합니다. 이 리스너에는 두 개의 엔드포인트 그룹이 있습니다.

aws globalaccelerator --region us-west-2 list-endpoint-groups \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234

출력:

{
    "EndpointGroups": [
        {
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234/endpoint-group/ab88888example",
            "EndpointGroupRegion": "eu-central-1",
            "EndpointDescriptions": [],
            "TrafficDialPercentage": 100.0,
            "HealthCheckPort": 80,
            "HealthCheckProtocol": "TCP",
            "HealthCheckIntervalSeconds": 30,
            "ThresholdCount": 3
        }
        {
            "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234/endpoint-group/ab99999example",
            "EndpointGroupRegion": "us-east-1",
            "EndpointDescriptions": [],
            "TrafficDialPercentage": 50.0,
            "HealthCheckPort": 80,
            "HealthCheckProtocol": "TCP",
            "HealthCheckIntervalSeconds": 30,
            "ThresholdCount": 3
        }
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Endpoint Groups in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListEndpointGroups 섹션을 참조하세요.

다음 코드 예시에서는 list-listeners 코드를 사용하는 방법을 보여줍니다.

AWS CLI

리스너를 나열하는 방법

다음 list-listeners 예시에서는 액셀러레이터의 리스너를 나열합니다.

aws globalaccelerator list-listeners \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

출력:

{
    "Listeners": [
        {
            "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234",
            "PortRanges": [
                {
                    "FromPort": 80,
                    "ToPort": 80
                }
            ],
            "Protocol": "TCP",
            "ClientAffinity": "NONE"
        }
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Listeners in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ListListeners 섹션을 참조하세요.

다음 코드 예시에서는 list-tags-for-resource 코드를 사용하는 방법을 보여줍니다.

AWS CLI

액셀러레이터의 태그를 나열하는 방법

다음 list-tags-for-resource 예시에서는 특정 액셀러레이터의 태그를 나열합니다.

aws globalaccelerator list-tags-for-resource \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

출력:

{
    "Tags": [
        {
            "Key": "Project",
            "Value": "A123456"
        }
    ]
}

자세한 내용은 AWS Global Accelerator 개발자 안내서에서 Tagging in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 provision-byoip-cidr 코드를 사용하는 방법을 보여줍니다.

AWS CLI

주소 범위 프로비저닝

다음 provision-byoip-cidr 예시에서는 AWS 리소스에 사용할 지정된 주소 범위를 프로비저닝합니다.

aws globalaccelerator provision-byoip-cidr \
    --cidr 192.0.2.250/24 \
    --cidr-authorization-context Message="$text_message",Signature="$signed_message"

출력:

{
    "ByoipCidr": {
        "Cidr": "192.0.2.250/24",
        "State": "PENDING_PROVISIONING"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Bring your own IP address in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 ProvisionByoipCidr 섹션을 참조하세요.

다음 코드 예시에서는 tag-resource 코드를 사용하는 방법을 보여줍니다.

AWS CLI

액셀러레이터에 태그를 지정하는 방법

다음 tag-resource 예시에서는 각각에 해당하는 값과 함께 태그 이름 및 프로젝트를 액셀러레이터에 추가합니다.

aws globalaccelerator tag-resource \
    --resource-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --tags Key="Name",Value="Example Name" Key="Project",Value="Example Project"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS Global Accelerator 개발자 안내서에서 Tagging in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 TagResource를 참조하세요.

다음 코드 예시에서는 untag-resource 코드를 사용하는 방법을 보여줍니다.

AWS CLI

액셀러레이터에서 태그를 제거하는 방법

다음 untag-resource 예시에서는 액셀러레이터에서 태그 이름 및 프로젝트를 제거합니다.

aws globalaccelerator untag-resource \
    --resource-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --tag-keys Key="Name" Key="Project"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS Global Accelerator 개발자 안내서에서 Tagging in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UntagResource를 참조하세요.

다음 코드 예시에서는 update-accelerator-attributes 코드를 사용하는 방법을 보여줍니다.

AWS CLI

액셀러레이터의 속성을 업데이트하는 방법

다음 update-accelerator-attributes 예시에서는 액셀러레이터를 업데이트하여 흐름 로그를 활성화합니다. 액셀러레이터 속성을 생성하거나 업데이트하려면 US-West-2 (Oregon) 리전을 지정해야 합니다.

aws globalaccelerator update-accelerator-attributes \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --flow-logs-enabled \
    --flow-logs-s3-bucket flowlogs-abc \
    --flow-logs-s3-prefix bucketprefix-abc

출력:

{
    "AcceleratorAttributes": {
        "FlowLogsEnabled": true
        "FlowLogsS3Bucket": flowlogs-abc
        "FlowLogsS3Prefix": bucketprefix-abc
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 update-accelerator 코드를 사용하는 방법을 보여줍니다.

AWS CLI

액셀러레이터를 업데이트하는 방법

다음 update-accelerator 예시에서는 액셀러레이터 이름을 ExampleAcceleratorNew로 변경하도록 액셀러레이터를 수정합니다. 액셀러레이터를 만들거나 업데이트하려면 US-West-2 (Oregon) 리전을 지정해야 합니다.

aws globalaccelerator update-accelerator \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --name ExampleAcceleratorNew

출력:

{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleAcceleratorNew",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1232394847,
        "LastModifiedTime": 1232395654
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Accelerators in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateAccelerator 섹션을 참조하세요.

다음 코드 예시에서는 update-custom-routing-accelerator-attributes 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터의 속성 업데이트

다음 update-custom-routing-accelerator-attributes 예시에서는 사용자 지정 라우팅 액셀러레이터를 업데이트하여 흐름 로그를 활성화합니다.

aws globalaccelerator update-custom-routing-accelerator-attributes \
    --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --flow-logs-enabled \
    --flow-logs-s3-bucket flowlogs-abc \
    --flow-logs-s3-prefix bucketprefix-abc

출력:

{
    "AcceleratorAttributes": {
        "FlowLogsEnabled": true
        "FlowLogsS3Bucket": flowlogs-abc
        "FlowLogsS3Prefix": bucketprefix-abc
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 update-custom-routing-accelerator 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터 업데이트

다음 update-custom-routing-accelerator 예시에서는 사용자 지정 액셀러레이터 이름을 변경하도록 액셀러레이터를 수정합니다.

aws globalaccelerator --region us-west-2 update-custom-routing-accelerator \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --name ExampleCustomRoutingAcceleratorNew

출력:

{
    "Accelerator": {
        "AcceleratorArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
        "IpAddressType": "IPV4",
        "Name": "ExampleCustomRoutingAcceleratorNew",
        "Enabled": true,
        "Status": "IN_PROGRESS",
        "IpSets": [
            {
                "IpAddresses": [
                    "192.0.2.250",
                    "198.51.100.52"
                ],
                "IpFamily": "IPv4"
            }
        ],
        "DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
        "CreatedTime": 1232394847,
        "LastModifiedTime": 1232395654
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 update-custom-routing-listener 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 라우팅 액셀러레이터의 리스너 업데이트

다음 update-custom-routing-listener 예시에서는 리스너를 업데이트하여 포트 범위를 변경합니다.

aws globalaccelerator update-custom-routing-listener \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \
    --port-ranges FromPort=10000,ToPort=20000

출력:

{
    "Listener": {
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz
        "PortRanges": [
            {
                "FromPort": 10000,
                "ToPort": 20000
            }
        ],
        "Protocol": "TCP"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Listeners for custom routing accelerators in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 update-endpoint-group 코드를 사용하는 방법을 보여줍니다.

AWS CLI

엔드포인트 그룹을 업데이트하는 방법

다음 update-endpoint-group 예시에서는 엔드포인트 그룹에 탄력적 IP 주소, ALB 및 NLB의 세 가지 엔드포인트를 추가합니다.

aws globalaccelerator update-endpoint-group \
    --endpoint-group-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/ab88888example \
    --endpoint-configurations \
        EndpointId=eipalloc-eip01234567890abc,Weight=128 \
        EndpointId=arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz,Weight=128 \
        EndpointId=arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs,Weight=128

출력:

{
    "EndpointGroup": {
        "TrafficDialPercentage": 100,
        "EndpointDescriptions": [
            {
                "Weight": 128,
                "EndpointId": "eip01234567890abc"
            },
            {
                "Weight": 128,
                "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz"
            },
            {
                "Weight": 128,
                "EndpointId": "arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs"
            }
        ],
        "EndpointGroupArn": "arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/4321abcd-abcd-4321-abcd-4321abcdefg",
        "EndpointGroupRegion": "us-east-1"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Endpoint groups in AWS Global Accelerator를 참조하세요.

다음 코드 예시에서는 update-listener 코드를 사용하는 방법을 보여줍니다.

AWS CLI

리스너 업데이트

다음 update-listener 예시에서는 리스너를 업데이트하여 포트를 100으로 변경합니다.

aws globalaccelerator update-listener \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \
    --port-ranges FromPort=100,ToPort=100

출력:

{
    "Listener": {
        "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz
        "PortRanges": [
            {
                "FromPort": 100,
                "ToPort": 100
            }
        ],
        "Protocol": "TCP",
        "ClientAffinity": "NONE"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Listeners in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 UpdateListener 섹션을 참조하세요.

다음 코드 예시에서는 withdraw-byoip-cidr 코드를 사용하는 방법을 보여줍니다.

AWS CLI

주소 범위를 철회하는 방법

다음 withdraw-byoip-cidr 예시에서는 이전에 AWS 리소스와 함께 사용하도록 광고한 AWS Global Accelerator에서 주소 범위를 철회합니다.

aws globalaccelerator withdraw-byoip-cidr \
    --cidr 192.0.2.250/24

출력:

{
    "ByoipCidr": {
        "Cidr": "192.0.2.250/24",
        "State": "PENDING_WITHDRAWING"
    }
}

자세한 내용은 AWS Global Accelerator 개발자 안내서의 Bring your own IP address in AWS Global Accelerator를 참조하세요.

  • API 세부 정보는 AWS CLI 명령 참조의 WithdrawByoipCidr 섹션을 참조하세요.