Beispiele für die Verwendung der AWS CLI mit Global Accelerator - AWS Command Line Interface

Beispiele für die Verwendung der AWS CLI mit Global Accelerator

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Global Accelerator nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie add-custom-routing-endpoints verwendet wird.

AWS CLI

So fügen Sie einen VPC-Subnetzendpunkt zu einer Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator hinzu

Im folgenden Beispiel für add-custom-routing-endpoints wird ein VPC-Subnetzendpunkt zu einer Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator hinzugefügt.

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"

Ausgabe:

{ "EndpointDescriptions": [ { "EndpointId": "subnet-1234567890abcdef0" } ], "EndpointGroupArn":"arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd" }

Weitere Informationen finden Sie unter VPC-Subnetzendpunkte für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie advertise-byoip-cidr verwendet wird.

AWS CLI

So geben Sie einen Adressbereich bekannt

Im folgenden Beispiel für advertise-byoip-cidr wird AWS aufgefordert, einen Adressbereich bekanntzugeben, den Sie für die Verwendung mit Ihren AWS-Ressourcen bereitgestellt haben.

aws globalaccelerator advertise-byoip-cidr \ --cidr 198.51.100.0/24

Ausgabe:

{ "ByoipCidr": { "Cidr": "198.51.100.0/24", "State": "PENDING_ADVERTISING" } }

Weitere Informationen finden Sie unter Verwenden der eigenen IP-Adresse (Bring Your Own IP Address, BYOIP) in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie allow-custom-routing-traffic verwendet wird.

AWS CLI

So lassen Sie Datenverkehr zu bestimmten Amazon-EC2-Instance-Zielen in einem VPC-Subnetz für einen benutzerdefinierten Routing-Accelerator zu

Im folgenden Beispiel für allow-custom-routing-traffic wird angegeben, dass Datenverkehr zu bestimmten IP-Adressen und Ports von Amazon-EC2-Instances (Ziel) für einen VPC-Subnetzendpunkt in einem benutzerdefinierten Routing-Accelerator zugelassen ist, der Datenverkehr empfangen kann.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter VPC-Subnetzendpunkte für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie create-accelerator verwendet wird.

AWS CLI

So erstellen Sie einen Accelerator

Im folgenden Beispiel für create-accelerator wird ein Accelerator mit zwei Tags mit zwei statischen BYOIP-IP-Adressen erstellt. Sie müssen die Region US-West-2 (Oregon) angeben, um einen Accelerator zu erstellen oder zu aktualisieren.

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

Ausgabe:

{ "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 } }

Weitere Informationen finden Sie unter Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie create-custom-routing-accelerator verwendet wird.

AWS CLI

So erstellen Sie einen benutzerdefinierten Routing-Accelerator

Im folgenden Beispiel für create-custom-routing-accelerator wird ein benutzerdefinierter Routing-Accelerator mit den Tags Name und Project erstellt.

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

Ausgabe:

{ "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 } }

Weitere Informationen finden Sie unter Benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie create-custom-routing-endpoint-group verwendet wird.

AWS CLI

So erstellen Sie eine Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator

Im folgenden Beispiel für create-custom-routing-endpoint-group wird eine Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator erstellt.

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"

Ausgabe:

{ "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": [] } }

Weitere Informationen finden Sie unter Endpunktgruppen für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie create-custom-routing-listener verwendet wird.

AWS CLI

So erstellen Sie einen Listener für einen benutzerdefinierten Routing-Accelerator

Im folgenden Beispiel für create-custom-routing-listener wird ein Listener mit einem Portbereich von 5 000 bis 10 000 für einen benutzerdefinierten Routing-Accelerator erstellt.

aws globalaccelerator create-custom-routing-listener \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --port-ranges FromPort=5000,ToPort=10000

Ausgabe:

{ "Listener": { "PortRange": [ "FromPort": 5000, "ToPort": 10000 ], "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz" } }

Weitere Informationen finden Sie unter Listener für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie create-endpoint-group verwendet wird.

AWS CLI

So erstellen Sie eine Endpunktgruppe

Im folgenden Beispiel für create-endpoint-group wird eine Endpunktgruppe mit einem Endpunkt erstellt.

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

Ausgabe:

{ "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" } }

Weitere Informationen finden Sie unter Endpunktgruppen in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie create-listener verwendet wird.

AWS CLI

So erstellen Sie einen Listener

Im folgenden Beispiel für create-listener wird ein Listener mit zwei Ports erstellt.

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

Ausgabe:

{ "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" } }

Weitere Informationen finden Sie unter Listener in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

  • API-Details finden Sie unter CreateListener in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie deny-custom-routing-traffic verwendet wird.

AWS CLI

