を使用した Global Accelerator の例 AWS CLI - AWS SDKコードの例

Doc AWS SDK ExamplesWord リポジトリには、さらに多くの GitHub の例があります。 AWS SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用した 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

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

次のコード例は、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

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

次のコード例は、allow-custom-routing-traffic を使用する方法を示しています。

AWS CLI

カスタムルーティングアクセラレータの VPC サブネット内の特定の Amazon EC2 インスタンスの送信先へのトラフィックを許可するには

次のallow-custom-routing-traffic例では、カスタムルーティングアクセラレーターでトラフィックを受信できる EC2 サブネットエンドポイントの特定の Amazon VPC インスタンス (送信先) IP アドレスとポートにトラフィックが許可されていることを指定します。

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

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

次のコード例は、create-accelerator を使用する方法を示しています。

AWS CLI

アクセラレータを作成するには

次のcreate-accelerator例では、2 つの BYOIP 静的 IP アドレスを持つ 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 Accelerator の AWS Accelerators」を参照してください。

  • 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 」を参照してください。

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

次のコード例は、create-endpoint-group を使用する方法を示しています。

AWS CLI

エンドポイントグループを作成するには

次のcreate-endpoint-group例では、1 つのエンドポイントを持つエンドポイントグループを作成します。

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 」を参照してください。

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

次の例は、create-listener を使用する方法を説明しています。

AWS CLI

リスナーを作成するには

次のcreate-listener例では、2 つのポートを持つリスナーを作成します。

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

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

次のコード例は、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 」を参照してください。

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

次のコード例は、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 Accelerator の AWS Accelerators」を参照してください。

次の例は、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 Accelerator の AWS Accelerators」を参照してください。

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

次のコード例は、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 EC2 インスタンス、Word、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 」を参照してください。

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

次の例は、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 アカウントのアクセラレーターを一覧表示します。このアカウントには 2 つのアクセラレーターがあります。

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 Accelerator の AWS Accelerators」を参照してください。

  • 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 」を参照してください。

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

次のコード例は、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例では、リスナーのエンドポイントグループを一覧表示します。このリスナーには 2 つのエンドポイントグループがあります。

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 」を参照してください。

  • 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 デベロッパーガイドの「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

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

次のコード例は、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 の取得」を参照してください。

  • 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 デベロッパーガイド」の「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 Accelerator の AWS Accelerators」を参照してください。

次のコード例は、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 Accelerator の AWS Accelerators」を参照してください。

  • 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 」を参照してください。

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

次の例は、update-endpoint-group を使用する方法を説明しています。

AWS CLI

エンドポイントグループを更新するには

次のupdate-endpoint-group例では、Elastic IP アドレス、ALB、NLB の 3 つのエンドポイントをエンドポイントグループに追加します。

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 」を参照してください。

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

次の例は、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」を参照してください。