Ejemplos de Global Accelerator que utilizan la AWS CLI - AWS Command Line Interface

Ejemplos de Global Accelerator que utilizan la AWS CLI

En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando la AWS Command Line Interface con Global Accelerator.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar add-custom-routing-endpoints.

AWS CLI

Para agregar un punto de conexión de subred de VPC a un grupo de puntos de conexión para un acelerador de enrutamiento personalizado

En el siguiente ejemplo de add-custom-routing-endpoints, se agrega un punto de conexión de subred de VPC a un grupo de puntos de conexión para un acelerador de enrutamiento personalizado.

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"

Salida:

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

Para obtener más información, consulte Puntos de conexión de subred de Amazon VPC para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar advertise-byoip-cidr.

AWS CLI

Para anunciar un rango de direcciones

En el siguiente ejemplo de advertise-byoip-cidr, se solicita que AWS anuncie un rango de direcciones que haya aprovisionado para usarlo con sus recursos de AWS.

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

Salida:

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

Para obtener más información, consulte Traiga sus propias direcciones IP (BYOIP) en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte AdvertiseByoipCidr en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar allow-custom-routing-traffic.

AWS CLI

Para permitir el tráfico a destinos específicos de instancias de Amazon EC2 en una subred de VPC para un acelerador de enrutamiento personalizado

En el siguiente ejemplo de allow-custom-routing-traffic, se especifica que se permite el tráfico a determinadas direcciones IP (destino) de instancias de Amazon EC2 y que los puertos de un punto de conexión de subred de VPC en un acelerador de enrutamiento personalizado pueden recibir tráfico.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Puntos de conexión de subred de Amazon VPC para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar create-accelerator.

AWS CLI

Para crear un acelerador

En el siguiente ejemplo de create-accelerator, se crea un acelerador con dos etiquetas con dos direcciones IP estáticas de BYOIP. Debe especificar la región US-West-2 (Oregon) para crear o actualizar un acelerador.

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

Salida:

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

Para obtener más información, consulte Aceleradores estándar de AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte CreateAccelerator en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-custom-routing-accelerator.

AWS CLI

Para crear un acelerador de enrutamiento personalizado

En el siguiente ejemplo de create-custom-routing-accelerator, se crea un acelerador de enrutamiento personalizado con las etiquetas Name y 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

Salida:

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

Para obtener más información, consulte Aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar create-custom-routing-endpoint-group.

AWS CLI

Para crear un grupo de puntos de conexión para un acelerador de enrutamiento personalizado

En el siguiente ejemplo de create-custom-routing-endpoint-group, se crea un grupo de puntos de conexión para un acelerador de enrutamiento personalizado.

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"

Salida:

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

Para obtener más información, consulte Grupos de puntos de conexión para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar create-custom-routing-listener.

AWS CLI

Para crear un oyente para un acelerador de enrutamiento personalizado

En el siguiente ejemplo de create-custom-routing-listener, se crea un oyente con un rango de puertos de entre 5000 y 10 000 para un acelerador de enrutamiento personalizado.

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

Salida:

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

Para obtener más información, consulte Oyentes para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar create-endpoint-group.

AWS CLI

Para crear un grupo de puntos de conexión

En el siguiente ejemplo de create-endpoint-group se crea un grupo de puntos de conexión con un punto de conexión.

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

Salida:

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

Para obtener más información, consulte Grupos de puntos de conexión en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte CreateEndpointGroup en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-listener.

AWS CLI

Para crear un oyente

En el siguiente ejemplo de create-listener, se crea un oyente con dos puertos.

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

Salida:

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

Para obtener más información, consulte Oyentes para aceleradores estándar en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte CreateListener en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar deny-custom-routing-traffic.

AWS CLI

Para especificar una dirección de destino que no pueda recibir tráfico en un acelerador de enrutamiento personalizado

En el siguiente ejemplo de deny-custom-routing-traffic, se especifican las direcciones de destino de un punto de conexión de subred que no pueden recibir tráfico para un acelerador de enrutamiento personalizado. Para especificar más de una dirección de destino, separe las direcciones con un espacio. No hay respuesta para una llamada a deny-custom-routing-traffic correcta.

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"

Este comando no genera ninguna salida.

Para obtener más información, consulte Puntos de conexión de subred de Amazon VPC para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar deprovision-byoip-cidr.

AWS CLI

Para desaprovisionar un rango de direcciones

En el siguiente ejemplo de deprovision-byoip-cidr, se publica el rango de direcciones especificado que ha aprovisionado para usarlo con sus recursos de AWS.

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

Salida:

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

Para obtener más información, consulte Traiga sus propias direcciones IP (BYOIP) en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte DeprovisionByoipCidr en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-accelerator-attributes.

AWS CLI

Para describir los atributos de un acelerador

En el siguiente ejemplo de describe-accelerator-attributes, se recuperan los detalles de atributos para un acelerador.

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

Salida:

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

Para obtener más información, consulte Aceleradores estándar de AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-accelerator.

