Esempi di Global Accelerator utilizzando AWS CLI - AWS Command Line Interface
Azioni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di Global Accelerator utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando Global Accelerator. AWS Command Line Interface

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareadd-custom-routing-endpoints.

AWS CLI

Come aggiungere un endpoint di sottorete VPC a un gruppo di endpoint per un acceleratore di instradamento personalizzato

L’esempio add-custom-routing-endpoints seguente aggiunge un endpoint di sottorete VPC a un gruppo di endpoint per un acceleratore di instradamento personalizzato.

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"

Output:

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

Per ulteriori informazioni, consulta gli endpoint di sottorete VPC per acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer Guide.AWS

Il seguente esempio di codice mostra come utilizzareadvertise-byoip-cidr.

AWS CLI

Come pubblicizzare un intervallo di indirizzi

L'advertise-byoip-cidresempio seguente richiede AWS di pubblicizzare un intervallo di indirizzi che hai predisposto per essere utilizzato con le tue AWS risorse.

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

Output:

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

Per ulteriori informazioni, consulta Bring Your Own IP Address in AWS Global Accelerator nella Global Accelerator Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzareallow-custom-routing-traffic.

AWS CLI

Per consentire il traffico verso destinazioni specifiche di EC2 istanze Amazon in una sottorete VPC per un acceleratore di routing personalizzato

L'allow-custom-routing-trafficesempio seguente specifica che il traffico è consentito verso determinati indirizzi IP (destinazione) di EC2 istanze Amazon e che le porte di un endpoint di sottorete VPC in un acceleratore di routing personalizzato possono ricevere traffico.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta gli endpoint di sottorete VPC per acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer Guide.AWS

Il seguente esempio di codice mostra come utilizzarecreate-accelerator.

AWS CLI

Come creare un acceleratore

L’esempio create-accelerator seguente crea un acceleratore con due tag con due indirizzi IP statici BYOIP. È necessario specificare la Regione US-West-2 (Oregon) per creare o aggiornare un acceleratore.

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

Output:

{
    "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
    }
}

Per ulteriori informazioni, consulta Accelerators in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzarecreate-custom-routing-accelerator.

AWS CLI

Come creare un acceleratore di instradamento personalizzato

L’esempio create-custom-routing-accelerator seguente crea un acceleratore di instradamento personalizzato con i tag 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

Output:

{
    "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
    }
}

Per ulteriori informazioni, consulta la sezione Acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzarecreate-custom-routing-endpoint-group.

AWS CLI

Come creare un gruppo di endpoint per un acceleratore di instradamento personalizzato

L’esempio create-custom-routing-endpoint-group seguente crea un gruppo di endpoint per un acceleratore di instradamento personalizzato.

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"

Output:

{
    "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": []
    }
}

Per ulteriori informazioni, consulta Endpoint groups for custom routing accelerators in AWS Global Accelerator nella Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzarecreate-custom-routing-listener.

AWS CLI

Come creare un listener per un acceleratore di instradamento personalizzato

L’esempio create-custom-routing-listener seguente crea un listener con un intervallo di porte compreso tra 5000 e 10000 per un acceleratore di instradamento personalizzato.

aws globalaccelerator create-custom-routing-listener \
    --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --port-ranges FromPort=5000,ToPort=10000

Output:

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

Per ulteriori informazioni, consulta Listeners for custom routing accelerators in AWS Global Accelerator nella Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzarecreate-endpoint-group.

AWS CLI

Come creare un gruppo di endpoint

L’esempio create-endpoint-group seguente crea un gruppo di endpoint con un 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

Output:

{
    "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"
    }
}

Per ulteriori informazioni, consulta Endpoint groups in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzarecreate-listener.

AWS CLI

Come creare un listener

L’esempio create-listener seguente crea un listener con due porte.

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

Output:

{
    "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"
    }
}

Per ulteriori informazioni, consulta Listeners in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

  • Per i dettagli sull'API, consulta Command CreateListenerReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaredeny-custom-routing-traffic.

AWS CLI

Come specificare un indirizzo di destinazione che non può ricevere traffico in un acceleratore di instradamento personalizzato

