Global Accelerator-Beispiele mit AWS CLI - AWS Command Line Interface

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Global Accelerator-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Global Accelerator Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface

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 Sieadd-custom-routing-endpoints.

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-Subnetz-Endpunkte für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator Developer Guide AWS .

Das folgende Codebeispiel zeigt die Verwendungadvertise-byoip-cidr.

AWS CLI

So geben Sie einen Adressbereich bekannt

Im folgenden advertise-byoip-cidr Beispiel werden Sie AWS aufgefordert, für einen Adressbereich zu werben, 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 Bring Your Own IP Address in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungallow-custom-routing-traffic.

AWS CLI

Um Traffic zu bestimmten EC2 Amazon-Instance-Zielen in einem VPC-Subnetz für einen benutzerdefinierten Routing-Beschleuniger zuzulassen

Das folgende allow-custom-routing-traffic Beispiel gibt an, dass Datenverkehr zu bestimmten IP-Adressen und Ports der EC2 Amazon-Instance (Ziel) für einen VPC-Subnetz-Endpunkt 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-Subnetz-Endpunkte für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator Developer Guide AWS .

Das folgende Codebeispiel zeigt die Verwendungcreate-accelerator.

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 AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungcreate-custom-routing-accelerator.

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-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungcreate-custom-routing-endpoint-group.

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 Routingbeschleuniger in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungcreate-custom-routing-listener.

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-Beschleuniger in Global Accelerator im AWS Global Accelerator Developer Guide.AWS

Das folgende Codebeispiel zeigt die Verwendungcreate-endpoint-group.

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 AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungcreate-listener.

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 Listeners in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

  • Einzelheiten zur API finden Sie CreateListenerin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdeny-custom-routing-traffic.

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 Anruf 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-Subnetz-Endpunkte für benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator Developer Guide AWS .

Das folgende Codebeispiel zeigt die Verwendungdeprovision-byoip-cidr.

AWS CLI

So entfernen Sie einen Adressbereich

Im folgenden deprovision-byoip-cidr Beispiel 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 Bring your own IP address in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungdescribe-accelerator-attributes.

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 AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungdescribe-accelerator.

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 AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungdescribe-custom-routing-accelerator-attributes.

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-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungdescribe-custom-routing-accelerator.

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-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungdescribe-custom-routing-endpoint-group.

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 Routingbeschleuniger in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungdescribe-custom-routing-listener.

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-Beschleuniger in Global Accelerator im AWS Global Accelerator Developer Guide.AWS

Das folgende Codebeispiel zeigt die Verwendungdescribe-endpoint-group.

AWS CLI

So beschreiben Sie eine Endpunktgruppe

Im folgenden describe-endpoint-group Beispiel werden Details zu einer Endpunktgruppe mit den folgenden Endpunkten abgerufen: einer EC2 Amazon-Instance, einer ALB und einer 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 Global Accelerator Developer Guide AWS .

Das folgende Codebeispiel zeigt die Verwendungdescribe-listener.

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 Listeners in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

  • Einzelheiten zur API finden Sie DescribeListenerin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-accelerators.

AWS CLI

So listen Sie Ihre Accelerators auf

Das folgende list-accelerators Beispiel listet die Accelerators in Ihrem AWS Konto auf. 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 AWS Global Accelerator Developer Guide.

  • Einzelheiten zur API finden Sie ListAcceleratorsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-byoip-cidr.

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 Bring your own IP address in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

  • Einzelheiten zur API finden Sie ListByoipCidrin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-custom-routing-accelerators.

AWS CLI

So listen Sie Ihre benutzerdefinierten Routing-Accelerators auf

Das folgende list-custom-routing-accelerators Beispiel listet die benutzerdefinierten Routingbeschleuniger in einem AWS Konto auf.

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-Beschleuniger in Global Accelerator im AWS Global Accelerator Developer Guide.AWS

Das folgende Codebeispiel zeigt die Verwendunglist-custom-routing-endpoint-groups.

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 Routingbeschleuniger in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendunglist-custom-routing-listeners.

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-Beschleuniger in Global Accelerator im AWS Global Accelerator Developer Guide.AWS

Das folgende Codebeispiel zeigt die Verwendunglist-custom-routing-port-mappings-by-destination.

AWS CLI

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

Das folgende list-custom-routing-port-mappings-by-destination Beispiel stellt die Portzuordnungen für einen bestimmten EC2 Zielserver (an der Zieladresse) für einen benutzerdefinierten Routingbeschleuniger bereit.

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 So funktionieren benutzerdefinierte Routing-Beschleuniger in Global Accelerator im AWS Global Accelerator AWS Developer Guide.

Das folgende Codebeispiel zeigt die Verwendunglist-custom-routing-port-mappings.

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 So funktionieren benutzerdefinierte Routing-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendunglist-endpoint-groups.

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 AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendunglist-listeners.

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 Listeners in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

  • Einzelheiten zur API finden Sie ListListenersin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

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 Tagging in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungprovision-byoip-cidr.

AWS CLI

So stellen Sie einen Adressbereich bereit

Im folgenden provision-byoip-cidr Beispiel 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 Bring your own IP address in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

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 Tagging in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

  • Einzelheiten zur API finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

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 Tagging in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

  • Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-accelerator-attributes.

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 AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungupdate-accelerator.

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 AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungupdate-custom-routing-accelerator-attributes.

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-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungupdate-custom-routing-accelerator.

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-Beschleuniger in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungupdate-custom-routing-listener.

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-Beschleuniger in Global Accelerator im AWS Global Accelerator Developer Guide.AWS

Das folgende Codebeispiel zeigt die Verwendungupdate-endpoint-group.

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 AWS Global Accelerator Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungupdate-listener.

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 Listeners in AWS Global Accelerator im AWS Global Accelerator Developer Guide.

  • Einzelheiten zur API finden Sie UpdateListenerin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungwithdraw-byoip-cidr.

AWS CLI

So ziehen Sie einen Adressbereich zurück

Im folgenden withdraw-byoip-cidr Beispiel wird ein Adressbereich aus AWS Global Accelerator entfernt, den Sie zuvor für die Verwendung mit Ihren AWS Ressourcen beworben 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 Bring your own IP address in AWS Global Accelerator im AWS Global Accelerator Developer Guide.