Exemples de Global Accelerator utilisant AWS CLI - AWS Command Line Interface

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exemples de Global Accelerator utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de l'accélérateur global AWS Command Line Interface with.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliseradd-custom-routing-endpoints.

AWS CLI

Pour ajouter un point de terminaison de sous-réseau VPC au groupe de points de terminaison d’un accélérateur de routage personnalisé

L’exemple add-custom-routing-endpoints suivant ajoute un point de terminaison de sous-réseau VPC au groupe de points de terminaison d’un accélérateur de routage personnalisé.

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"

Sortie :

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

Pour plus d'informations, consultez la section Points de terminaison du sous-réseau VPC pour les accélérateurs de routage personnalisés dans Global Accelerator dans le AWS guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliseradvertise-byoip-cidr.

AWS CLI

Pour publier une plage d’adresses

L'advertise-byoip-cidrexemple suivant demande AWS de publier une plage d'adresses que vous avez configurée pour être utilisée avec vos AWS ressources.

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

Sortie :

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

Pour plus d'informations, consultez la section Apportez votre propre adresse IP dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous AdvertiseByoipCidrà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserallow-custom-routing-traffic.

AWS CLI

Pour autoriser le trafic vers des destinations d' EC2 instance Amazon spécifiques dans un sous-réseau VPC pour un accélérateur de routage personnalisé

L'allow-custom-routing-trafficexemple suivant indique que le trafic est autorisé vers certaines adresses IP et certains ports d' EC2 instance Amazon (destination) pour qu'un point de terminaison de sous-réseau VPC dans un accélérateur de routage personnalisé puisse recevoir du trafic.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Points de terminaison du sous-réseau VPC pour les accélérateurs de routage personnalisés dans Global Accelerator dans le AWS guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utilisercreate-accelerator.

AWS CLI

Pour créer un accélérateur

L’exemple create-accelerator suivant crée un accélérateur avec deux balises avec deux adresses IP statiques BYOIP. Vous devez spécifier la région US-West-2 (Oregon) pour créer ou mettre à jour un accélérateur.

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

Sortie :

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

Pour plus d'informations, voir Accélérateurs dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous CreateAcceleratorà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-custom-routing-accelerator.

AWS CLI

Pour créer un accélérateur de routage personnalisé

L’exemple create-custom-routing-accelerator suivant crée un accélérateur de routage personnalisé avec les balises Name et 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

Sortie :

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

Pour plus d'informations, consultez la section Accélérateurs de routage personnalisés dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utilisercreate-custom-routing-endpoint-group.

AWS CLI

Pour créer un groupe de points de terminaison pour un accélérateur de routage personnalisé

L’exemple create-custom-routing-endpoint-group suivant crée un groupe de points de terminaison pour un accélérateur de routage personnalisé.

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"

Sortie :

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

Pour plus d'informations, consultez la section Groupes de points de terminaison pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utilisercreate-custom-routing-listener.

AWS CLI

Pour créer un écouteur pour un accélérateur de routage personnalisé

L’exemple create-custom-routing-listener suivant crée un écouteur avec une plage de ports comprise entre 5 000 et 10 000 pour un accélérateur de routage personnalisé.

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

Sortie :

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

Pour plus d'informations, consultez la section Écouteurs pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utilisercreate-endpoint-group.

AWS CLI

Pour créer un groupe de points de terminaison

L’exemple create-endpoint-group suivant crée un groupe de points de terminaison avec un point de terminaison.

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

Sortie :

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

Pour plus d'informations, consultez la section Groupes de points de terminaison dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous CreateEndpointGroupà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-listener.

AWS CLI

Pour créer un écouteur

L’exemple create-listener suivant crée un écouteur avec deux ports.

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

Sortie :

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

Pour plus d'informations, voir Listeners in AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous CreateListenerà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdeny-custom-routing-traffic.

AWS CLI

Pour spécifier une adresse de destination qui ne peut pas recevoir de trafic dans un accélérateur de routage personnalisé

L’exemple deny-custom-routing-traffic suivant indique l’adresse ou les adresses de destination d’un point de terminaison de sous-réseau qui ne peuvent pas recevoir de trafic pour un accélérateur de routage personnalisé. Pour spécifier plusieurs adresses de destination, séparez-les par un espace. Il n'y a aucune réponse en cas d' deny-custom-routing-trafficappel réussi.

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"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Points de terminaison du sous-réseau VPC pour les accélérateurs de routage personnalisés dans Global Accelerator dans le AWS guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous DenyCustomRoutingTrafficà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdeprovision-byoip-cidr.

AWS CLI

Pour annuler l’allocation d’une plage d’adresses

L'deprovision-byoip-cidrexemple suivant publie la plage d'adresses spécifiée que vous avez configurée pour être utilisée avec vos AWS ressources.

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

Sortie :

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

Pour plus d'informations, consultez la section Apportez votre propre adresse IP dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous DeprovisionByoipCidrà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-accelerator-attributes.

AWS CLI

Pour décrire les attributs d’un accélérateur