L’esempio deny-custom-routing-traffic seguente specifica l’indirizzo o gli indirizzi di destinazione in un endpoint di sottorete che non possono ricevere traffico per un acceleratore di instradamento personalizzato. Per specificare più indirizzi di destinazione, separali con uno spazio. Nessuna risposta per una deny-custom-routing-traffic chiamata riuscita.

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"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta gli endpoint di sottorete VPC per acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer Guide.AWS

Il seguente esempio di codice mostra come utilizzaredeprovision-byoip-cidr.

AWS CLI

Come annullare il provisioning di un intervallo di indirizzi

L'deprovision-byoip-cidresempio seguente rilascia l'intervallo di indirizzi specificato che avete predisposto per l'utilizzo con AWS le vostre risorse.

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

Output:

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

Per ulteriori informazioni, consulta Bring your own IP address in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-accelerator-attributes.

AWS CLI

Come descrivere gli attributi di un acceleratore

L’esempio describe-accelerator-attributes seguente recupera i dettagli degli attributi per un acceleratore.

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

Output:

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

Per ulteriori informazioni, consulta Accelerators in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-accelerator.

AWS CLI

Come descrivere un acceleratore

L’esempio describe-accelerator seguente recupera i dettagli sull’acceleratore specificato.

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

Output:

{
    "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
    }
}

Per ulteriori informazioni, consulta Accelerators in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-custom-routing-accelerator-attributes.

AWS CLI

Come descrivere gli attributi di un acceleratore di instradamento personalizzato

L’esempio describe-custom-routing-accelerator-attributes seguente descrive gli attributi per un acceleratore di instradamento personalizzato.

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

Output:

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

Per ulteriori informazioni, consulta la sezione Acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-custom-routing-accelerator.

AWS CLI

Come descrivere un acceleratore di instradamento personalizzato

L’esempio describe-custom-routing-accelerator seguente recupera i dettagli sull’acceleratore di instradamento personalizzato specificato.

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

Output:

{
    "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
    }
}

Per ulteriori informazioni, consulta la sezione Acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-custom-routing-endpoint-group.

AWS CLI

Come descrivere un gruppo di endpoint per un acceleratore di instradamento personalizzato

L’esempio describe-custom-routing-endpoint-group seguente descrive un gruppo di endpoint per un acceleratore di instradamento personalizzato.

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

Output:

{
    "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"
            }
        ]
    }
}

Per ulteriori informazioni, consulta Endpoint groups for custom routing accelerators in AWS Global Accelerator nella Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-custom-routing-listener.

AWS CLI

Come descrivere un listener per un acceleratore di instradamento personalizzato

L’esempio describe-custom-routing-listener seguente descrive un listener per un acceleratore di instradamento personalizzato.

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

Output:

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

Per ulteriori informazioni, consulta Listeners for custom routing accelerators in AWS Global Accelerator nella Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-endpoint-group.

AWS CLI

Come descrivere un gruppo di endpoint

L'describe-endpoint-groupesempio seguente recupera i dettagli su un gruppo di endpoint con i seguenti endpoint: un' EC2 istanza Amazon, un ALB e un NLB.

aws globalaccelerator describe-endpoint-group \
    --endpoint-group-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/ab88888example

Output:

{
    "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"
    }
}

Per ulteriori informazioni, consulta i gruppi di endpoint in Global Accelerator nella AWS Global Accelerator Developer Guide.AWS

Il seguente esempio di codice mostra come utilizzaredescribe-listener.

AWS CLI

Come descrivere un listener

L’esempio describe-listener seguente descrive un listener.

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

Output:

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

Per ulteriori informazioni, consulta Listeners in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzarelist-accelerators.

AWS CLI

Come elencare gli acceleratori

L'list-acceleratorsesempio seguente elenca gli acceleratori presenti nel tuo AWS account. In questo account sono presenti due acceleratori.

aws globalaccelerator list-accelerators

Output:

{
    "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
        },
    ]
}

Per ulteriori informazioni, consulta Accelerators in AWS Global Accelerator nella Global Accelerator Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzarelist-byoip-cidr.

AWS CLI

