# 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.
**Topics**
+ [Acciones](#actions)
## Acciones
### `add-custom-routing-endpoints`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [AddCustomRoutingEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/add-custom-routing-endpoints.html) en la *Referencia de comandos de la AWS CLI*.
### `advertise-byoip-cidr`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [AdvertiseByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/advertise-byoip-cidr.html) en la *Referencia de comandos de la AWS CLI*.
### `allow-custom-routing-traffic`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener detalles sobre la API, consulte [AllowCustomRoutingTraffic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/allow-custom-routing-traffic.html) en la *Referencia de comandos de la AWS CLI*.
### `create-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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [CreateAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-accelerator.html) en la *Referencia de comandos de la AWS CLI*.
### `create-custom-routing-accelerator`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [CreateCustomRoutingAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-accelerator.html) en la *Referencia de comandos de la AWS CLI*.
### `create-custom-routing-endpoint-group`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [CreateCustomRoutingEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-endpoint-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-custom-routing-listener`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [CreateCustomRoutingListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-listener.html) en la *Referencia de comandos de la AWS CLI*.
### `create-endpoint-group`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [CreateEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-endpoint-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-listener`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) en la Guía para desarrolladores de AWS Global Accelerator.
+ Para obtener información sobre la API, consulte [CreateListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-listener.html) en la *Referencia de comandos de la AWS CLI*.
### `deny-custom-routing-traffic`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [DenyCustomRoutingTraffic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/deny-custom-routing-traffic.html) en la *Referencia de comandos de la AWS CLI*.
### `deprovision-byoip-cidr`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [DeprovisionByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/deprovision-byoip-cidr.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-accelerator-attributes`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [DescribeAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-accelerator-attributes.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [DescribeAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-accelerator.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-custom-routing-accelerator-attributes`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [DescribeCustomRoutingAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-accelerator-attributes.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-custom-routing-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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [DescribeCustomRoutingAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-accelerator.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-custom-routing-endpoint-group`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [DescribeCustomRoutingEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-endpoint-group.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-custom-routing-listener`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [DescribeCustomRoutingListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-listener.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-endpoint-group`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [DescribeEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-endpoint-group.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-listener`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) en la Guía para desarrolladores de AWS Global Accelerator.
+ Para obtener información sobre la API, consulte [DescribeListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-listener.html) en la *Referencia de comandos de la AWS CLI*.
### `list-accelerators`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [ListAccelerators](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-accelerators.html) en la *Referencia de comandos de la AWS CLI*.
### `list-byoip-cidr`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [ListByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-byoip-cidr.html) en la *Referencia de comandos de la AWS CLI*.
### `list-custom-routing-accelerators`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [ListCustomRoutingAccelerators](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-accelerators.html) en la *Referencia de comandos de la AWS CLI*.
### `list-custom-routing-endpoint-groups`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [ListCustomRoutingEndpointGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-endpoint-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `list-custom-routing-listeners`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [ListCustomRoutingListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-listeners.html) en la *Referencia de comandos de la AWS CLI*.
### `list-custom-routing-port-mappings-by-destination`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-how-it-works.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [ListCustomRoutingPortMappingsByDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-port-mappings-by-destination.html) en la *Referencia de comandos de la AWS CLI*.
### `list-custom-routing-port-mappings`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-how-it-works.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [ListCustomRoutingPortMappings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-port-mappings.html) en la *Referencia de comandos de la AWS CLI*.
### `list-endpoint-groups`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [ListEndpointGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-endpoint-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `list-listeners`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) en la Guía para desarrolladores de AWS Global Accelerator.
+ Para obtener información sobre la API, consulte [ListListeners](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-listeners.html) en la *Referencia de comandos de la AWS CLI*.
### `list-tags-for-resource`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para ver los detalles de la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-tags-for-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `provision-byoip-cidr`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre de la API, consulte [ProvisionByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/provision-byoip-cidr.html) en la *Referencia de comandos de la AWS CLI*.
### `tag-resource`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/tag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `untag-resource`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/tagging-in-global-accelerator.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/untag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `update-accelerator-attributes`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [UpdateAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-accelerator-attributes.html) en la *Referencia de comandos de la AWS CLI*.
### `update-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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [UpdateAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-accelerator.html) en la *Referencia de comandos de la AWS CLI*.
### `update-custom-routing-accelerator-attributes`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre de la API, consulte [UpdateCustomRoutingAcceleratorAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-accelerator-attributes.html) en la *Referencia de comandos de la AWS CLI*.
### `update-custom-routing-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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [UpdateCustomRoutingAccelerator](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-accelerator.html) en la *Referencia de comandos de la AWS CLI*.
### `update-custom-routing-listener`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [UpdateCustomRoutingListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-listener.html) en la *Referencia de comandos de la AWS CLI*.
### `update-endpoint-group`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [UpdateEndpointGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-endpoint-group.html) en la *Referencia de comandos de la AWS CLI*.
### `update-listener`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) en la Guía para desarrolladores de AWS Global Accelerator.
+ Para obtener información sobre la API, consulte [UpdateListener](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-listener.html) en la *Referencia de comandos de la AWS CLI*.
### `withdraw-byoip-cidr`
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](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) en la *Guía para desarrolladores de AWS Global Accelerator*.
+ Para obtener información sobre la API, consulte [WithdrawByoipCidr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/withdraw-byoip-cidr.html) en la *Referencia de comandos de la AWS CLI*.