를 사용한 Global Accelerator 예제 AWS CLI - AWS SDK 코드 예제

AWS Doc SDK ExamplesWord AWS SDK 리포지토리에는 더 많은 GitHub 예제가 있습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용한 Global Accelerator 예제 AWS CLI

다음 코드 예제에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터용 VPC 서브넷 엔드포인트를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 고유 IP 주소 가져오기를 참조하세요. AWS

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

AWS CLI

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

다음 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터용 VPC 서브넷 엔드포인트를 참조하세요. AWS

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

AWS CLI

액셀러레이터를 생성하려면

다음 create-accelerator 예제에서는 BYOIP 정적 IP 주소가 2개인 태그 2개가 있는 액셀러레이터를 생성합니다. 액셀러레이터를 생성하거나 업데이트하려면 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 개발자 안내서의 Global AcceleratorAWS 의 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터의 엔드포인트 그룹을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터용 리스너를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator의 엔드포인트 그룹을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator의 리스너를 참조하세요. AWS

  • 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터용 VPC 서브넷 엔드포인트를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 고유 IP 주소 가져오기를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global AcceleratorAWS 의 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 개발자 안내서의 Global AcceleratorAWS 의 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터의 엔드포인트 그룹을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터용 리스너를 참조하세요. AWS

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

AWS CLI

엔드포인트 그룹을 설명하려면

다음 describe-endpoint-group 예제에서는 Amazon Word 인스턴스, 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 개발자 안내서의 Global Accelerator의 엔드포인트 그룹을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator의 리스너를 참조하세요. AWS

  • 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 개발자 안내서의 Global AcceleratorAWS 의 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 개발자 안내서의 Global Accelerator에서 고유 IP 주소 가져오기를 참조하세요. AWS

  • 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터용 엔드포인트 그룹을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터용 리스너를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터 작동 방식을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터 작동 방식을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator의 엔드포인트 그룹을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator의 리스너를 참조하세요. AWS

  • 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 개발자 안내서의 Global Accelerator에서 태그 지정을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 고유 IP 주소 가져오기를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 태그 지정을 참조하세요. AWS

  • 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 개발자 안내서의 Global Accelerator에서 태그 지정을 참조하세요. AWS

  • 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 개발자 안내서의 Global AcceleratorAWS 의 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 개발자 안내서의 Global AcceleratorAWS 의 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator에서 사용자 지정 라우팅 액셀러레이터용 리스너를 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator의 엔드포인트 그룹을 참조하세요. AWS

다음 코드 예시에서는 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 개발자 안내서의 Global Accelerator의 리스너를 참조하세요. AWS

  • 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 개발자 안내서의 Global Accelerator에서 고유한 IP 주소 가져오기를 참조하세요. AWS

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