Ejemplos de Global Accelerator utilizando AWS CLI - AWS SDKEjemplos de código

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

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 utilizando AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el AWS Command Line Interface uso de 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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

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

AWS CLI

Para agregar un punto final de VPC subred a un grupo de puntos finales para un acelerador de enrutamiento personalizado

El siguiente add-custom-routing-endpoints ejemplo agrega un punto final de VPC subred a un grupo de puntos finales 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 finales de VPC subred para ver 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 usar advertise-byoip-cidr.

AWS CLI

Para anunciar un rango de direcciones

En el siguiente advertise-byoip-cidr ejemplo, AWS se solicita anunciar un rango de direcciones que has aprovisionado para usarlo con tus AWS recursos.

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

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

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

AWS CLI

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

El siguiente allow-custom-routing-traffic ejemplo especifica que se permite el tráfico a determinadas direcciones IP (destino) de EC2 instancias de Amazon y que los puertos de un punto final de VPC subred 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 VPC subred para ver 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 usar create-accelerator.

AWS CLI

Para crear un acelerador

El siguiente create-accelerator ejemplo crea un acelerador con dos etiquetas con dos direcciones IP BYOIP estáticas. Debe especificar la US-West-2 (Oregon) región 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 Accelerators in AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

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

AWS CLI

Para crear un acelerador de enrutamiento personalizado

El siguiente create-custom-routing-accelerator ejemplo 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 AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

AWS CLI

Para crear un grupo de puntos finales para un acelerador de enrutamiento personalizado

El siguiente create-custom-routing-endpoint-group ejemplo crea un grupo de puntos finales 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 puntos finales para obtener 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 usar create-custom-routing-listener.

AWS CLI

Para crear un detector para un acelerador de enrutamiento personalizado

El siguiente create-custom-routing-listener ejemplo crea un listener con un rango de puertos de 5000 a 10000 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 obtener 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 usar create-endpoint-group.

AWS CLI

Para crear un grupo de puntos finales

En el siguiente create-endpoint-group ejemplo, se crea un grupo de puntos finales con un punto final.

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

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

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

AWS CLI

Para crear un oyente

El siguiente create-listener ejemplo 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 AWS Global Accelerator.

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

En el siguiente ejemplo de código se muestra cómo usar 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

El siguiente deny-custom-routing-traffic ejemplo especifica la dirección o direcciones de destino de un punto final 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 deny-custom-routing-traffic llamada exitosa.

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 finales de VPC subred para ver los aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de AWSAWS Global Accelerator.

En el siguiente ejemplo de código se muestra cómo usar 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 ha aprovisionado para usarlo con sus AWS recursos.

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 API obtener más información, consulte la Referencia DeprovisionByoipCidrde AWS CLI comandos.

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

AWS CLI

Para describir los atributos de un acelerador

En el siguiente describe-accelerator-attributes ejemplo, se recuperan los detalles de los atributos de 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 Accelerators in AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

AWS CLI

Para describir un acelerador

En el siguiente describe-accelerator ejemplo, 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 Accelerators in AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

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

AWS CLI

Para describir los atributos de un acelerador de enrutamiento personalizado

El siguiente describe-custom-routing-accelerator-attributes ejemplo describe 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 AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

AWS CLI

Para describir un acelerador de enrutamiento personalizado

El siguiente describe-custom-routing-accelerator ejemplo recupera 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 AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

AWS CLI

Para describir un grupo de puntos finales para un acelerador de enrutamiento personalizado

El siguiente describe-custom-routing-endpoint-group ejemplo describe un grupo de puntos finales 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 puntos finales para obtener 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 usar describe-custom-routing-listener.

AWS CLI

Para describir el agente de escucha de un acelerador de enrutamiento personalizado

El siguiente describe-custom-routing-listener ejemplo describe un agente de escucha 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 obtener 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 usar describe-endpoint-group.

AWS CLI

Para describir un grupo de puntos finales

El siguiente describe-endpoint-group ejemplo recupera detalles sobre un grupo de puntos de enlace con los siguientes puntos de enlace: una EC2 instancia de AmazonALB, un 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 puntos finales 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 usar describe-listener.

AWS CLI

Para describir a un oyente

El siguiente describe-listener ejemplo 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 AWS Global Accelerator.

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

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

AWS CLI

Para ver una lista de sus aceleradores

En el siguiente list-accelerators ejemplo, se muestran 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, consulte los aceleradores de AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

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

AWS CLI

Para enumerar sus rangos de direcciones

En el siguiente list-byoip-cidr ejemplo, se enumeran los rangos de direcciones «traiga su propia dirección 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 AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

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

