Exemplos do Global Accelerator usando AWS CLI - AWS Command Line Interface
Ações

Exemplos do Global Accelerator usando AWS CLI

Os exemplos de código a seguir mostram como executar ações e implementar cenários comuns usando 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 da Amazon VPC para 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 advertise-byoip-cidr.

AWS CLI

Anunciar um intervalo de endereços

O exemplo advertise-byoip-cidr a seguir solicita que AWS anuncie um intervalo de endereços fornecido pelo usuário para ser usado 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 Usar seu próprio endereço IP no AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

  • Para ver detalhes da API, consulte AdvertiseByoipCidr na Referência de comandos da AWS CLI.

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

AWS CLI

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

O exemplo allow-custom-routing-traffic a seguir especifica que o tráfego é permitido para determinados endereços IP e portas de instância (destino) do Amazon EC2 para um endpoint de sub-rede VPC em um acelerador de roteamento personalizado que pode receber o 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 da Amazon VPC para 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-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 ver detalhes da API, consulte CreateAccelerator na Referência de comandos da AWS CLI.

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 AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

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 Receptores de 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-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.

  • Para ver detalhes da API, consulte CreateEndpointGroup na Referência de comandos da AWS CLI.

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 Receptores no AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

  • Para obter detalhes da API, consulte CreateListener na Referência de comandos da AWS CLI.

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 chamada bem-sucedida de negação de tráfego personalizado.

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 da Amazon VPC para 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 deprovision-byoip-cidr.

AWS CLI

Desprovisionar um intervalo de endereços

O exemplo deprovision-byoip-cidr a seguir libera o intervalo de endereços específico fornecido pelo usuário para uso com seus recursos da AWS.

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 Usar 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.

  • Para ver detalhes da API, consulte DescribeAccelerator na Referência de comandos da AWS CLI.

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 AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

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 Receptores de 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-endpoint-group.

AWS CLI

Descrever um grupo de endpoints

O exemplo describe-endpoint-group a seguir recupera detalhes sobre um grupo de endpoints com os seguintes endpoints: uma instância do Amazon EC2, 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 Receptores no AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

  • Para ver detalhes da API, consulte DescribeListener na AWS CLI Referência de comando.

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

AWS CLI

Listar seus aceleradores

O exemplo list-accelerators a seguir lista todos os aceleradores em sua conta da AWS. 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 ver detalhes da API, consulte ListAccelerators na Referência de comandos da AWS CLI.

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 Usar seu próprio endereço IP no AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

  • Para ver detalhes da API, consulte ListByoipCidr na Referência de comandos da AWS CLI.

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

AWS CLI

Listar seus aceleradores de roteamento personalizados

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

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 AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

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 Receptores de 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-port-mappings-by-destination.

AWS CLI

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

O exemplo list-custom-routing-port-mappings-by-destination a seguir fornece mapeamentos de porta para um servidor EC2 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 Guia do Desenvolvedor do AWS Global Accelerator.

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 Guia do Desenvolvedor do AWS Global Accelerator.

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 Grupos de Endpoints no AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

  • Para ver detalhes da API, consulte ListEndpointGroups na Referência de comandos da AWS CLI.

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 Receptores no AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

  • Para ver detalhes da API, consulte ListListeners na Referência de comandos da AWS CLI.

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 exemplo provision-byoip-cidr a seguir fornece o intervalo de endereços específico a ser usado com seus recursos da AWS.

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 Usar seu próprio endereço IP no AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

  • Para ver detalhes da API, consulte ProvisionByoipCidr na Referência de comandos da AWS CLI.

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 TagResource na Referência de comandos da AWS CLI.

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 sobre a API, consulte UntagResource na Referência de comandos da AWS CLI.

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 ver detalhes da API, consulte UpdateAccelerator na Referência de comandos da AWS CLI.

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 Receptores de 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-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.

  • Para ver detalhes da API, consulte UpdateEndpointGroup na Referência de comandos da AWS CLI.

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 Receptores no AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

  • Para ver detalhes da API, consulte UpdateListener na Referência de comandos da AWS CLI.

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

AWS CLI

Para remover um intervalo de endereços

O exemplo withdraw-byoip-cidr a seguir remove do AWS Global Accelerator um intervalo de endereços que você divulgou anteriormente para ser usado com seus recursos da 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 Usar seu próprio endereço IP no AWS Global Accelerator no Guia do Desenvolvedor do AWS Global Accelerator.

  • Para ver detalhes da API, consulte WithdrawByoipCidr na Referência de comandos da AWS CLI.