L’exemple describe-accelerator-attributes suivant extrait les détails de l’attribut d’un accélérateur.

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

Sortie :

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

Pour plus d'informations, voir Accélérateurs dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserdescribe-accelerator.

AWS CLI

Pour décrire un accélérateur

L’exemple describe-accelerator suivant extrait des détails sur l’accélérateur spécifié.

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

Sortie :

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

Pour plus d'informations, voir Accélérateurs dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous DescribeAcceleratorà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-custom-routing-accelerator-attributes.

AWS CLI

Pour décrire les attributs d’un accélérateur de routage personnalisé

L’exemple describe-custom-routing-accelerator-attributes suivant décrit les attributs d’un accélérateur de routage personnalisé.

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

Sortie :

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

Pour plus d'informations, consultez la section Accélérateurs de routage personnalisés dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserdescribe-custom-routing-accelerator.

AWS CLI

Pour décrire un accélérateur de routage personnalisé

L’exemple describe-custom-routing-accelerator suivant extrait les détails relatifs à l’accélérateur de routage personnalisé spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Accélérateurs de routage personnalisés dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserdescribe-custom-routing-endpoint-group.

AWS CLI

Pour décrire un groupe de points de terminaison d’un accélérateur de routage personnalisé

L’exemple describe-custom-routing-endpoint-group suivant décrit un groupe de points de terminaison d’un accélérateur de routage personnalisé.

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

Sortie :

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

Pour plus d'informations, consultez la section Groupes de points de terminaison pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserdescribe-custom-routing-listener.

AWS CLI

Pour décrire un écouteur pour un accélérateur de routage personnalisé

L’exemple describe-custom-routing-listener suivant décrit un écouteur pour un accélérateur de routage personnalisé.

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

Sortie :

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

Pour plus d'informations, consultez la section Écouteurs pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserdescribe-endpoint-group.

AWS CLI

Pour décrire un groupe de points de terminaison

L'describe-endpoint-groupexemple suivant récupère les détails d'un groupe de points de terminaison avec les points de terminaison suivants : une EC2 instance Amazon, un ALB et un 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

Sortie :

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

Pour plus d'informations, consultez la section Groupes de points de terminaison dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous DescribeEndpointGroupà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-listener.

AWS CLI

Pour décrire un écouteur

L’exemple describe-listener suivant décrit un écouteur.

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

Sortie :

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

Pour plus d'informations, voir Listeners in AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous DescribeListenerà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-accelerators.

AWS CLI

Pour répertorier vos accélérateurs

L'list-acceleratorsexemple suivant répertorie les accélérateurs de votre AWS compte. Ce compte possède deux accélérateurs.

aws globalaccelerator list-accelerators

Sortie :

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

Pour plus d'informations, voir Accélérateurs dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous ListAcceleratorsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-byoip-cidr.

AWS CLI

Pour répertorier vos plages d’adresses

L’exemple list-byoip-cidr suivant répertorie les plages d’adresses BYOIP (Apporter vos propres adresses IP) que vous avez allouées pour être utilisées avec Global Accelerator.

aws globalaccelerator list-byoip-cidrs

Sortie :

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

Pour plus d'informations, consultez la section Apportez votre propre adresse IP dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous ListByoipCidrà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-custom-routing-accelerators.

AWS CLI

Pour répertorier vos accélérateurs de routage personnalisés

L'list-custom-routing-acceleratorsexemple suivant répertorie les accélérateurs de routage personnalisés d'un AWS compte.

aws globalaccelerator list-custom-routing-accelerators

Sortie :

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

Pour plus d'informations, consultez la section Accélérateurs de routage personnalisés dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserlist-custom-routing-endpoint-groups.

AWS CLI

Pour répertorier les groupes de points de terminaison d’un écouteur dans un accélérateur de routage personnalisé

L’exemple list-custom-routing-endpoint-groups suivant répertorie les groupes de points de terminaison d’un écouteur dans un accélérateur de routage personnalisé.

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

Sortie :

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

Pour plus d'informations, consultez la section Groupes de points de terminaison pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserlist-custom-routing-listeners.

AWS CLI

Pour répertorier les écouteurs des accélérateurs de routage personnalisés

L’exemple list-custom-routing-listeners suivant répertorie les écouteurs d’un accélérateur de routage personnalisé.

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

Sortie :

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

Pour plus d'informations, consultez la section Écouteurs pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserlist-custom-routing-port-mappings-by-destination.

AWS CLI

Pour répertorier les mappages de port d’une destination d’accélérateur de routage personnalisé

L'list-custom-routing-port-mappings-by-destinationexemple suivant fournit les mappages de ports pour un EC2 serveur de destination spécifique (à l'adresse de destination) pour un accélérateur de routage personnalisé.

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

Sortie :

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

Pour plus d'informations, consultez la section Fonctionnement des accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserlist-custom-routing-port-mappings.

AWS CLI

Pour répertorier les mappages de port d’un accélérateur de routage personnalisé