AWS CLI

Para describir un acelerador

En el siguiente ejemplo de describe-accelerator se recuperan los detalles sobre el acelerador especificado.

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

Salida:

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

Para obtener más información, consulte Aceleradores estándar de AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte DescribeAccelerator en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-custom-routing-accelerator-attributes.

AWS CLI

Para describir los atributos de un acelerador de enrutamiento personalizado

En el siguiente ejemplo de describe-custom-routing-accelerator-attributes, se describen los atributos de un acelerador de enrutamiento personalizado.

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

Salida:

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

Para obtener más información, consulte Aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-custom-routing-accelerator.

AWS CLI

Para describir un acelerador de enrutamiento personalizado

En el siguiente ejemplo de describe-custom-routing-accelerator, se recuperan los detalles sobre el acelerador de enrutamiento personalizado especificado.

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

Salida:

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

Para obtener más información, consulte Aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-custom-routing-endpoint-group.

AWS CLI

Para describir un grupo de puntos de conexión para un acelerador de enrutamiento personalizado

En el siguiente ejemplo de describe-custom-routing-endpoint-group, se describe un grupo de puntos de conexión para un acelerador de enrutamiento personalizado.

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

Salida:

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

Para obtener más información, consulte Grupos de puntos de conexión para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-custom-routing-listener.

AWS CLI

Para describir un oyente para un acelerador de enrutamiento personalizado

En el siguiente ejemplo de describe-custom-routing-listener, se describe un oyente para un acelerador de enrutamiento personalizado.

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

Salida:

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

Para obtener más información, consulte Oyentes para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-endpoint-group.

AWS CLI

Para describir un grupo de puntos de conexión

En el siguiente ejemplo de describe-endpoint-group, se recuperan detalles sobre un grupo de puntos de conexión con los siguientes puntos de conexión: una instancia de Amazon EC2, un ALB y 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

Salida:

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

Para obtener más información, consulte Grupos de puntos de conexión en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte DescribeEndpointGroup en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-listener.

AWS CLI

Para describir un oyente

En el siguiente ejemplo de describe-listener, se describe un oyente:

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

Salida:

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

Para obtener más información, consulte Oyentes para aceleradores estándar en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte DescribeListener en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-accelerators.

AWS CLI

Para describir de los aceleradores

En el siguiente ejemplo de list-accelerators, se muestran los aceleradores en su cuenta de AWS. Esta cuenta tiene dos aceleradores.

aws globalaccelerator list-accelerators

Salida:

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

Para obtener más información, consulte Aceleradores estándar de AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte ListAccelerators en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-byoip-cidr.

AWS CLI

Para enumerar los rangos de direcciones

En el siguiente ejemplo de list-byoip-cidr, se enumeran los rangos de direcciones IP (BYOIP) que ha aprovisionado para su uso con Global Accelerator.

aws globalaccelerator list-byoip-cidrs

Salida:

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

Para obtener más información, consulte Traiga sus propias direcciones IP (BYOIP) en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte ListByoipCidr en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-custom-routing-accelerators.

AWS CLI

Para enumerar sus aceleradores de enrutamiento personalizados

En el siguiente ejemplo de list-custom-routing-accelerators, se muestran los aceleradores de enrutamiento personalizados en su cuenta de AWS.

aws globalaccelerator list-custom-routing-accelerators

Salida:

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

Para obtener más información, consulte Aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar list-custom-routing-endpoint-groups.

AWS CLI

Para enumerar los grupos de puntos de conexión para un oyente de un acelerador de enrutamiento personalizado

En el siguiente ejemplo de list-custom-routing-endpoint-groups, se muestran los grupos de puntos de conexión para un oyente en acelerador de enrutamiento personalizado.

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

Salida:

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

Para obtener más información, consulte Grupos de puntos de conexión para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar list-custom-routing-listeners.

AWS CLI

Para enumerar los oyentes de los aceleradores de enrutamiento personalizados

En el siguiente ejemplo de list-custom-routing-listeners, se enumeran los oyentes para un acelerador de enrutamiento personalizado.

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

Salida:

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

Para obtener más información, consulte Oyentes para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar list-custom-routing-port-mappings-by-destination.

AWS CLI

Para enumerar una lista de las asignaciones de puertos para un destino de acelerador de enrutamiento personalizado

En el siguiente ejemplo de list-custom-routing-port-mappings-by-destination, se proporcionan las asignaciones de puertos para un servidor EC2 de destino específico (en la dirección de destino) para un acelerador de enrutamiento personalizado.

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

Salida:

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

Para obtener más información, consulte Cómo funcionan los aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar list-custom-routing-port-mappings.

AWS CLI

Para enumerar las asignaciones de puertos en un acelerador de enrutamiento personalizado

En el siguiente ejemplo de list-custom-routing-port-mappings, se proporciona una lista parcial de las asignaciones de puertos en un acelerador de enrutamiento personalizado.

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

Salida:

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

Para obtener más información, consulte Cómo funcionan los aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar list-endpoint-groups.

