Esempi di Global Accelerator che utilizzano AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

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 che utilizzano AWS CLI

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

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

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare 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

Per aggiungere un endpoint di VPC sottorete a un gruppo di endpoint per un acceleratore di routing personalizzato

L'add-custom-routing-endpointsesempio seguente aggiunge un endpoint di VPC sottorete a un gruppo di endpoint per un acceleratore di routing 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 VPC subnet per gli acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide AWS.AWS

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

AWS CLI

Per pubblicizzare un intervallo di indirizzi

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

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 VPC sottorete 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 VPC sottorete 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 VPC sottorete per gli acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide AWS.AWS

Il seguente esempio di codice mostra come utilizzarecreate-accelerator.

AWS CLI

Per creare un acceleratore

L'create-acceleratoresempio seguente crea un acceleratore con due tag con due indirizzi IP BYOIP statici. È necessario specificare la US-West-2 (Oregon) regione 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 Developer AWS Guide.

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

AWS CLI

Per creare un acceleratore di routing personalizzato

L'create-custom-routing-acceleratoresempio seguente crea un acceleratore di routing personalizzato con i tag 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

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 Guide AWS .

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

AWS CLI

Per creare un gruppo di endpoint per un acceleratore di routing personalizzato

L'create-custom-routing-endpoint-groupesempio seguente crea un gruppo di endpoint per un acceleratore di routing 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

Per creare un listener per un acceleratore di routing personalizzato

L'create-custom-routing-listeneresempio seguente crea un listener con un intervallo di porte compreso tra 5000 e 10000 per un acceleratore di routing 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

Per creare un gruppo di endpoint

L'create-endpoint-groupesempio 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 i gruppi di endpoint in Global Accelerator nella AWS Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzarecreate-listener.

AWS CLI

Per creare un ascoltatore

L'create-listeneresempio 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 Developer AWS Guide.

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

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

AWS CLI

Per specificare un indirizzo di destinazione che non può ricevere traffico in un acceleratore di routing personalizzato

L'deny-custom-routing-trafficesempio seguente specifica l'indirizzo o gli indirizzi di destinazione in un endpoint di sottorete che non possono ricevere traffico per un acceleratore di routing personalizzato. Per specificare più di un indirizzo di destinazione, separa gli indirizzi con uno spazio. Nessuna risposta per una deny-custom-routing-traffic chiamata andata a buon fine.

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 VPC sottorete per gli 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

Per rimuovere 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 le vostre AWS 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

Per descrivere gli attributi di un acceleratore

L'describe-accelerator-attributesesempio 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 Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzaredescribe-accelerator.

AWS CLI

Per descrivere un acceleratore

L'describe-acceleratoresempio 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 Developer Guide AWS .

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

AWS CLI

Per descrivere gli attributi di un acceleratore di routing personalizzato

L'describe-custom-routing-accelerator-attributesesempio seguente descrive gli attributi di un acceleratore di routing 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 Guide AWS .

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

AWS CLI

Per descrivere un acceleratore di routing personalizzato

L'describe-custom-routing-acceleratoresempio seguente recupera i dettagli sull'acceleratore di routing 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 Guide.AWS

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

AWS CLI

Per descrivere un gruppo di endpoint per un acceleratore di routing personalizzato

L'describe-custom-routing-endpoint-groupesempio seguente descrive un gruppo di endpoint per un acceleratore di routing 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

Per descrivere un listener per un acceleratore di routing personalizzato

L'describe-custom-routing-listeneresempio seguente descrive un listener per un acceleratore di routing 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

Per descrivere un gruppo di endpoint

L'describe-endpoint-groupesempio seguente recupera i dettagli su un gruppo di endpoint con i seguenti endpoint: un'EC2istanza AmazonALB, an e an. 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

Per descrivere un ascoltatore

L'describe-listeneresempio seguente descrive un ascoltatore.

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 Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzarelist-accelerators.

AWS CLI

Per elencare i tuoi acceleratori

