Exemplos do Global Accelerator usando AWS CLI - AWS Exemplos de código do SDK
Ações

Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplos do Global Accelerator usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Global Accelerator.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar add-custom-routing-endpoints.

AWS CLI

Para adicionar um endpoint de sub-rede VPC a um grupo de endpoints para um acelerador de roteamento personalizado

O exemplo add-custom-routing-endpoints a seguir adiciona um endpoint de sub-rede VPC a um grupo de endpoints para um acelerador de roteamento 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"

Saída:

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

Para obter mais informações, consulte endpoints de sub-rede VPC para aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide.AWS

O código de exemplo a seguir mostra como usar advertise-byoip-cidr.

AWS CLI

Anunciar um intervalo de endereços

O advertise-byoip-cidr exemplo a seguir solicita AWS a publicidade de um intervalo de endereços que você provisionou para uso com seus recursos. AWS 

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

Saída:

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

Para obter mais informações, consulte Traga seu próprio endereço IP no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte AdvertiseByoipCidrem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar allow-custom-routing-traffic.

AWS CLI

Para permitir o tráfego para destinos específicos de EC2 instâncias da Amazon em uma sub-rede VPC para um acelerador de roteamento personalizado

O allow-custom-routing-traffic exemplo a seguir especifica que o tráfego é permitido para determinados endereços IP da EC2 instância (destino) da Amazon e portas para que um endpoint de sub-rede VPC em um acelerador de roteamento personalizado possa receber tráfego.

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 não produz saída.

Para obter mais informações, consulte endpoints de sub-rede VPC para aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide.AWS

O código de exemplo a seguir mostra como usar create-accelerator.

AWS CLI

Criar um acelerador

O exemplo create-accelerator a seguir cria um acelerador de duas marcas com dois endereços IP estáticos BYOIP. É necessário especificar a região US-West-2 (Oregon) para criar ou atualizar um 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

Saída:

{
    "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 obter mais informações, consulte Aceleradores no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte CreateAcceleratorem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-custom-routing-accelerator.

AWS CLI

Criar um acelerador de roteamento personalizado

O exemplo create-custom-routing-accelerator a seguir cria um acelerador de roteamento personalizado com as marcas Name e 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

Saída:

{
    "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 obter mais informações, consulte Aceleradores de roteamento personalizados no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar create-custom-routing-endpoint-group.

AWS CLI

Criar um grupo de endpoints para um acelerador de roteamento personalizado

O exemplo create-custom-routing-endpoint-group a seguir cria um grupo de endpoints para um acelerador de roteamento 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"

Saída:

{
    "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 obter mais informações, consulte Grupos de endpoints para aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide AWS .

O código de exemplo a seguir mostra como usar create-custom-routing-listener.

AWS CLI

Criar um receptor para acelerador de roteamento personalizado

O exemplo create-custom-routing-listener a seguir cria um receptor com um intervalo de portas de 5.000 a 10.000 para um acelerador de roteamento 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

Saída:

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

Para obter mais informações, consulte Ouvintes de aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide AWS .

O código de exemplo a seguir mostra como usar create-endpoint-group.

AWS CLI

Criar um grupo de endpoints

O exemplo create-endpoint-group a seguir cria um grupo de endpoints com um endpoint.

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

Saída:

{
    "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 obter mais informações, consulte Grupos de endpoints no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar create-listener.

AWS CLI

Criar um receptor

O exemplo create-listener a seguir cria um receptor com duas portas.

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

Saída:

{
    "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 obter mais informações, consulte Listeners in AWS Global Accelerator no Global Accelerator AWS Developer Guide.

  • Para obter detalhes da API, consulte CreateListenerem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar deny-custom-routing-traffic.

AWS CLI

Especificar um endereço de destino que não pode receber tráfego em um acelerador de roteamento personalizado

O exemplo deny-custom-routing-traffic a seguir especifica o endereço ou endereços de destino em um endpoint de sub-rede sem condições de receber tráfego para um acelerador de roteamento personalizado. Para especificar mais de um endereço de destino, separe-os com um espaço. Não há resposta para uma deny-custom-routing-traffic chamada bem-sucedida.

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 não produz saída.

Para obter mais informações, consulte endpoints de sub-rede VPC para aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide.AWS

O código de exemplo a seguir mostra como usar deprovision-byoip-cidr.

AWS CLI

Desprovisionar um intervalo de endereços

O deprovision-byoip-cidr exemplo a seguir libera o intervalo de endereços especificado que você provisionou para usar com seus AWS recursos.

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

Saída:

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

Para obter mais informações, consulte Traga seu próprio endereço IP no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar describe-accelerator-attributes.

AWS CLI

Descrever os atributos de um acelerador

O exemplo describe-accelerator-attributes a seguir recupera os atributos de um acelerador.

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

Saída:

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

Para obter mais informações, consulte Aceleradores no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar describe-accelerator.

AWS CLI

Descrever um acelerador

O exemplo describe-accelerator a seguir recupera detalhes de um acelerador específico.

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

Saída:

{
    "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 obter mais informações, consulte Aceleradores no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar describe-custom-routing-accelerator-attributes.

AWS CLI

Descrever os atributos de um acelerador de roteamento personalizado

O exemplo describe-custom-routing-accelerator-attributes a seguir descreve os atributos de um acelerador de roteamento personalizado.

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

Saída:

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

Para obter mais informações, consulte Aceleradores de roteamento personalizados no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar describe-custom-routing-accelerator.

AWS CLI

Descrever um acelerador de roteamento personalizado

O exemplo describe-custom-routing-accelerator a seguir recupera detalhes de um dado acelerador de roteamento personalizado.

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

Saída:

{
    "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 obter mais informações, consulte Aceleradores de roteamento personalizados no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar describe-custom-routing-endpoint-group.

AWS CLI

Descrever um grupo de endpoints para um acelerador de roteamento personalizado

O exemplo describe-custom-routing-endpoint-group a seguir descreve um grupo de endpoints para um acelerador de roteamento 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

Saída:

{
    "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 obter mais informações, consulte Grupos de endpoints para aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide AWS .

O código de exemplo a seguir mostra como usar describe-custom-routing-listener.

AWS CLI

Descrever um receptor para um acelerador de roteamento personalizado

O exemplo describe-custom-routing-listener a seguir descreve um receptor para um acelerador de roteamento personalizado.

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

Saída:

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

Para obter mais informações, consulte Ouvintes de aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide AWS .

O código de exemplo a seguir mostra como usar describe-endpoint-group.

AWS CLI

Descrever um grupo de endpoints

O describe-endpoint-group exemplo a seguir recupera detalhes sobre um grupo de endpoints com os seguintes endpoints: uma EC2 instância da Amazon, um ALB e um 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

Saída:

{
    "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 obter mais informações, consulte Grupos de endpoints no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar describe-listener.

AWS CLI

Descrever um receptor

O exemplo describe-listener a seguir descreve um receptor.

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

Saída:

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

Para obter mais informações, consulte Listeners in AWS Global Accelerator no Global Accelerator AWS Developer Guide.

  • Para obter detalhes da API, consulte DescribeListenerem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-accelerators.

AWS CLI

Listar seus aceleradores

O list-accelerators exemplo a seguir lista os aceleradores em sua AWS conta. Esta conta tem dois aceleradores.

aws globalaccelerator list-accelerators

Saída:

{
    "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 obter mais informações, consulte Aceleradores no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte ListAcceleratorsem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-byoip-cidr.

AWS CLI

Listar seus intervalos de endereço

O exemplo list-byoip-cidr a seguir lista os intervalos de endereços do tipo use seu próprio endereço IP (BYOIP) que você forneceu para uso com o Global Accelerator.

aws globalaccelerator list-byoip-cidrs

Saída:

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

Para obter mais informações, consulte Traga seu próprio endereço IP no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte ListByoipCidrem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-custom-routing-accelerators.

AWS CLI

Listar seus aceleradores de roteamento personalizados

O list-custom-routing-accelerators exemplo a seguir lista os aceleradores de roteamento personalizados em uma AWS conta.

aws globalaccelerator list-custom-routing-accelerators

Saída:

{
    "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 obter mais informações, consulte Aceleradores de roteamento personalizados no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar list-custom-routing-endpoint-groups.

AWS CLI

Listar grupos de endpoints para um receptor em um acelerador de roteamento personalizado

O exemplo list-custom-routing-endpoint-groups a seguir lista os grupos de endpoints para um receptor em um acelerador de roteamento personalizado.

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

Saída:

{
    "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 obter mais informações, consulte Grupos de endpoints para aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide AWS .

O código de exemplo a seguir mostra como usar list-custom-routing-listeners.

AWS CLI

Listar receptores para aceleradores de roteamento personalizados

O exemplo list-custom-routing-listeners a seguir lista os receptores para um acelerador de roteamento personalizado.

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

Saída:

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

Para obter mais informações, consulte Ouvintes de aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide AWS .

O código de exemplo a seguir mostra como usar list-custom-routing-port-mappings-by-destination.

AWS CLI

Para listar os mapeamentos de porta para um destino específico do acelerador de roteamento personalizado

O list-custom-routing-port-mappings-by-destination exemplo a seguir fornece os mapeamentos de portas para um EC2 servidor de destino específico (no endereço de destino) para um acelerador de roteamento personalizado.

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

Saída:

{
    "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 obter mais informações, consulte Como os aceleradores de roteamento personalizados funcionam no AWS Global Accelerator no Global Accelerator Developer AWS Guide.

O código de exemplo a seguir mostra como usar list-custom-routing-port-mappings.

AWS CLI

Listar mapeamentos de porta em um acelerador de roteamento personalizado

O exemplo list-custom-routing-port-mappings a seguir fornece uma lista parcial de mapeamentos de portas em um acelerador de roteamento personalizado.

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

Saída:

{
    "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 obter mais informações, consulte Como os aceleradores de roteamento personalizados funcionam no AWS Global Accelerator no Global Accelerator Developer AWS Guide.

O código de exemplo a seguir mostra como usar list-endpoint-groups.

AWS CLI

Listar grupos de endpoints

O exemplo list-endpoint-groups a seguir lista os grupos de endpoints de um receptor. Este receptor tem dois grupos de endpoints.

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

Saída:

{
    "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 obter mais informações, consulte Endpoint Groups no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte ListEndpointGroupsem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-listeners.

AWS CLI

Listar receptores

O exemplo list-listeners a seguir lista os receptores de um acelerador.

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

Saída:

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

Para obter mais informações, consulte Listeners in AWS Global Accelerator no Global Accelerator AWS Developer Guide.

  • Para obter detalhes da API, consulte ListListenersem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-tags-for-resource.

AWS CLI

Listar marcas para um acelerador

O exemplo list-tags-for-resource a seguir lista as marcas de um acelerador específico.

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

Saída:

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

Para obter mais informações, consulte Marcação no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar provision-byoip-cidr.

AWS CLI

Provisionar um intervalo de endereços

O provision-byoip-cidr exemplo a seguir provisiona o intervalo de endereços especificado para uso com seus AWS recursos.

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

Saída:

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

Para obter mais informações, consulte Traga seu próprio endereço IP no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte ProvisionByoipCidrem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar tag-resource.

AWS CLI

Marcar um acelerador

O exemplo tag-resource a seguir adiciona as marcas Nome e Projeto a um acelerador, além dos valores correspondentes a cada uma.

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 não produz saída.

Para obter mais informações, consulte Marcação no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte TagResourceem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar untag-resource.

AWS CLI

Remover marca de um acelerador

O exemplo untag-resource a seguir remove as marcas Nome e Projeto de um 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 não produz saída.

Para obter mais informações, consulte Marcação no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte UntagResourceem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-accelerator-attributes.

AWS CLI

Atualizar os atributos de um acelerador

O exemplo update-accelerator-attributes a seguir atualiza um acelerador para ativar logs de fluxo. É preciso especificar a US-West-2 (Oregon) região para criar ou atualizar os atributos do 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

Saída:

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

Para obter mais informações, consulte Aceleradores no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar update-accelerator.

AWS CLI

Atualizar um acelerador

O exemplo update-accelerator a seguir modifica um acelerador para alterar seu nome para ExampleAcceleratorNew. É necessário especificar a região US-West-2 (Oregon) para criar ou atualizar aceleradores.

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

Saída:

{
    "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 obter mais informações, consulte Aceleradores no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte UpdateAcceleratorem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-custom-routing-accelerator-attributes.

AWS CLI

Atualizar os atributos de um acelerador de roteamento personalizado

O exemplo update-custom-routing-accelerator-attributes a seguir atualiza um acelerador de roteamento personalizado para habilitar logs de fluxo.

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

Saída:

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

Para obter mais informações, consulte Aceleradores de roteamento personalizados no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar update-custom-routing-accelerator.

AWS CLI

Atualizar um acelerador de roteamento personalizado

O exemplo update-custom-routing-accelerator a seguir modifica um acelerador de roteamento personalizado para alterar seu nome.

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

Saída:

{
    "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 obter mais informações, consulte Aceleradores de roteamento personalizados no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar update-custom-routing-listener.

AWS CLI

Atualizar um receptor para um acelerador de roteamento personalizado

O exemplo update-custom-routing-listener a seguir atualiza um receptor para alterar o intervalo de portas.

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

Saída:

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

Para obter mais informações, consulte Ouvintes de aceleradores de roteamento personalizados no Global Accelerator no AWS Global Accelerator Developer Guide AWS .

O código de exemplo a seguir mostra como usar update-endpoint-group.

AWS CLI

Atualizar um grupo de endpoints

O exemplo update-endpoint-group a seguir adiciona três endpoints a um grupo de endpoints: um endereço IP elástico, um ALB e um 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

Saída:

{
    "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 obter mais informações, consulte Grupos de endpoints no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

O código de exemplo a seguir mostra como usar update-listener.

AWS CLI

Atualizar um receptor

O exemplo update-listener a seguir atualiza um receptor para alterar a porta para 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

Saída:

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

Para obter mais informações, consulte Listeners in AWS Global Accelerator no Global Accelerator AWS Developer Guide.

  • Para obter detalhes da API, consulte UpdateListenerem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar withdraw-byoip-cidr.

AWS CLI

Para remover um intervalo de endereços

O withdraw-byoip-cidr exemplo a seguir retira um intervalo de endereços do AWS Global Accelerator que você anunciou anteriormente para uso com seus recursos. AWS 

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

Saída:

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

Para obter mais informações, consulte Traga seu próprio endereço IP no AWS Global Accelerator no Guia do desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte WithdrawByoipCidrem Referência de AWS CLI Comandos.