So geben Sie eine Zieladresse an, die keinen Datenverkehr in einem benutzerdefinierten Routing-Accelerator empfangen kann

Im folgenden Beispiel für deny-custom-routing-traffic werden eine Zieladresse oder mehrere Zieladressen in einem Subnetzendpunkt angegeben, die keinen Datenverkehr für einen benutzerdefinierten Routing-Accelerator empfangen können. Wenn Sie mehr als eine Zieladresse festlegen möchten, trennen Sie die Adressen mit einem Leerzeichen. Bei einem erfolgreichen deny-custom-routing-traffic-Aufruf erfolgt keine Antwort.

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"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter VPC-Subnetzendpunkte für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie deprovision-byoip-cidr verwendet wird.

AWS CLI

So entfernen Sie einen Adressbereich

Im folgenden Beispiel für deprovision-byoip-cidr wird der angegebene Adressbereich freigegeben, den Sie für die Verwendung mit Ihren AWS-Ressourcen bereitgestellt haben.

aws globalaccelerator deprovision-byoip-cidr \ --cidr "198.51.100.0/24"

Ausgabe:

{ "ByoipCidr": { "Cidr": "198.51.100.0/24", "State": "PENDING_DEPROVISIONING" } }

Weitere Informationen finden Sie unter Verwenden der eigenen IP-Adresse (Bring Your Own IP Address, BYOIP) in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie describe-accelerator-attributes verwendet wird.

AWS CLI

So beschreiben Sie die Attribute eines Accelerators

Im folgenden Beispiel für describe-accelerator-attributes werden die Attributdetails für einen Accelerator abgerufen.

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

Ausgabe:

{ "AcceleratorAttributes": { "FlowLogsEnabled": true "FlowLogsS3Bucket": flowlogs-abc "FlowLogsS3Prefix": bucketprefix-abc } }

Weitere Informationen finden Sie unter Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie describe-accelerator verwendet wird.

AWS CLI

So beschreiben Sie einen Accelerator

Im folgenden Beispiel für describe-accelerator werden die Details zum angegebenen Accelerator abgerufen.

aws globalaccelerator describe-accelerator \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

Ausgabe:

{ "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 } }

Weitere Informationen finden Sie unter Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie describe-custom-routing-accelerator-attributes verwendet wird.

AWS CLI

So beschreiben Sie die Attribute eines benutzerdefinierten Routing-Accelerators

Im folgenden Beispiel für describe-custom-routing-accelerator-attributes werden die Attribute für einen benutzerdefinierten Routing-Accelerator beschrieben.

aws globalaccelerator describe-custom-routing-accelerator-attributes \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

Ausgabe:

{ "AcceleratorAttributes": { "FlowLogsEnabled": false } }

Weitere Informationen finden Sie unter Benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie describe-custom-routing-accelerator verwendet wird.

AWS CLI

So beschreiben Sie einen benutzerdefinierten Routing-Accelerator

Im folgenden Beispiel für describe-custom-routing-accelerator werden die Details zum angegebenen benutzerdefinierten Routing-Accelerator abgerufen.

aws globalaccelerator describe-custom-routing-accelerator \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

Ausgabe:

{ "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 } }

Weitere Informationen finden Sie unter Benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie describe-custom-routing-endpoint-group verwendet wird.

AWS CLI

So beschreiben Sie eine Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator

Im folgenden Beispiel für describe-custom-routing-endpoint-group wird eine Endpunktgruppe für einen benutzerdefinierten Routing-Accelerator beschrieben.

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

Ausgabe:

{ "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" } ] } }

Weitere Informationen finden Sie unter Endpunktgruppen für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie describe-custom-routing-listener verwendet wird.

AWS CLI

So beschreiben Sie einen Listener für einen benutzerdefinierten Routing-Accelerator

Im folgenden Beispiel für describe-custom-routing-listener wird ein Listener für einen benutzerdefinierten Routing-Accelerator beschrieben.

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

Ausgabe:

{ "Listener": { "PortRanges": [ "FromPort": 5000, "ToPort": 10000 ], "ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234" } }

Weitere Informationen finden Sie unter Listener für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie describe-endpoint-group verwendet wird.

AWS CLI

So beschreiben Sie eine Endpunktgruppe

Im folgenden Beispiel für describe-endpoint-group werden Details zu einer Endpunktgruppe mit den folgenden Endpunkten abgerufen: einer Amazon-EC2-Instance, einem ALB und einem 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

Ausgabe:

{ "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" } }

Weitere Informationen finden Sie unter Endpunktgruppen in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie describe-listener verwendet wird.

AWS CLI

So beschreiben Sie einen Listener

Im folgenden Beispiel für describe-listener wird ein Listener beschrieben.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Listener in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie list-accelerators verwendet wird.

AWS CLI