Come elencare gli intervalli di indirizzi

L’esempio list-byoip-cidr seguente elenca gli intervalli di indirizzi BYOIP (Bring Your Own IP) di cui hai effettuato il provisioning per l’uso con Global Accelerator.

aws globalaccelerator list-byoip-cidrs

Output:

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

Per ulteriori informazioni, consulta Bring your own IP address in AWS Global Accelerator nella Global Accelerator Developer Guide.AWS

  • Per i dettagli sull'API, consulta AWS CLI Command ListByoipCidrReference.

Il seguente esempio di codice mostra come utilizzarelist-custom-routing-accelerators.

AWS CLI

Come elencare i tuoi acceleratori di instradamento personalizzati

L'list-custom-routing-acceleratorsesempio seguente elenca gli acceleratori di routing personalizzati in un AWS account.

aws globalaccelerator list-custom-routing-accelerators

Output:

{
    "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
        },
    ]
}

Per ulteriori informazioni, consulta la sezione Acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzarelist-custom-routing-endpoint-groups.

AWS CLI

Come elencare i gruppi di endpoint per un listener in un acceleratore di instradamento personalizzato

L’esempio list-custom-routing-endpoint-groups seguente elenca i gruppi di endpoint per un listener in un acceleratore di instradamento personalizzato.

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

Output:

{
    "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"
                }
            ]
        }
    ]
}

Per ulteriori informazioni, consulta Endpoint groups for custom routing accelerators in AWS Global Accelerator nella Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzarelist-custom-routing-listeners.

AWS CLI

Come elencare i listener per gli acceleratori di instradamento personalizzati

L’esempio list-custom-routing-listeners seguente elenca i listener per un acceleratore di instradamento personalizzato.

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

Output:

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

Per ulteriori informazioni, consulta Listeners for custom routing accelerators in AWS Global Accelerator nella Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzarelist-custom-routing-port-mappings-by-destination.

AWS CLI

Come elencare le mappature delle porte per una determinata destinazione dell’acceleratore di instradamento personalizzato

L'list-custom-routing-port-mappings-by-destinationesempio seguente fornisce le mappature delle porte per un EC2 server di destinazione specifico (all'indirizzo di destinazione) per un acceleratore di routing personalizzato.

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

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Come funzionano gli acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer Guide.AWS

Il seguente esempio di codice mostra come utilizzarelist-custom-routing-port-mappings.

AWS CLI

Come elencare le mappature delle porte in un acceleratore di instradamento personalizzato

L’esempio list-custom-routing-port-mappings seguente fornisce un elenco parziale delle mappature delle porte in un acceleratore di instradamento personalizzato.

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

Output:

{
    "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"
        }
    ]
}

Per ulteriori informazioni, consulta Come funzionano gli acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzarelist-endpoint-groups.

AWS CLI

Come elencare i gruppi di endpoint

L’esempio list-endpoint-groups seguente elenca i gruppi di endpoint per un listener. In questo listener sono presenti due gruppi di endpoint.

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

Output:

{
    "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
        }
    ]
}

Per ulteriori informazioni, consulta Endpoint Groups in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzarelist-listeners.

AWS CLI

Come elencare i listener

L’esempio list-listeners seguente elenca i listener per un acceleratore.

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

Output:

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

Per ulteriori informazioni, consulta Listeners in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

  • Per i dettagli sull'API, consulta Command ListListenersReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come elencare i tag per un acceleratore

L’esempio list-tags-for-resource seguente elenca i tag per un determinato acceleratore.

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

Output:

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

Per ulteriori informazioni, consulta Tagging in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzareprovision-byoip-cidr.

AWS CLI

Come effettuare il provisioning di un intervallo di indirizzi

L'provision-byoip-cidresempio seguente fornisce l'intervallo di indirizzi specificato da utilizzare con le AWS risorse.

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

Output:

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

Per ulteriori informazioni, consulta Bring your own IP address in AWS Global Accelerator nella Global Accelerator Developer Guide.AWS

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come taggare un acceleratore

L’esempio tag-resource seguente aggiunge i tag Name e Project a un acceleratore, nonché i valori corrispondenti per ciascuno di essi.

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"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

  • Per i dettagli sull'API, consulta Command TagResourceReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere un tag da un acceleratore

