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

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

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 funções de serviço individuais, é possível ver as ações no contexto em seus cenários relacionados.

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

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 VPC sub-rede a um grupo de endpoints para um acelerador de roteamento personalizado

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

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

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 VPC sub-rede 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 VPC sub-rede 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 VPC sub-rede 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

Para criar um acelerador

O create-accelerator exemplo a seguir cria um acelerador com duas tags com dois endereços IP BYOIP estáticos. Você deve especificar a US-West-2 (Oregon) região 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 API obter detalhes, consulte CreateAcceleratorna Referência de AWS CLI Comandos.

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

AWS CLI

Para criar um acelerador de roteamento personalizado

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

Para criar um grupo de endpoints para um acelerador de roteamento personalizado

O create-custom-routing-endpoint-group exemplo 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

Para criar um ouvinte para um acelerador de roteamento personalizado

O create-custom-routing-listener exemplo a seguir cria um ouvinte com um intervalo de portas de 5000 a 10000 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

Para criar um grupo de endpoints

O create-endpoint-group exemplo 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

Para criar um ouvinte

O create-listener exemplo a seguir cria um ouvinte 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 API obter detalhes, consulte CreateListenerna Referência de AWS CLI Comandos.

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

AWS CLI

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

O deny-custom-routing-traffic exemplo a seguir especifica o endereço ou endereços de destino em um endpoint de sub-rede que não pode receber tráfego para um acelerador de roteamento personalizado. Para especificar mais de um endereço de destino, separe os endereç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 VPC sub-rede 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

Para 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

Para descrever os atributos de um acelerador

O describe-accelerator-attributes exemplo a seguir recupera os detalhes do atributo 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

Para descrever um acelerador

O describe-accelerator exemplo a seguir recupera os detalhes sobre o acelerador especificado.

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

Para descrever os atributos de um acelerador de roteamento personalizado

O describe-custom-routing-accelerator-attributes exemplo 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

Para descrever um acelerador de roteamento personalizado

O describe-custom-routing-accelerator exemplo a seguir recupera os detalhes sobre o acelerador de roteamento personalizado especificado.

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

Para descrever um grupo de endpoints para um acelerador de roteamento personalizado

O describe-custom-routing-endpoint-group exemplo 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

Para descrever um ouvinte de um acelerador de roteamento personalizado

O describe-custom-routing-listener exemplo a seguir descreve um ouvinte 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

Para 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 AmazonALB, uma e uma. 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

Para descrever um ouvinte

O describe-listener exemplo a seguir descreve um ouvinte.

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 API obter detalhes, consulte DescribeListenerna Referência de AWS CLI Comandos.

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

AWS CLI

Para listar seus aceleradores

O list-accelerators exemplo a seguir lista os aceleradores em sua AWS conta. Essa 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 API obter detalhes, consulte ListAcceleratorsna Referência de AWS CLI Comandos.

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

AWS CLI

Para listar seus intervalos de endereços

O list-byoip-cidr exemplo a seguir lista os intervalos de endereços traga seu próprio endereço IP (BYOIP) que você provisionou 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 API obter detalhes, consulte ListByoipCidrna Referência de AWS CLI Comandos.

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

AWS CLI

Para 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

Para listar grupos de endpoints para um ouvinte em um acelerador de roteamento personalizado

O list-custom-routing-endpoint-groups exemplo a seguir lista os grupos de endpoints para um ouvinte 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

Para listar ouvintes de aceleradores de roteamento personalizados

O list-custom-routing-listeners exemplo a seguir lista os ouvintes de 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 portas 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

Para listar os mapeamentos de portas em um acelerador de roteamento personalizado

O list-custom-routing-port-mappings exemplo a seguir fornece uma lista parcial dos 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

Para listar grupos de endpoints

O list-endpoint-groups exemplo a seguir lista os grupos de endpoints de um ouvinte. Esse ouvinte 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.

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

AWS CLI

Para listar ouvintes

O list-listeners exemplo a seguir lista os ouvintes 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 API obter detalhes, consulte ListListenersna Referência de AWS CLI Comandos.

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

AWS CLI

Para listar tags para um acelerador

O list-tags-for-resource exemplo a seguir lista as tags 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

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

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

AWS CLI

Para marcar um acelerador

O tag-resource exemplo a seguir adiciona as tags Name e Project a um acelerador, junto com os valores correspondentes para 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 API obter detalhes, consulte TagResourcena Referência de AWS CLI Comandos.

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

AWS CLI

Para remover uma tag de um acelerador

O untag-resource exemplo a seguir remove as tags 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 API obter detalhes, consulte UntagResourcena Referência de AWS CLI Comandos.

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

AWS CLI

Para atualizar os atributos de um acelerador

O update-accelerator-attributes exemplo a seguir atualiza um acelerador para ativar os registros de fluxo. Você deve 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

Para atualizar um acelerador

O update-accelerator exemplo a seguir modifica um acelerador para alterar o nome do acelerador para. ExampleAcceleratorNew Você deve especificar a US-West-2 (Oregon) região 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 API obter detalhes, consulte UpdateAcceleratorna Referência de AWS CLI Comandos.

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

AWS CLI

Para atualizar os atributos de um acelerador de roteamento personalizado

O update-custom-routing-accelerator-attributes exemplo a seguir atualiza um acelerador de roteamento personalizado para habilitar registros 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

Para atualizar um acelerador de roteamento personalizado

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

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

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

Para atualizar um ouvinte para um acelerador de roteamento personalizado

O update-custom-routing-listener exemplo a seguir atualiza um ouvinte 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

Para atualizar um grupo de endpoints

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

Para atualizar um ouvinte

O update-listener exemplo a seguir atualiza um ouvinte 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 API obter detalhes, consulte UpdateListenerna Referência de AWS CLI Comandos.

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

AWS CLI

Para retirar 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 API obter detalhes, consulte WithdrawByoipCidrna Referência de AWS CLI Comandos.