Exemples d’utilisation de l’AWS CLI avec Global Accelerator

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 Points de terminaison de sous-réseau VPC pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour publier une plage d’adresses

L’exemple advertise-byoip-cidr suivant demande à AWS de publier une plage d’adresses que vous avez allouée pour être utilisée avec vos ressources AWS.

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 Apportez votre propre adresse IP dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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

L’exemple allow-custom-routing-traffic suivant indique que le trafic est autorisé vers certaines adresses IP et certains ports d’instance Amazon EC2 (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 Points de terminaison de sous-réseau VPC pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour créer un accélérateur

L’exemple create-accelerator suivant crée un accélérateur avec deux balises et 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, consultez Accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Custom routing accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Groupes de points de terminaison pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Écouteurs des accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Groupes de points de terminaison dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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, consultez Écouteurs dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 de réussite d’un appel deny-custom-routing-traffic.

aws globalaccelerator deny-custom-routing-traffic \
    --endpoint-group-arn "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example" \
    --endpoint-id "subnet-abcd123example" \
    --destination-addresses "198.51.100.52"

Cette commande ne produit aucune sortie.

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

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

L’exemple deprovision-byoip-cidr suivant libère la plage d’adresses spécifiée que vous avez allouée pour qu’elle soit utilisée avec vos ressources AWS.

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 Apportez votre propre adresse IP dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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

L’exemple describe-accelerator-attributes suivant récupère 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, consultez Accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour décrire un accélérateur

L’exemple describe-accelerator suivant récupère 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, consultez Accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Custom routing accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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

L’exemple describe-custom-routing-accelerator suivant récupère 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 Custom routing accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Groupes de points de terminaison pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Écouteurs des accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour décrire un groupe de points de terminaison

L’exemple describe-endpoint-group suivant récupère les détails d’un groupe de points de terminaison avec les points de terminaison suivants : une instance Amazon EC2, 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 Groupes de points de terminaison dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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, consultez Écouteurs dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour répertorier vos accélérateurs

L’exemple list-accelerators suivant répertorie les accélérateurs de votre compte AWS. 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, consultez Accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour répertorier vos plages d’adresses

L’exemple list-byoip-cidr suivant répertorie les plages d’adresses BYOIP (Apportez votre propre adresse 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 Apportez votre propre adresse IP dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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

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

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 Custom routing accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Groupes de points de terminaison pour les accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Écouteurs des accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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

L’exemple list-custom-routing-port-mappings-by-destination suivant fournit les mappages de ports pour un serveur EC2 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 Fonctionnement des accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Fonctionnement des accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Groupes de points de terminaison dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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, consultez Écouteurs dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Tagging in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour allouer une plage d’adresses

L’exemple provision-byoip-cidr suivant alloue la plage d’adresses spécifiée à utiliser avec vos ressources AWS.

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 Apportez votre propre adresse IP dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour baliser un accélérateur

L’exemple tag-resource suivant ajoute les balises de nom (Name) et de projet (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 Tagging in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Tagging in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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, consultez Accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour mettre à jour un accélérateur

L’exemple update-accelerator suivant modifie un accélérateur afin de remplacer son nom par 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, consultez Accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Custom routing accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Custom routing accelerators in AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Écouteurs des accélérateurs de routage personnalisés dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

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 Groupes de points de terminaison dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour mettre à jour un écouteur

L’exemple update-listener suivant met à jour un écouteur pour remplacer la plage de ports par 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, consultez Écouteurs dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.

Pour retirer une plage d’adresses

L’exemple withdraw-byoip-cidr suivant retire une plage d’adresses d’AWS Global Accelerator que vous avez précédemment publiée pour qu’elle soit utilisée avec vos ressources AWS.

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 Apportez votre propre adresse IP dans AWS Global Accelerator dans le Manuel du développeur AWS Global Accelerator.