Hay más ejemplos de AWS SDK disponibles en el repositorio de ejemplos de [AWS Doc SDK. ](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplos de Global Accelerator que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface con Global Accelerator.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `agregar puntos finales de enrutamiento personalizados`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-custom-routing-endpoints`.
**AWS CLI**
**Para agregar un punto de conexión de subred de VPC a un grupo de puntos de conexión para un acelerador de enrutamiento personalizado**
En el siguiente ejemplo de `add-custom-routing-endpoints`, se agrega un punto de conexión de subred de VPC a un grupo de puntos de conexión para un acelerador de enrutamiento personalizado.
```
aws globalaccelerator add-custom-routing-endpoints \
--endpoint-group-arn {{arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd}} \
--endpoint-configurations {{"EndpointId=subnet-1234567890abcdef0"}}
```
Salida:
```
{
"EndpointDescriptions": [
{
"EndpointId": "subnet-1234567890abcdef0"
}
],
"EndpointGroupArn":"arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/4321abcd"
}
```
Para obtener más información, consulte los puntos de enlace de subred de la [ VPC para aceleradores de enrutamiento personalizados en Global Accelerator, en la guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) *AWS *
+ Para obtener más información sobre la API, consulta [ AddCustomRoutingEndpoints ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/add-custom-routing-endpoints.html) la sección de referencia de comandos. *AWS CLI *
### `anunciar-por-oip-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 `advertise-byoip-cidr` ejemplo, se solicita AWS anunciar un rango de direcciones que has aprovisionado para su uso con tus recursos. AWS
```
aws globalaccelerator advertise-byoip-cidr \
--cidr {{198.51.100.0/24}}
```
Salida:
```
{
"ByoipCidr": {
"Cidr": "198.51.100.0/24",
"State": "PENDING_ADVERTISING"
}
}
```
Para obtener más información, consulte [ Traiga su propia dirección IP en AWS Global Accelerator ](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) en la guía * para desarrolladores de *AWS Global Accelerator.
+ Para obtener más información sobre la API, consulte [ AdvertiseByoipCidr ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/advertise-byoip-cidr.html) la sección de referencia de *AWS CLI comandos*.
### `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 los puntos de enlace de subred de la [ VPC para los aceleradores de enrutamiento personalizados en Global Accelerator, en la guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) *AWS *
+ Para obtener más información sobre la API, consulta [ AllowCustomRoutingTraffic ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/allow-custom-routing-traffic.html) la sección de referencia de comandos. *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 [ los aceleradores en AWS Global Accelerator en la guía para ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) desarrolladores de *AWS Global Accelerator. *
+ Para obtener más información sobre la API, consulta la sección [ CreateAccelerator ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-accelerator.html) de referencia * de *AWS CLI comandos.
### `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 los aceleradores de enrutamiento [ personalizados en Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator. ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *AWS *
+ Para obtener más información sobre la API, consulte [ CreateCustomRoutingAccelerator ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-accelerator.html) la Referencia * de *AWS CLI comandos.
### `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 los grupos de [ terminales para aceleradores de enrutamiento personalizados en Global Accelerator en la guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) *AWS *
+ Para obtener más información sobre la API, consulte la sección [ CreateCustomRoutingEndpointGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-endpoint-group.html) de referencia * de *AWS CLI comandos.
### `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 [ Listeners para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) *AWS *
+ Para obtener más información sobre la API, consulta la sección de [ CreateCustomRoutingListener ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-custom-routing-listener.html) referencia de *AWS CLI comandos. *
### `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 los grupos de [ terminales de Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html). *AWS *
+ Para obtener más información sobre la API, consulte [ CreateEndpointGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-endpoint-group.html) la sección de referencia de *AWS CLI comandos*.
### `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 [ Listeners in AWS Global Accelerator ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) en la Guía para desarrolladores de Global Accelerator. *AWS *
+ Para obtener más información sobre la API, consulte la sección [ CreateListener ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/create-listener.html) de referencia * de *AWS CLI comandos.
### `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 los puntos de enlace de subred de la [ VPC para aceleradores de enrutamiento personalizados en Global Accelerator, en la guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoints.html) *AWS *
+ Para obtener más información sobre la API, consulta [ DenyCustomRoutingTraffic ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/deny-custom-routing-traffic.html) la sección de referencia de comandos. *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 `deprovision-byoip-cidr` ejemplo, se publica el rango de direcciones especificado que aprovisionaste para usarlo con tus recursos. AWS
```
aws globalaccelerator deprovision-byoip-cidr \
--cidr {{"198.51.100.0/24"}}
```
Salida:
```
{
"ByoipCidr": {
"Cidr": "198.51.100.0/24",
"State": "PENDING_DEPROVISIONING"
}
}
```
Para obtener más información, consulte Incluya [ su propia dirección IP en AWS Global Accelerator ](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) en la Guía * para desarrolladores de *AWS Global Accelerator.
+ Para obtener más información sobre la API, consulte [ DeprovisionByoipCidr ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/deprovision-byoip-cidr.html) la sección de referencia de *AWS CLI comandos*.
### `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 los [ aceleradores en AWS Global Accelerator en la guía para desarrolladores de Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html). *AWS *
+ Para obtener más información sobre la API, consulta la sección [ DescribeAcceleratorAttributes ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-accelerator-attributes.html) de referencia * de *AWS CLI comandos.
### `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 [ los aceleradores en AWS Global Accelerator en la guía para desarrolladores de Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html). *AWS *
+ Para obtener más información sobre la API, consulta la sección [ DescribeAccelerator ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-accelerator.html) de referencia * de *AWS CLI comandos.
### `describa los atributos del acelerador de enrutamiento personalizado`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-custom-routing-accelerator-attributes`.
**AWS CLI**
**Para describir los atributos de un acelerador de enrutamiento personalizado**
En el siguiente ejemplo de `describe-custom-routing-accelerator-attributes`, se describen los atributos de un acelerador de enrutamiento personalizado.
```
aws globalaccelerator describe-custom-routing-accelerator-attributes \
--accelerator-arn {{arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh}}
```
Salida:
```
{
"AcceleratorAttributes": {
"FlowLogsEnabled": false
}
}
```
Para obtener más información, consulte los aceleradores de enrutamiento [ personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *AWS *
+ Para obtener más información sobre la API, consulte [ DescribeCustomRoutingAcceleratorAttributes ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-accelerator-attributes.html) la Referencia * de *AWS CLI comandos.
### `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 los aceleradores de enrutamiento [ personalizados en Global Accelerator en AWS la Guía para desarrolladores de Global Accelerator. ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *AWS *
+ Para obtener más información sobre la API, consulte [ DescribeCustomRoutingAccelerator ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-accelerator.html) la Referencia * de *AWS CLI comandos.
### `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 los grupos de [ terminales para aceleradores de enrutamiento personalizados en Global Accelerator en la guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) *AWS *
+ Para obtener más información sobre la API, consulte la sección [ DescribeCustomRoutingEndpointGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-endpoint-group.html) de referencia * de *AWS CLI comandos.
### `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 [ Listeners para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) *AWS *
+ Para obtener más información sobre la API, consulta la sección de [ DescribeCustomRoutingListener ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-custom-routing-listener.html) referencia de *AWS CLI comandos. *
### `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 los grupos de [ terminales de Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html). *AWS *
+ Para obtener más información sobre la API, consulte [ DescribeEndpointGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-endpoint-group.html) la sección de referencia de *AWS CLI comandos*.
### `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 [ Listeners in AWS Global Accelerator ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) en la Guía para desarrolladores de Global Accelerator. *AWS *
+ Para obtener más información sobre la API, consulte la sección [ DescribeListener ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/describe-listener.html) de referencia * de *AWS CLI comandos.
### `aceleradores de listas`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-accelerators`.
**AWS CLI**
**Para describir de los aceleradores**
El siguiente `list-accelerators` ejemplo muestra los aceleradores de tu cuenta. AWS Esta cuenta tiene dos aceleradores.
```
aws globalaccelerator list-accelerators
```
Salida:
```
{
"Accelerators": [
{
"AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/5555abcd-abcd-5555-abcd-5555EXAMPLE1",
"Name": "TestAccelerator",
"IpAddressType": "IPV4",
"Enabled": true,
"IpSets": [
{
"IpFamily": "IPv4",
"IpAddresses": [
"192.0.2.250",
"198.51.100.52"
]
}
],
"DnsName": "5a5a5a5a5a5a5a5a.awsglobalaccelerator.com",
"Status": "DEPLOYED",
"CreatedTime": 1552424416.0,
"LastModifiedTime": 1569375641.0
},
{
"AcceleratorArn": "arn:aws:globalaccelerator::888888888888:accelerator/8888abcd-abcd-8888-abcd-8888EXAMPLE2",
"Name": "ExampleAccelerator",
"IpAddressType": "IPV4",
"Enabled": true,
"IpSets": [
{
"IpFamily": "IPv4",
"IpAddresses": [
"192.0.2.100",
"198.51.100.10"
]
}
],
"DnsName": "6a6a6a6a6a6a6a.awsglobalaccelerator.com",
"Status": "DEPLOYED",
"CreatedTime": 1575585564.0,
"LastModifiedTime": 1579809243.0
},
]
}
```
Para obtener más información, consulta [ los aceleradores en AWS Global Accelerator ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) en la guía para desarrolladores de *AWS Global Accelerator. *
+ Para obtener más información sobre la API, consulta la sección [ ListAccelerators ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-accelerators.html) de referencia * de *AWS CLI comandos.
### `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 [ Incluya su propia dirección IP en Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html). *AWS *
+ Para obtener más información sobre la API, consulte [ ListByoipCidr ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-byoip-cidr.html) la sección de referencia de *AWS CLI comandos*.
### `lista de aceleradores de enrutamiento personalizados`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-custom-routing-accelerators`.
**AWS CLI**
**Para enumerar sus aceleradores de enrutamiento personalizados**
El siguiente `list-custom-routing-accelerators` ejemplo muestra los aceleradores de enrutamiento personalizados de una cuenta. AWS
```
aws globalaccelerator list-custom-routing-accelerators
```
Salida:
```
{
"Accelerators": [
{
"AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/5555abcd-abcd-5555-abcd-5555EXAMPLE1",
"Name": "TestCustomRoutingAccelerator",
"IpAddressType": "IPV4",
"Enabled": true,
"IpSets": [
{
"IpFamily": "IPv4",
"IpAddresses": [
"192.0.2.250",
"198.51.100.52"
]
}
],
"DnsName": "5a5a5a5a5a5a5a5a.awsglobalaccelerator.com",
"Status": "DEPLOYED",
"CreatedTime": 1552424416.0,
"LastModifiedTime": 1569375641.0
},
{
"AcceleratorArn": "arn:aws:globalaccelerator::888888888888:accelerator/8888abcd-abcd-8888-abcd-8888EXAMPLE2",
"Name": "ExampleCustomRoutingAccelerator",
"IpAddressType": "IPV4",
"Enabled": true,
"IpSets": [
{
"IpFamily": "IPv4",
"IpAddresses": [
"192.0.2.100",
"198.51.100.10"
]
}
],
"DnsName": "6a6a6a6a6a6a6a.awsglobalaccelerator.com",
"Status": "DEPLOYED",
"CreatedTime": 1575585564.0,
"LastModifiedTime": 1579809243.0
},
]
}
```
Para obtener más información, consulte los aceleradores de enrutamiento [ personalizados en AWS Global Accelerator ](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 más información sobre la API, consulte [ ListCustomRoutingAccelerators ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-accelerators.html) la Referencia * de *AWS CLI comandos.
### `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 los grupos de [ terminales para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-endpoint-groups.html) *AWS *
+ Para obtener más información sobre la API, consulte la sección [ ListCustomRoutingEndpointGroups ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-endpoint-groups.html) de referencia * de *AWS CLI comandos.
### `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 [ Listeners para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) *AWS *
+ Para obtener más información sobre la API, consulta la sección de [ ListCustomRoutingListeners ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-listeners.html) referencia de *AWS CLI comandos. *
### `liste los mapeos de puertos de enrutamiento personalizado por destino`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-custom-routing-port-mappings-by-destination`.
**AWS CLI**
**Para enumerar una lista de las asignaciones de puertos para un destino de acelerador de enrutamiento personalizado**
En el siguiente ejemplo de `list-custom-routing-port-mappings-by-destination`, se proporcionan las asignaciones de puertos para un servidor EC2 de destino específico (en la dirección de destino) para un acelerador de enrutamiento personalizado.
```
aws globalaccelerator list-custom-routing-port-mappings-by-destination \
--endpoint-id {{subnet-abcd123example}} \
--destination-address {{198.51.100.52}}
```
Salida:
```
{
"DestinationPortMappings": [
{
"AcceleratorArn": "arn:aws:globalaccelerator::402092451327:accelerator/24ea29b8-d750-4489-8919-3095f3c4b0a7",
"AcceleratorSocketAddresses": [
{
"IpAddress": "192.0.2.250",
"Port": 65514
},
{
"IpAddress": "192.10.100.99",
"Port": 65514
}
],
"EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/ab88888example",
"EndpointId": "subnet-abcd123example",
"EndpointGroupRegion": "us-west-2",
"DestinationSocketAddress": {
"IpAddress": "198.51.100.52",
"Port": 80
},
"IpAddressType": "IPv4",
"DestinationTrafficState": "ALLOW"
}
]
}
```
Para obtener más información, consulte [ Cómo funcionan los aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-how-it-works.html) *AWS *
+ Para obtener más información sobre la API, consulta la sección [ ListCustomRoutingPortMappingsByDestination ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-port-mappings-by-destination.html) de referencia * de *AWS CLI comandos.
### `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 Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-how-it-works.html) *AWS *
+ Para obtener más información sobre la API, consulta la sección [ ListCustomRoutingPortMappings ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-custom-routing-port-mappings.html) de referencia * de *AWS CLI comandos.
### `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 los grupos de [ terminales de Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html). *AWS *
+ Para obtener más información sobre la API, consulte [ ListEndpointGroups ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-endpoint-groups.html) la Referencia de *AWS CLI comandos*.
### `list-oyentes`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-listeners`.
**AWS CLI**
**Para enumerar los oyentes**
En el siguiente ejemplo de `list-listeners`, se enumeran los oyentes para un acelerador.
```
aws globalaccelerator list-listeners \
--accelerator-arn {{arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh}}
```
Salida:
```
{
"Listeners": [
{
"ListenerArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/abcdef1234",
"PortRanges": [
{
"FromPort": 80,
"ToPort": 80
}
],
"Protocol": "TCP",
"ClientAffinity": "NONE"
}
]
}
```
Para obtener más información, consulte [ Listeners in AWS Global Accelerator ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) en la Guía para desarrolladores de Global Accelerator. *AWS *
+ Para obtener más información sobre la API, consulte la sección [ ListListeners ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-listeners.html) de referencia * de *AWS CLI comandos.
### `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 \
--resource-arn {{arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh}}
```
Salida:
```
{
"Tags": [
{
"Key": "Project",
"Value": "A123456"
}
]
}
```
Para obtener más información, consulte [ Etiquetar en AWS Global Accelerator ](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 obtener más información sobre la API, consulta la sección [ ListTagsForResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/list-tags-for-resource.html) de referencia * de *AWS CLI comandos.
### `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**
El siguiente `provision-byoip-cidr` ejemplo aprovisiona el rango de direcciones especificado para usarlo con sus recursos. AWS
```
aws globalaccelerator provision-byoip-cidr \
--cidr {{192.0.2.250/24}} \
--cidr-authorization-context Message="$text_message",Signature="$signed_message"
```
Salida:
```
{
"ByoipCidr": {
"Cidr": "192.0.2.250/24",
"State": "PENDING_PROVISIONING"
}
}
```
Para obtener más información, consulte [ Incluya su propia dirección IP en AWS Global Accelerator ](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) en la Guía para desarrolladores de *AWS Global Accelerator*.
+ Para obtener más información sobre la API, consulte [ ProvisionByoipCidr ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/provision-byoip-cidr.html) la sección de referencia de *AWS CLI comandos*.
### `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 obtener más información sobre la API, consulta la sección [ TagResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/tag-resource.html) de referencia * de *AWS CLI comandos.
### `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 [ Etiquetar 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 obtener más información sobre la API, consulta la sección [ UntagResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/untag-resource.html) de referencia * de *AWS CLI comandos.
### `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 los [ aceleradores en AWS Global Accelerator en la guía para desarrolladores de Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html). *AWS *
+ Para obtener más información sobre la API, consulta la sección [ UpdateAcceleratorAttributes ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-accelerator-attributes.html) de referencia * de *AWS CLI comandos.
### `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 [ los aceleradores en AWS Global Accelerator en la guía para ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-accelerators.html) desarrolladores de *AWS Global Accelerator. *
+ Para obtener más información sobre la API, consulta la sección [ UpdateAccelerator ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-accelerator.html) de referencia * de *AWS CLI comandos.
### `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 los aceleradores de enrutamiento [ personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *AWS *
+ Para obtener más información sobre la API, consulte [ UpdateCustomRoutingAcceleratorAttributes ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-accelerator-attributes.html) la Referencia * de *AWS CLI comandos.
### `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 los aceleradores de enrutamiento [ personalizados en Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator. ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-accelerators.html) *AWS *
+ Para obtener más información sobre la API, consulte [ UpdateCustomRoutingAccelerator ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-accelerator.html) la Referencia * de *AWS CLI comandos.
### `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 [ Listeners para aceleradores de enrutamiento personalizados en Global Accelerator en la Guía para desarrolladores de Global Accelerator. AWS](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-custom-routing-listeners.html) *AWS *
+ Para obtener más información sobre la API, consulta la sección de [ UpdateCustomRoutingListener ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-custom-routing-listener.html) referencia de *AWS CLI comandos. *
### `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 los grupos de [ terminales de Global Accelerator en la Guía para desarrolladores de AWS Global Accelerator](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoint-groups.html). *AWS *
+ Para obtener más información sobre la API, consulte [ UpdateEndpointGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-endpoint-group.html) la Referencia de *AWS CLI comandos*.
### `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 [ Listeners in AWS Global Accelerator ](https://docs.aws.amazon.com/global-accelerator/latest/dg/about-listeners.html) en la Guía para desarrolladores de Global Accelerator. *AWS *
+ Para obtener más información sobre la API, consulte la sección [ UpdateListener ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/update-listener.html) de referencia * de *AWS CLI comandos.
### `draw-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**
El siguiente `withdraw-byoip-cidr` ejemplo retira un intervalo de direcciones de AWS Global Accelerator que anunciaste anteriormente para su uso con tus recursos. AWS
```
aws globalaccelerator withdraw-byoip-cidr \
--cidr {{192.0.2.250/24}}
```
Salida:
```
{
"ByoipCidr": {
"Cidr": "192.0.2.250/24",
"State": "PENDING_WITHDRAWING"
}
}
```
Para obtener más información, consulte Incluya [ su propia dirección IP en AWS Global Accelerator ](https://docs.aws.amazon.com/global-accelerator/latest/dg/using-byoip.html) en la Guía para desarrolladores de *AWS Global Accelerator. *
+ Para obtener más información sobre la API, consulte [ WithdrawByoipCidr ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/globalaccelerator/withdraw-byoip-cidr.html) la sección de referencia de *AWS CLI comandos*.