AWS CLI

Para enumerar grupos de puntos de conexión

En el siguiente ejemplo de list-endpoint-groups, se muestran los grupos de puntos de conexión para un oyente. Este oyente tiene dos grupos de puntos de conexión.

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

Salida:

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

Para obtener más información, consulte Grupos de puntos de conexión en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte ListEndpointGroups en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-listeners.

AWS CLI

Para enumerar los oyentes

En el siguiente ejemplo de list-listeners, se enumeran los oyentes para un acelerador.

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

Salida:

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

Para obtener más información, consulte Oyentes para aceleradores estándar en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte ListListeners en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-tags-for-resource.

AWS CLI

Para enumerar las etiquetas de un acelerador

En el siguiente ejemplo de list-tags-for-resource, se enumeran las etiquetas para un acelerador específico.

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

Salida:

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

Para obtener más información, consulte Etiquetado en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para ver los detalles de la API, consulte ListTagsForResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar provision-byoip-cidr.

AWS CLI

Para aprovisionar un rango de direcciones

En el siguiente ejemplo de provision-byoip-cidr, se aprovisiona el rango de direcciones especificado para usarlo con los recursos de AWS.

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

Salida:

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

Para obtener más información, consulte Traiga sus propias direcciones IP (BYOIP) en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre de la API, consulte ProvisionByoipCidr en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar tag-resource.

AWS CLI

Para etiquetar un acelerador

En el siguiente ejemplo de tag-resource, se agregan las etiquetas Name y Project a un acelerador, junto con los valores correspondientes a cada una de ellas.

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"

Este comando no genera ninguna salida.

Para obtener más información, consulte Etiquetado en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para ver los detalles de la API, consulte TagResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar untag-resource.

AWS CLI

Para eliminar una etiqueta de un acelerador

En el siguiente ejemplo de untag-resource, se eliminan las etiquetas Name y Project de un acelerador.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Etiquetado en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para ver los detalles de la API, consulte UntagResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-accelerator-attributes.

AWS CLI

Para actualizar los atributos de un acelerador

En el siguiente ejemplo de update-accelerator-attributes, se actualiza un acelerador para habilitar los registros de flujo. Debe especificar la región US-West-2 (Oregon) para crear o actualizar los atributos del acelerador.

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

Salida:

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

Para obtener más información, consulte Aceleradores estándar de AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar update-accelerator.

AWS CLI

Para actualizar un acelerador

En el siguiente ejemplo de update-accelerator, se modifica un acelerador para cambiarle el nombre a ExampleAcceleratorNew. Debe especificar la región US-West-2 (Oregon) para crear o actualizar los aceleradores.

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

Salida:

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

Para obtener más información, consulte Aceleradores estándar de AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte UpdateAccelerator en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-custom-routing-accelerator-attributes.

AWS CLI

Para actualizar los atributos de un acelerador de enrutamiento personalizado

En el siguiente ejemplo de update-custom-routing-accelerator-attributes, se actualiza un acelerador de enrutamiento personalizado para habilitar los registros de flujo.

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

Salida:

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

Para obtener más información, consulte Aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar update-custom-routing-accelerator.

AWS CLI

Para actualizar un acelerador de enrutamiento personalizado

En el siguiente ejemplo de update-custom-routing-accelerator, se modifica un acelerador de enrutamiento personalizado para cambiarle el nombre.

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

Salida:

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

Para obtener más información, consulte Aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar update-custom-routing-listener.

AWS CLI

Para actualizar un oyente de un acelerador de enrutamiento personalizado

En el siguiente ejemplo de update-custom-routing-listener, se actualiza un oyente para cambiar el rango de puertos.

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

Salida:

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

Para obtener más información, consulte Oyentes para aceleradores de enrutamiento personalizados en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

En el siguiente ejemplo de código, se muestra cómo utilizar update-endpoint-group.

AWS CLI

Para actualizar un grupo de puntos de conexión

En el siguiente ejemplo de update-endpoint-group, se agregan tres puntos de conexión a un grupo de puntos de conexión: una dirección IP elástica, un ALB y 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

Salida:

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

Para obtener más información, consulte Grupos de puntos de conexión en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte UpdateEndpointGroup en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-listener.

AWS CLI

Para actualizar un oyente

En el siguiente ejemplo de update-listener, se actualiza un oyente para cambiar el puerto a 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

Salida:

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

Para obtener más información, consulte Oyentes para aceleradores estándar en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte UpdateListener en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar withdraw-byoip-cidr.

AWS CLI

Para retirar un rango de direcciones

En el siguiente ejemplo de withdraw-byoip-cidr, se retira un rango de direcciones de AWS Global Accelerator que ha anunciado anteriormente para usarlo con los recursos de AWS.

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

Salida:

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

Para obtener más información, consulte Traiga sus propias direcciones IP (BYOIP) en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener información sobre la API, consulte WithdrawByoipCidr en la Referencia de comandos de la AWS CLI.