So listen Sie Ihre Accelerators auf

Im folgenden Beispiel für list-accelerators werden die Accelerators in Ihrem AWS-Konto aufgelistet. Dieses Konto verfügt über zwei Accelerators.

aws globalaccelerator list-accelerators

Ausgabe:

{ "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 }, ] }

Weitere Informationen finden Sie unter Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie list-byoip-cidr verwendet wird.

AWS CLI

So listen Sie Ihre Adressbereiche auf

Im folgenden Beispiel für list-byoip-cidr werden die BYOIP-Adressbereiche (Bring Your Own IP Address, Verwenden der eigenen IP-Adresse) aufgelistet, die Sie für die Verwendung mit Global Accelerator bereitgestellt haben.

aws globalaccelerator list-byoip-cidrs

Ausgabe:

{ "ByoipCidrs": [ { "Cidr": "198.51.100.0/24", "State": "READY" } { "Cidr": "203.0.113.25/24", "State": "READY" } ] }

Weitere Informationen finden Sie unter Verwenden der eigenen IP-Adresse (Bring Your Own IP Address, BYOIP) in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

  • API-Details finden Sie unter ListByoipCidr in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-custom-routing-accelerators verwendet wird.

AWS CLI

So listen Sie Ihre benutzerdefinierten Routing-Accelerators auf

Im folgenden Beispiel für list-custom-routing-accelerators werden die benutzerdefinierten Routing-Accelerators in einem AWS-Konto aufgelistet.

aws globalaccelerator list-custom-routing-accelerators

Ausgabe:

{ "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 }, ] }

Weitere Informationen finden Sie unter Benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie list-custom-routing-endpoint-groups verwendet wird.

AWS CLI

So listen Sie Endpunktgruppen für einen Listener in einem benutzerdefinierten Routing-Accelerator auf

Im folgenden Beispiel für list-custom-routing-endpoint-groups werden die Endpunktgruppen für einen Listener in einem benutzerdefinierten Routing-Accelerator aufgelistet.

aws globalaccelerator list-custom-routing-endpoint-groups \ --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234

Ausgabe:

{ "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" } ] } ] }

Weitere Informationen finden Sie unter Endpunktgruppen für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie list-custom-routing-listeners verwendet wird.

AWS CLI

So listen Sie Listener für benutzerdefinierte Routing-Accelerators auf

Im folgenden Beispiel für list-custom-routing-listeners werden die Listener für einen benutzerdefinierten Routing-Accelerator aufgelistet.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Listener für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie list-custom-routing-port-mappings-by-destination verwendet wird.

AWS CLI

So listen Sie die Portzuordnungen für ein bestimmtes Ziel für einen benutzerdefinierten Routing-Accelerator auf

Im folgenden Beispiel für list-custom-routing-port-mappings-by-destination werden die Portzuordnungen für einen bestimmten EC2-Zielserver (an der Zieladresse) für einen benutzerdefinierten Routing-Accelerator bereitgestellt.

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

Ausgabe:

{ "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" } ] }

Weitere Informationen finden Sie unter Funktionsweise von benutzerdefinierten Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie list-custom-routing-port-mappings verwendet wird.

AWS CLI

So listen Sie die Portzuordnungen in einem benutzerdefinierten Routing-Accelerator auf

Im folgenden Beispiel für list-custom-routing-port-mappings wird eine unvollständige Liste der Portzuordnungen in einem benutzerdefinierten Routing-Accelerator bereitgestellt.

aws globalaccelerator list-custom-routing-port-mappings \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

Ausgabe:

{ "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" } ] }

Weitere Informationen finden Sie unter Funktionsweise von benutzerdefinierten Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie list-endpoint-groups verwendet wird.

AWS CLI

So listen Sie Endpunktgruppen auf

Im folgenden Beispiel für list-endpoint-groups werden die Endpunktgruppen für einen Listener aufgelistet. Dieser Listener verfügt über zwei Endpunktgruppen.

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

Ausgabe:

{ "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 } ] }

Weitere Informationen finden Sie unter Endpunktgruppen in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie list-listeners verwendet wird.

AWS CLI

So listen Sie Listener auf

Im folgenden Beispiel für list-listeners werden die Listener für einen Accelerator aufgelistet.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Listener in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

  • API-Details finden Sie unter ListListeners in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie Tags für einen Accelerator auf

Im folgenden Beispiel für list-tags-for-resource werden die Tags für einen bestimmten Accelerator aufgelistet.

aws globalaccelerator list-tags-for-resource \ --accelerator-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

Ausgabe:

{ "Tags": [ { "Key": "Project", "Value": "A123456" } ] }

Weitere Informationen finden Sie unter Tags in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie provision-byoip-cidr verwendet wird.

AWS CLI

So stellen Sie einen Adressbereich bereit

Im folgenden Beispiel für provision-byoip-cidr wird der angegebene Adressbereich zur Verwendung mit Ihren AWS-Ressourcen bereitgestellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Verwenden der eigenen IP-Adresse (Bring Your Own IP Address, BYOIP) in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So versehen Sie einen Accelerator mit einem Tag

Im folgenden Beispiel für tag-resource werden die Tags Name und Project zu einem Accelerator hinzugefügt, jeweils mit den zugehörigen Werten.

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"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tags in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie ein Tag aus einem Accelerator

Im folgenden Beispiel für untag-resource werden die Tags Name und Project aus einem Accelerator entfernt.

aws globalaccelerator untag-resource \ --resource-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --tag-keys Key="Name" Key="Project"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tags in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-accelerator-attributes verwendet wird.

AWS CLI

So aktualisieren Sie die Attribute eines Accelerators

Im folgenden Beispiel für update-accelerator-attributes wird ein Accelerator aktualisiert, um Ablaufprotokolle zu aktivieren. Sie müssen die Region US-West-2 (Oregon) angeben, um Accelerator-Attribute zu erstellen oder zu aktualisieren.

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

Ausgabe:

{ "AcceleratorAttributes": { "FlowLogsEnabled": true "FlowLogsS3Bucket": flowlogs-abc "FlowLogsS3Prefix": bucketprefix-abc } }

Weitere Informationen finden Sie unter Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie update-accelerator verwendet wird.

AWS CLI

So aktualisieren Sie einen Accelerator

Im folgenden Beispiel für update-accelerator wird ein Accelerator geändert, um seinen Namen in ExampleAcceleratorNew zu ändern. Sie müssen die Region US-West-2 (Oregon) angeben, um Accelerators zu erstellen oder zu aktualisieren.

aws globalaccelerator update-accelerator \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --name ExampleAcceleratorNew

Ausgabe:

{ "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 } }

Weitere Informationen finden Sie unter Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie update-custom-routing-accelerator-attributes verwendet wird.

AWS CLI

So aktualisieren Sie die Attribute eines benutzerdefinierten Routing-Accelerators

Im folgenden Beispiel für update-custom-routing-accelerator-attributes wird ein benutzerdefinierter Routing-Accelerator aktualisiert, um Ablaufprotokolle zu aktivieren.

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

Ausgabe:

{ "AcceleratorAttributes": { "FlowLogsEnabled": true "FlowLogsS3Bucket": flowlogs-abc "FlowLogsS3Prefix": bucketprefix-abc } }

Weitere Informationen finden Sie unter Benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie update-custom-routing-accelerator verwendet wird.

AWS CLI

So aktualisieren Sie einen benutzerdefinierten Routing-Accelerator

Im folgenden Beispiel für update-custom-routing-accelerator wird ein benutzerdefinierter Routing-Accelerator geändert, um seinen Namen zu ändern.

aws globalaccelerator --region us-west-2 update-custom-routing-accelerator \ --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \ --name ExampleCustomRoutingAcceleratorNew

Ausgabe:

{ "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 } }

Weitere Informationen finden Sie unter Benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie update-custom-routing-listener verwendet wird.

AWS CLI

So aktualisieren Sie einen Listener für einen benutzerdefinierten Routing-Accelerator

Im folgenden Beispiel für update-custom-routing-listener wird ein Listener aktualisiert, um den Portbereich zu ändern.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Listener für benutzerdefinierte Routing-Accelerators in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie update-endpoint-group verwendet wird.

AWS CLI

So aktualisieren Sie eine Endpunktgruppe

Im folgenden Beispiel für update-endpoint-group werden einer Endpunktgruppe drei Endpunkte hinzugefügt: eine Elastic-IP-Adresse, ein ALB und ein 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

Ausgabe:

{ "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" } }

Weitere Informationen finden Sie unter Endpunktgruppen in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

Das folgende Codebeispiel zeigt, wie update-listener verwendet wird.

AWS CLI

So aktualisieren Sie einen Listener

Im folgenden Beispiel für update-listener wird ein Listener aktualisiert, um den Port in 100 zu ändern.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Listener in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.

  • API-Details finden Sie unter UpdateListener in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie withdraw-byoip-cidr verwendet wird.

AWS CLI

So ziehen Sie einen Adressbereich zurück

Im folgenden Beispiel für withdraw-byoip-cidr wird ein Adressbereich aus AWS Global Accelerator zurückgezogen, den Sie zuvor für die Verwendung mit Ihren AWS-Ressourcen bekanntgegeben haben.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Verwenden der eigenen IP-Adresse (Bring Your Own IP Address, BYOIP) in AWS Global Accelerator im Entwicklerhandbuch zu AWS Global Accelerator.