L’esempio untag-resource seguente rimuove i tag Name e Project da un acceleratore.

aws globalaccelerator untag-resource \
    --resource-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh \
    --tag-keys Key="Name" Key="Project"

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagging in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

  • Per i dettagli sull'API, consulta Command UntagResourceReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareupdate-accelerator-attributes.

AWS CLI

Come aggiornare gli attributi di un acceleratore

L’esempio update-accelerator-attributes seguente aggiorna un acceleratore per abilitare i log di flusso. È necessario specificare la Regione US-West-2 (Oregon) per creare o aggiornare gli attributi di un acceleratore.

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

Output:

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

Per ulteriori informazioni, consulta Accelerators in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzareupdate-accelerator.

AWS CLI

Come aggiornare un acceleratore

L’esempio update-accelerator seguente modifica un acceleratore rinominandolo in ExampleAcceleratorNew. È necessario specificare la Regione US-West-2 (Oregon) per creare o aggiornare gli acceleratori.

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

Output:

{
    "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
    }
}

Per ulteriori informazioni, consulta Accelerators in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzareupdate-custom-routing-accelerator-attributes.

AWS CLI

Come aggiornare gli attributi di un acceleratore di instradamento personalizzato

L’esempio update-custom-routing-accelerator-attributes seguente aggiorna un acceleratore di instradamento personalizzato per abilitare i log di flusso.

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

Output:

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

Per ulteriori informazioni, consulta la sezione Acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzareupdate-custom-routing-accelerator.

AWS CLI

Come aggiornare un acceleratore di instradamento personalizzato

L’esempio update-custom-routing-accelerator seguente modifica un acceleratore di instradamento personalizzato cambiandone il 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

Output:

{
    "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
    }
}

Per ulteriori informazioni, consulta la sezione Acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzareupdate-custom-routing-listener.

AWS CLI

Come aggiornare un listener per un acceleratore di instradamento personalizzato

L’esempio update-custom-routing-listener seguente aggiorna un listener per modificare l’intervallo di porte.

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

Output:

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

Per ulteriori informazioni, consulta Listeners for custom routing accelerators in AWS Global Accelerator nella Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzareupdate-endpoint-group.

AWS CLI

Come aggiornare un gruppo di endpoint

L’esempio update-endpoint-group seguente aggiunge tre endpoint a un gruppo di endpoint: un indirizzo IP elastico, un ALB e un NLB.

aws globalaccelerator update-endpoint-group \
    --endpoint-group-arn arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/6789vxyz-vxyz-6789-vxyz-6789lmnopqrs/endpoint-group/ab88888example \
    --endpoint-configurations \
        EndpointId=eipalloc-eip01234567890abc,Weight=128 \
        EndpointId=arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/app/ALBTesting/alb01234567890xyz,Weight=128 \
        EndpointId=arn:aws:elasticloadbalancing:us-east-1:000123456789:loadbalancer/net/NLBTesting/alb01234567890qrs,Weight=128

Output:

{
    "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"
    }
}

Per ulteriori informazioni, consulta Endpoint groups in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

Il seguente esempio di codice mostra come utilizzareupdate-listener.

AWS CLI

Come aggiornare un listener

L’esempio update-listener seguente aggiorna un listener per cambiare la porta in 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

Output:

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

Per ulteriori informazioni, consulta Listeners in AWS Global Accelerator nella Global Accelerator AWS Developer Guide.

  • Per i dettagli sull'API, consulta Command UpdateListenerReference AWS CLI .

Il seguente esempio di codice mostra come utilizzarewithdraw-byoip-cidr.

AWS CLI

Come ritirare un intervallo di indirizzi

L'withdraw-byoip-cidresempio seguente rimuove da AWS Global Accelerator un intervallo di indirizzi che avevate precedentemente pubblicizzato per l'utilizzo con le vostre risorse. AWS 

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

Output:

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

Per ulteriori informazioni, consulta Bring your own IP address in AWS Global Accelerator nella Global Accelerator Developer Guide AWS .