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-idsubnet-abcd123example
\ --destination-addresses"172.31.200.6"
"172.31.200.7"
\ --destination-ports80
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-addresses192.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-addresses192.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
-
API の詳細については、 AWS CLI コマンドリファレンスの CreateCustomRoutingAccelerator
を参照してください。
-
次の例は、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-regionus-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 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のCreateCustomRoutingEndpointGroup
」を参照してください。
-
次の例は、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-rangesFromPort=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-regionus-east-1
\ --endpoint-configurationsEndpointId=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-rangesFromPort=80,ToPort=80
FromPort=81,ToPort=81
\ --protocolTCP
出力:
{ "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」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeAcceleratorAttributes
」を参照してください。
-
次の例は、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 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeCustomRoutingAcceleratorAttributes
」を参照してください。
-
次の例は、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 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeCustomRoutingAccelerator
」を参照してください。
-
次のコード例は、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 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeCustomRoutingEndpointGroup
」を参照してください。
-
次の例は、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
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeCustomRoutingListener
」を参照してください。
-
次のコード例は、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 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のListCustomRoutingAccelerators
」を参照してください。
-
次のコード例は、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 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のListCustomRoutingEndpointGroups
」を参照してください。
-
次の例は、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-address198.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 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のListCustomRoutingPortMappingsByDestination
」を参照してください。
-
次のコード例は、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 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のListCustomRoutingPortMappings
」を参照してください。
-
次のコード例は、list-endpoint-groups
を使用する方法を示しています。
- AWS CLI
-
エンドポイントグループを一覧表示するには
次の
list-endpoint-groups
例では、リスナーのエンドポイントグループを一覧表示します。このリスナーには 2 つのエンドポイントグループがあります。aws globalaccelerator --region
us-west-2
list-endpoint-groups
\ --listener-arnarn: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-bucketflowlogs-abc
\ --flow-logs-s3-prefixbucketprefix-abc
出力:
{ "AcceleratorAttributes": { "FlowLogsEnabled": true "FlowLogsS3Bucket": flowlogs-abc "FlowLogsS3Prefix": bucketprefix-abc } }
詳細については、AWS Global Accelerator デベロッパーガイドの「Global Accelerator の AWS Accelerators」を参照してください。
-
API の詳細については、 AWS CLI コマンドリファレンスの UpdateAcceleratorAttributes
を参照してください。
-
次のコード例は、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
\ --nameExampleAcceleratorNew
出力:
{ "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-bucketflowlogs-abc
\ --flow-logs-s3-prefixbucketprefix-abc
出力:
{ "AcceleratorAttributes": { "FlowLogsEnabled": true "FlowLogsS3Bucket": flowlogs-abc "FlowLogsS3Prefix": bucketprefix-abc } }
詳細については、AWS Global Accelerator デベロッパーガイドの「Global Accelerator のカスタムルーティングアクセラレータAWS 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のUpdateCustomRoutingAcceleratorAttributes
」を参照してください。
-
次の例は、update-custom-routing-accelerator
を使用する方法を説明しています。
- AWS CLI
-
カスタムルーティングアクセラレーターを更新するには
次の
update-custom-routing-accelerator
例では、カスタムルーティングアクセラレーターを変更して、アクセラレーター名を変更します。aws globalaccelerator --region
us-west-2
update-custom-routing-accelerator
\ --accelerator-arnarn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh
\ --nameExampleCustomRoutingAcceleratorNew
出力:
{ "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 」を参照してください。
-
API の詳細については、AWS CLI 「 コマンドリファレンス」のUpdateCustomRoutingAccelerator
」を参照してください。
-
次のコード例は、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-rangesFromPort=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-rangesFromPort=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
」を参照してください。
-