L’exemple list-custom-routing-port-mappings suivant fournit une liste partielle des mappages de ports dans un accélérateur de routage personnalisé.

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

Sortie :

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

Pour plus d'informations, consultez la section Fonctionnement des accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserlist-endpoint-groups.

AWS CLI

Pour répertorier les groupes de points de terminaison

L’exemple list-endpoint-groups suivant répertorie les groupes de points de terminaison d’un écouteur. Cet écouteur possède deux groupes de points de terminaison.

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

Sortie :

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

Pour plus d'informations, consultez la section Endpoint Groups in AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous ListEndpointGroupsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-listeners.

AWS CLI

Pour répertorier des écouteurs

L’exemple list-listeners suivant répertorie les écouteurs d’un accélérateur.

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

Sortie :

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

Pour plus d'informations, voir Listeners in AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous ListListenersà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-tags-for-resource.

AWS CLI

Pour répertorier les balises d’un accélérateur

L’exemple list-tags-for-resource suivant répertorie les balises d’un accélérateur spécifique.

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

Sortie :

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

Pour plus d'informations, consultez la section Marquage dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserprovision-byoip-cidr.

AWS CLI

Pour allouer une plage d’adresses

L'provision-byoip-cidrexemple suivant indique la plage d'adresses spécifiée à utiliser avec vos AWS ressources.

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

Sortie :

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

Pour plus d'informations, consultez la section Apportez votre propre adresse IP dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous ProvisionByoipCidrà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertag-resource.

AWS CLI

Pour baliser un accélérateur

L’exemple tag-resource suivant ajoute les balises Name et Project à un accélérateur, ainsi que les valeurs correspondantes pour chacune d’elles.

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"

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Marquage dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous TagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

Pour supprimer une balise d’un accélérateur

L’exemple untag-resource suivant supprime les balises Name et Project d’un accélérateur.

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

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez la section Marquage dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous UntagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-accelerator-attributes.

AWS CLI

Pour mettre à jour les attributs d’un accélérateur

L’exemple update-accelerator-attributes suivant met à jour un accélérateur pour activer les journaux de flux. Vous devez spécifier la région US-West-2 (Oregon) pour créer ou mettre à jour les attributs de l’accélérateur.

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

Sortie :

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

Pour plus d'informations, voir Accélérateurs dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserupdate-accelerator.

AWS CLI

Pour mettre à jour un accélérateur

L’exemple update-accelerator suivant modifie un accélérateur afin de changer son nom pour ExampleAcceleratorNew. Vous devez spécifier la région US-West-2 (Oregon) pour créer ou mettre à jour des accélérateurs.

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

Sortie :

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

Pour plus d'informations, voir Accélérateurs dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous UpdateAcceleratorà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-custom-routing-accelerator-attributes.

AWS CLI

Pour mettre à jour les attributs d’un accélérateur de routage personnalisé

L’exemple update-custom-routing-accelerator-attributes suivant met à jour un accélérateur de routage personnalisé pour activer les journaux de flux.

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

Sortie :

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

Pour plus d'informations, consultez la section Accélérateurs de routage personnalisés dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserupdate-custom-routing-accelerator.

AWS CLI

Pour mettre à jour un accélérateur de routage personnalisé

L’exemple update-custom-routing-accelerator suivant modifie un accélérateur de routage personnalisé pour en changer le nom.

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

Sortie :

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

Pour plus d'informations, consultez la section Accélérateurs de routage personnalisés dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserupdate-custom-routing-listener.

AWS CLI

Pour mettre à jour un écouteur pour un accélérateur de routage personnalisé

L’exemple update-custom-routing-listener suivant met à jour un écouteur pour modifier la plage de ports.

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

Sortie :

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

Pour plus d'informations, consultez la section Écouteurs pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

L'exemple de code suivant montre comment utiliserupdate-endpoint-group.

AWS CLI

Pour mettre à jour un groupe de points de terminaison

L’exemple update-endpoint-group suivant ajoute trois points de terminaison à un groupe de points de terminaison : une adresse IP Elastic, un ALB et un 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

Sortie :

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

Pour plus d'informations, consultez la section Groupes de points de terminaison dans AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous UpdateEndpointGroupà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-listener.

AWS CLI

Pour mettre à jour un écouteur

L’exemple update-listener suivant met à jour un écouteur pour modifier la plage de ports sur 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

Sortie :

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

Pour plus d'informations, voir Listeners in AWS Global Accelerator dans le Guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous UpdateListenerà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserwithdraw-byoip-cidr.

AWS CLI

Pour retirer une plage d’adresses

L'withdraw-byoip-cidrexemple suivant retire une plage d'adresses de AWS Global Accelerator dont vous avez précédemment fait la promotion pour une utilisation avec vos AWS ressources.

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

Sortie :

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

Pour plus d'informations, consultez la section Apportez votre propre adresse IP dans AWS Global Accelerator dans le guide du développeur de AWS Global Accelerator.

  • Pour plus de détails sur l'API, reportez-vous WithdrawByoipCidrà la section Référence des AWS CLI commandes.