全域加速器範例使用 AWS CLI - AWS Command Line Interface

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

全域加速器範例使用 AWS CLI

下列程式碼範例說明如何使用 AWS Command Line Interface 搭配全域加速器來執行動作及實作常見案例。

Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境和跨服務範例中查看內容中的動作。

Scenarios (案例) 是向您展示如何呼叫相同服務中的多個函數來完成特定任務的程式碼範例。

每個範例都包含一個連結 GitHub,您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例會示範如何使用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 全球加速器開發人員指南》中的AWS 全域加速器中自訂路由加速器的 VPC 子網路端點

下列程式碼範例會示範如何使用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 全球加速器中AWS 的攜帶您自己的 IP 位址

下列程式碼範例會示範如何使用allow-custom-routing-traffic

AWS CLI

允許流量到 VPC 子網路中的特定 Amazon EC2 執行個體目的地,用於自訂路由加速器

下列allow-custom-routing-traffic範例指定流量允許到特定 Amazon EC2 執行個體 (目的地) IP 地址,而自訂路由加速器中 VPC 子網路端點的連接埠可接收流量。

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

此命令不會產生輸出。

如需詳細資訊,請參閱《AWS 全球加速器開發人員指南》中的AWS 全域加速器中自訂路由加速器的 VPC 子網路端點

下列程式碼範例會示範如何使用create-accelerator

AWS CLI

建立加速器的步驟

下列create-accelerator範例會建立具有兩個標籤的加速器,其中包含兩個 BYOIP 靜態 IP 位址。您必須指定「US-West-2 (Oregon)區域」才能建立或更新加速器。

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

輸出:

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

如需詳細資訊,請參閱《AWS 全域加速器開發人員指南》中的AWS 全域加速器。

下列程式碼範例會示範如何使用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 全域加速器中的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 全域加速器中的自訂路由加速器端點群組。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 全域加速器」中的AWS 自訂路由加速器接聽

下列程式碼範例會示範如何使用create-endpoint-group

AWS CLI

建立端點群組

下列create-endpoint-group範例會建立具有一個端點的端點群組。

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

輸出:

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

如需詳細資訊,請參閱AWS 全域加速器開發人員指南中的AWS 全域加速器中的端點群組

下列程式碼範例會示範如何使用create-listener

AWS CLI

建立監聽器

下列create-listener範例會建立具有兩個連接埠的接聽程式。

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

輸出:

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

如需詳細資訊,請參閱《AWS 全域加速器開發人員指南》中的「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 全球加速器開發人員指南》中的AWS 全域加速器中自訂路由加速器的 VPC 子網路端點

下列程式碼範例會示範如何使用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 全球加速器中AWS 的攜帶您自己的 IP 位址

下列程式碼範例會示範如何使用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 全域加速器開發人員指南》中的AWS 全域加速器。

下列程式碼範例會示範如何使用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 全域加速器開發人員指南》中的AWS 全域加速器。

下列程式碼範例會示範如何使用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 全域加速器中的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 全域加速器中的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 全域加速器中的自訂路由加速器端點群組。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 全域加速器」中的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 全域加速器開發人員指南中的AWS 全域加速器中的端點群組

下列程式碼範例會示範如何使用describe-listener

AWS CLI

描述監聽器

下列describe-listener範例說明監聽器。

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

輸出:

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

如需詳細資訊,請參閱《AWS 全域加速器開發人員指南》中的「AWS 全域加速器」中

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考DescribeListener中的。

下列程式碼範例會示範如何使用list-accelerators

AWS CLI

列出您的加速器

下列list-accelerators範例會列出您 AWS 帳戶中的加速器。此帳戶有兩個加速器。

aws globalaccelerator list-accelerators

輸出:

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

如需詳細資訊,請參閱《AWS 全域加速器開發人員指南》中的AWS 全域加速器。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考ListAccelerators中的。

下列程式碼範例會示範如何使用list-byoip-cidr

AWS CLI

列出您的地址範圍

下列範list-byoip-cidr例列出您已佈建以與全域加速器搭配使用的自帶 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 全球加速器中AWS 的攜帶您自己的 IP 位址

  • 如需 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 全域加速器中的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 全域加速器中的自訂路由加速器端點群組。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 全域加速器」中的AWS 自訂路由加速器接聽

下列程式碼範例會示範如何使用list-custom-routing-port-mappings-by-destination

AWS CLI

列出特定自訂線路加速器目的地的連接埠對映

下列list-custom-routing-port-mappings-by-destination範例提供自訂路由加速器之特定目的地 EC2 伺服器 (位於目的地位址) 的連接埠對應。

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

輸出:

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

如需詳細資訊,請參閱《全球加速器開發人員指南》中的 AWS 全域加速器中的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 全域加速器中的AWS 自訂路由加速器如何運作

下列程式碼範例會示範如何使用list-endpoint-groups

AWS CLI

列出端點群組

下列list-endpoint-groups範例會列出監聽器的端點群組。此接聽程式有兩個端點群組。

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

輸出:

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

如需詳細資訊,請參閱AWS 全域加速器開發人員指南中的AWS 全域加速器中的端點群組

下列程式碼範例會示範如何使用list-listeners

AWS CLI

列出監聽器

下列list-listeners範例會列出加速器的偵聽程式。

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

輸出:

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

如需詳細資訊,請參閱《AWS 全域加速器開發人員指南》中的「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 全域加速器開發人員指南中的AWS 全域加速器中的標記

下列程式碼範例會示範如何使用provision-byoip-cidr

AWS CLI

佈建位址範圍

下列範provision-byoip-cidr例會規定要與 AWS 資源搭配使用的指定位址範圍。

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

輸出:

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

如需詳細資訊,請參閱《全球加速器開發人員指南》中的 AWS 全球加速器中AWS 的攜帶您自己的 IP 位址

下列程式碼範例會示範如何使用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 全域加速器開發人員指南中的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 全域加速器開發人員指南中的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 全域加速器開發人員指南》中的AWS 全域加速器。

下列程式碼範例會示範如何使用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 全域加速器開發人員指南》中的AWS 全域加速器。

下列程式碼範例會示範如何使用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 全域加速器中的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 全域加速器中的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 全域加速器」中的AWS 自訂路由加速器接聽

下列程式碼範例會示範如何使用update-endpoint-group

AWS CLI

更新端點群組

下列update-endpoint-group範例會將三個端點新增至端點群組:彈性 IP 位址、ALB 和 NLB。

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

輸出:

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

如需詳細資訊,請參閱AWS 全域加速器開發人員指南中的AWS 全域加速器中的端點群組

下列程式碼範例會示範如何使用update-listener

AWS CLI

更新監聽器

下列update-listener範例會更新監聽程式,將連接埠變更為 100。

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

輸出:

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

如需詳細資訊,請參閱《AWS 全域加速器開發人員指南》中的「AWS 全域加速器」中

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考UpdateListener中的。

下列程式碼範例會示範如何使用withdraw-byoip-cidr

AWS CLI

撤銷地址範圍

下列範withdraw-byoip-cidr例會從您 AWS 先前公告要與資源搭配使用的 AWS 全域加速器撤銷位址範圍。

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

輸出:

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

如需詳細資訊,請參閱《全球加速器開發人員指南》中的 AWS 全球加速器中AWS 的攜帶您自己的 IP 位址