AWS CLI

Para ver una lista de sus aceleradores de enrutamiento personalizados

En el siguiente list-custom-routing-accelerators ejemplo, se enumeran los aceleradores de enrutamiento personalizados de una AWS cuenta.

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 usar list-custom-routing-endpoint-groups.

AWS CLI

Para enumerar los grupos de puntos finales de un oyente en un acelerador de enrutamiento personalizado

El siguiente list-custom-routing-endpoint-groups ejemplo muestra los grupos de puntos finales de un listener en un 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 puntos finales para ver 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 usar list-custom-routing-listeners.

AWS CLI

Para enumerar los oyentes de los aceleradores de enrutamiento personalizados

En el siguiente list-custom-routing-listeners ejemplo, se enumeran los oyentes de 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 obtener 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 usar list-custom-routing-port-mappings-by-destination.

AWS CLI

Para enumerar las asignaciones de puertos para un destino específico de un acelerador de enrutamiento personalizado

El siguiente list-custom-routing-port-mappings-by-destination ejemplo proporciona las asignaciones de puertos para un EC2 servidor 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 AWS Guía para desarrolladores de Global Accelerator.AWS

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

AWS CLI

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

El siguiente list-custom-routing-port-mappings ejemplo 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 AWS Guía para desarrolladores de Global Accelerator.AWS

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

AWS CLI

Para enumerar los grupos de puntos finales

En el siguiente list-endpoint-groups ejemplo, se enumeran los grupos de puntos finales de un listener. Este oyente tiene dos grupos de puntos finales.

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

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

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

AWS CLI

Para enumerar los oyentes

El siguiente list-listeners ejemplo muestra los oyentes de 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 AWS Global Accelerator.

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

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

AWS CLI

Para enumerar las etiquetas de un acelerador

En el siguiente list-tags-for-resource ejemplo, se enumeran las etiquetas de 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 Etiquetar en AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

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

AWS CLI

Para aprovisionar un rango de direcciones

El siguiente provision-byoip-cidr ejemplo proporciona el rango de direcciones especificado para usarlo con AWS los recursos.

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 API obtener más información, consulte la Referencia ProvisionByoipCidrde AWS CLI comandos.

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

AWS CLI

Para etiquetar un acelerador

En el siguiente tag-resource ejemplo, se añaden las etiquetas Nombre y Proyecto 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 API obtener más información, consulte la Referencia de TagResourcecomandos AWS CLI .

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

AWS CLI

Para eliminar una etiqueta de un acelerador

En el siguiente untag-resource ejemplo, se eliminan las etiquetas Nombre y Proyecto 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 API obtener más información, consulte la Referencia de UntagResourcecomandos AWS CLI .

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

AWS CLI

Para actualizar los atributos de un acelerador

En el siguiente update-accelerator-attributes ejemplo, se actualiza un acelerador para habilitar los registros de flujo. Debe especificar la US-West-2 (Oregon) región 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 Accelerators in AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

AWS CLI

Para actualizar un acelerador

En el siguiente update-accelerator ejemplo, se modifica un acelerador para cambiarle el nombre a. ExampleAcceleratorNew Debe especificar la US-West-2 (Oregon) región 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 de AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

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

AWS CLI

Para actualizar los atributos de un acelerador de enrutamiento personalizado

El siguiente update-custom-routing-accelerator-attributes ejemplo 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 AWS Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator.

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

AWS CLI

Para actualizar un acelerador de enrutamiento personalizado

El siguiente update-custom-routing-accelerator ejemplo modifica un acelerador de enrutamiento personalizado para cambiar el nombre del acelerador.

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

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

AWS CLI

Para actualizar un detector para un acelerador de enrutamiento personalizado

En el siguiente update-custom-routing-listener ejemplo, se actualiza un listener 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 obtener aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de AWSAWS Global Accelerator.

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

AWS CLI

Para actualizar un grupo de puntos finales

El siguiente update-endpoint-group ejemplo agrega tres puntos de conexión a un grupo de puntos de conexión: una dirección IP elásticaALB, una y unaNLB.

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

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

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

AWS CLI

Para actualizar un oyente

El siguiente update-listener ejemplo 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 AWS Global Accelerator.

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

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

AWS CLI

Para retirar un rango de direcciones

En el siguiente withdraw-byoip-cidr ejemplo, se retira un rango de direcciones de AWS Global Accelerator que anunciaste anteriormente para usarlo 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 Global Accelerator en la Guía para desarrolladores de AWSAWS Global Accelerator.

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