View a markdown version of this page

Ejemplos de Global Accelerator que utilizan AWS CLI - AWS Ejemplos de código de SDK

Hay más ejemplos de AWS SDK disponibles en el repositorio de ejemplos de AWS Doc SDK. GitHub

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplos de Global Accelerator que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes 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 los puntos de enlace de subred de la VPC para aceleradores de enrutamiento personalizados en Global Accelerator, en la guía para desarrolladores de Global Accelerator. AWS AWS

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 advertise-byoip-cidr ejemplo, se solicita AWS anunciar un rango de direcciones que has aprovisionado para su uso con tus recursos. 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 su propia dirección IP en AWS Global Accelerator en la guía para desarrolladores de AWS Global Accelerator.

  • Para obtener más información sobre la API, consulte AdvertiseByoipCidr la sección de referencia de AWS CLI comandos.

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 los puntos de enlace de subred de la VPC para los aceleradores de enrutamiento personalizados en Global Accelerator, en la guía para desarrolladores de Global Accelerator. AWS AWS

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 los aceleradores en AWS Global Accelerator en la guía para desarrolladores de AWS Global Accelerator.

  • Para obtener más información sobre la API, consulta la sección CreateAccelerator de referencia de AWS CLI comandos.

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 los aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator. AWS

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 los grupos de terminales para aceleradores de enrutamiento personalizados en Global Accelerator en la guía para desarrolladores de Global Accelerator. AWS AWS

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 Listeners para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS AWS

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 los grupos de terminales de Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator. AWS

  • Para obtener más información sobre la API, consulte CreateEndpointGroup la sección de referencia de AWS CLI comandos.

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 Listeners in AWS Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS

  • Para obtener más información sobre la API, consulte la sección CreateListener de referencia de AWS CLI comandos.

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 los puntos de enlace de subred de la VPC para aceleradores de enrutamiento personalizados en Global Accelerator, en la guía para desarrolladores de Global Accelerator. AWS AWS

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 deprovision-byoip-cidr ejemplo, se publica el rango de direcciones especificado que aprovisionaste para usarlo con tus recursos. 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 Incluya su propia dirección IP en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener más información sobre la API, consulte DeprovisionByoipCidr la sección de referencia de AWS CLI comandos.

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 los aceleradores en AWS Global Accelerator en la guía para desarrolladores de Global Accelerator. AWS

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 los aceleradores en AWS Global Accelerator en la guía para desarrolladores de Global Accelerator. AWS

  • Para obtener más información sobre la API, consulta la sección DescribeAccelerator de referencia de AWS CLI comandos.

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 los aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS AWS

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 los aceleradores de enrutamiento personalizados en Global Accelerator en AWS la Guía para desarrolladores de Global Accelerator. AWS

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 los grupos de terminales para aceleradores de enrutamiento personalizados en Global Accelerator en la guía para desarrolladores de Global Accelerator. AWS AWS

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 Listeners para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS AWS

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 los grupos de terminales de Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator. AWS

  • Para obtener más información sobre la API, consulte DescribeEndpointGroup la sección de referencia de AWS CLI comandos.

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 Listeners in AWS Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS

  • Para obtener más información sobre la API, consulte la sección DescribeListener de referencia de AWS CLI comandos.

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

AWS CLI

Para describir de los aceleradores

El siguiente list-accelerators ejemplo muestra los aceleradores de tu cuenta. 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, consulta los aceleradores en AWS Global Accelerator en la guía para desarrolladores de AWS Global Accelerator.

  • Para obtener más información sobre la API, consulta la sección ListAccelerators de referencia de AWS CLI comandos.

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 Incluya su propia dirección IP en Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator. AWS

  • Para obtener más información sobre la API, consulte ListByoipCidr la sección de referencia de AWS CLI comandos.

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

El siguiente list-custom-routing-accelerators ejemplo muestra los aceleradores de enrutamiento personalizados de una cuenta. 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 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-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 los grupos de terminales para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS AWS

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 Listeners para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS AWS

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 Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS AWS

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 Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS AWS

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 los grupos de terminales de Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator. AWS

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

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 Listeners in AWS Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS

  • Para obtener más información sobre la API, consulte la sección ListListeners de referencia de AWS CLI comandos.

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 \ --resource-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

Salida:

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

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

  • Para obtener más información sobre la API, consulta la sección ListTagsForResource de referencia de AWS CLI comandos.

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

AWS CLI

Para aprovisionar un rango de direcciones

El siguiente provision-byoip-cidr ejemplo aprovisiona el rango de direcciones especificado para usarlo con sus recursos. 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 Incluya su propia dirección IP en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener más información sobre la API, consulte ProvisionByoipCidr la sección de referencia de AWS CLI comandos.

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 obtener más información sobre la API, consulta la sección TagResource de referencia de AWS CLI comandos.

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 Etiquetar en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener más información sobre la API, consulta la sección UntagResource de referencia de AWS CLI comandos.

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 los aceleradores en AWS Global Accelerator en la guía para desarrolladores de Global Accelerator. AWS

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 los aceleradores en AWS Global Accelerator en la guía para desarrolladores de AWS Global Accelerator.

  • Para obtener más información sobre la API, consulta la sección UpdateAccelerator de referencia de AWS CLI comandos.

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 los aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS AWS

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 los aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator. AWS

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 Listeners para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS AWS

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 los grupos de terminales de Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator. AWS

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

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 Listeners in AWS Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS

  • Para obtener más información sobre la API, consulte la sección UpdateListener de referencia de AWS CLI comandos.

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

AWS CLI

Para retirar un rango de direcciones

El siguiente withdraw-byoip-cidr ejemplo retira un intervalo de direcciones de AWS Global Accelerator que anunciaste anteriormente para su uso con tus recursos. 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 Incluya su propia dirección IP en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

  • Para obtener más información sobre la API, consulte WithdrawByoipCidr la sección de referencia de AWS CLI comandos.