を使用した Global Accelerator の例 AWS CLI - AWS Command Line Interface

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

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

詳細については、VPC AWS 「 Global Accelerator デベロッパーガイド」の「Global Accelerator のカスタムルーティングアクセラレーターのサブネットエンドポイント」を参照してください。 AWS

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

次のコード例は、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 詳細については、「 コマンドリファレンスAdvertiseByoipCidr」の「」を参照してください。 AWS CLI

次の例は、allow-custom-routing-traffic を使用する方法を説明しています。

AWS CLI

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

次のallow-custom-routing-traffic例では、カスタムルーティングアクセラレーターでトラフィックを受信できるVPCサブネットエンドポイントの特定の Amazon EC2インスタンス (送信先) 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

このコマンドでは何も出力されません。

詳細については、VPC AWS 「 Global Accelerator デベロッパーガイド」の「Global Accelerator のカスタムルーティングアクセラレーターのサブネットエンドポイント」を参照してください。 AWS

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

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

AWS CLI

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

次のcreate-accelerator例では、2 つの静的 IP アドレスを持つ 2 BYOIP つのタグを持つ アクセラレーターを作成します。アクセラレータを作成または更新するには、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 デベロッパーガイド」のAWS 「Global Accelerator のアクセラレーター」を参照してください。

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

次のコード例は、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 詳細については、「 コマンドリファレンスCreateCustomRoutingListener」の「」を参照してください。 AWS CLI

次のコード例は、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 詳細については、「 コマンドリファレンスCreateEndpointGroup」の「」を参照してください。 AWS CLI

次のコード例は、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 詳細については、「 コマンドリファレンスCreateListener」の「」を参照してください。 AWS CLI

次の例は、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"

このコマンドでは何も出力されません。

詳細については、VPC AWS 「 Global Accelerator デベロッパーガイド」の「Global Accelerator のカスタムルーティングアクセラレーターのサブネットエンドポイントAWS 」を参照してください。

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

次のコード例は、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 詳細については、「 コマンドリファレンスDeprovisionByoipCidr」の「」を参照してください。 AWS CLI

次の例は、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 デベロッパーガイド」の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 デベロッパーガイド」のAWS 「Global Accelerator のアクセラレーター」を参照してください。

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

次の例は、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インスタンス、、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 詳細については、「 コマンドリファレンスDescribeEndpointGroup」の「」を参照してください。 AWS CLI

次の例は、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 詳細については、「 コマンドリファレンスDescribeListener」の「」を参照してください。 AWS CLI

次の例は、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 デベロッパーガイド」のAWS 「Global Accelerator のアクセラレーター」を参照してください。

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

次の例は、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 詳細については、「 コマンドリファレンスListByoipCidr」の「」を参照してください。 AWS CLI

次の例は、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 詳細については、「 コマンドリファレンスListCustomRoutingListeners」の「」を参照してください。 AWS CLI

次の例は、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 詳細については、「 コマンドリファレンスListEndpointGroups」の「」を参照してください。 AWS CLI

次の例は、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 詳細については、「 コマンドリファレンスListListeners」の「」を参照してください。 AWS CLI

次のコード例は、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 詳細については、「 コマンドリファレンスListTagsForResource」の「」を参照してください。 AWS CLI

次の例は、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 詳細については、「 コマンドリファレンスProvisionByoipCidr」の「」を参照してください。 AWS CLI

次のコード例は、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 詳細については、「 コマンドリファレンスTagResource」の「」を参照してください。 AWS CLI

次の例は、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 詳細については、「 コマンドリファレンスUntagResource」の「」を参照してください。 AWS CLI

次のコード例は、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 デベロッパーガイド」のAWS 「Global Accelerator のアクセラレーター」を参照してください。

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

次のコード例は、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 デベロッパーガイド」のAWS 「Global Accelerator のアクセラレーター」を参照してください。

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

次のコード例は、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 詳細については、「 コマンドリファレンスUpdateCustomRoutingListener」の「」を参照してください。 AWS CLI

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

AWS CLI

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

次のupdate-endpoint-group例では、Elastic IP アドレス、、ALBおよび の 3 つのエンドポイントをエンドポイントグループに追加します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

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

次の例は、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 詳細については、「 コマンドリファレンスUpdateListener」の「」を参照してください。 AWS CLI

次の例は、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 詳細については、「 コマンドリファレンスWithdrawByoipCidr」の「」を参照してください。 AWS CLI