L'list-acceleratorsesempio seguente elenca gli acceleratori presenti nel tuo AWS account. Questo account ha 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

Per elencare gli intervalli di indirizzi

L'list-byoip-cidresempio seguente elenca gli intervalli di indirizzi Bring your own IP address (BYOIP) che hai predisposto 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 AWS Guide.

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

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

AWS CLI

Per elencare gli acceleratori di routing personalizzati

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

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

Per elencare i gruppi di endpoint per un listener in un acceleratore di routing personalizzato

L'list-custom-routing-endpoint-groupsesempio seguente elenca i gruppi di endpoint per un listener in un acceleratore di routing 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

Per elencare i listener per gli acceleratori di routing personalizzati

L'list-custom-routing-listenersesempio seguente elenca i listener per un acceleratore di routing 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, consultate 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

Per elencare le mappature delle porte per una destinazione specifica dell'acceleratore di routing 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

Per elencare le mappature delle porte in un acceleratore di routing personalizzato

L'list-custom-routing-port-mappingsesempio seguente fornisce un elenco parziale delle mappature delle porte in un acceleratore di routing 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 Guide.AWS

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

AWS CLI

Per elencare i gruppi di endpoint

L'list-endpoint-groupsesempio seguente elenca i gruppi di endpoint per un listener. Questo listener ha 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 Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzarelist-listeners.

AWS CLI

Per elencare gli ascoltatori

L'list-listenersesempio seguente elenca gli ascoltatori di 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, consultate Listeners in AWS Global Accelerator nella Global Accelerator Developer Guide AWS .

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

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

AWS CLI

Per elencare i tag di un acceleratore

L'list-tags-for-resourceesempio seguente elenca i tag per un acceleratore specifico.

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 Developer AWS Guide.

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

AWS CLI

Per fornire 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

Per etichettare un acceleratore

L'tag-resourceesempio seguente aggiunge i tag Name e Project a un acceleratore, insieme ai 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 Developer AWS Guide.

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

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere un tag da un acceleratore

L'untag-resourceesempio 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 Developer AWS Guide.

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

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

AWS CLI

Per aggiornare gli attributi di un acceleratore

L'update-accelerator-attributesesempio seguente aggiorna un acceleratore per abilitare i registri di flusso. È necessario specificare la US-West-2 (Oregon) regione per creare o aggiornare gli attributi dell'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 Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzareupdate-accelerator.

AWS CLI

Per aggiornare un acceleratore

L'update-acceleratoresempio seguente modifica un acceleratore per cambiarne il nome. ExampleAcceleratorNew È necessario specificare la US-West-2 (Oregon) regione 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 Developer AWS Guide.

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

AWS CLI

Per aggiornare gli attributi di un acceleratore di routing personalizzato

L'update-custom-routing-accelerator-attributesesempio seguente aggiorna un acceleratore di routing 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 Acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer Guide.AWS

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

AWS CLI

Per aggiornare un acceleratore di routing personalizzato

L'update-custom-routing-acceleratoresempio seguente modifica un acceleratore di routing personalizzato per cambiare il nome dell'acceleratore.

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 Guide.AWS

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

AWS CLI

Per aggiornare un listener per un acceleratore di routing personalizzato

L'update-custom-routing-listeneresempio 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

Per aggiornare un gruppo di endpoint

L'update-endpoint-groupesempio seguente aggiunge tre endpoint a un gruppo di endpoint: un indirizzo IP elasticoALB, un 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 i gruppi di endpoint in Global Accelerator nella AWS Global Accelerator Developer Guide AWS .

Il seguente esempio di codice mostra come utilizzareupdate-listener.

AWS CLI

Per aggiornare un ascoltatore

L'update-listeneresempio seguente aggiorna un listener per modificare la porta su 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 Developer AWS Guide.

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

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

AWS CLI

Per ritirare un intervallo di indirizzi

L'withdraw-byoip-cidresempio seguente rimuove da AWS Global Accelerator un intervallo di indirizzi che avevi precedentemente pubblicizzato per l'utilizzo con le tue 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 .