View a markdown version of this page

Esempi di Global Accelerator che utilizzano AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples. GitHub

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 AWS Command Line Interface with Global Accelerator.

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

L’esempio di codice seguente mostra come utilizzare add-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 Endpoint di sottorete VPC per acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare advertise-byoip-cidr.

AWS CLI

Come pubblicizzare un intervallo di indirizzi

L'advertise-byoip-cidresempio seguente richiede di AWS pubblicizzare un intervallo di indirizzi che hai assegnato 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.

L’esempio di codice seguente mostra come utilizzare allow-custom-routing-traffic.

AWS CLI

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

L’esempio allow-custom-routing-traffic seguente specifica che il traffico è consentito verso determinati indirizzi IP (destinazioni) di istanze Amazon EC2 e che le porte per un endpoint di sottorete VPC in un acceleratore di instradamento 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 Endpoint di sottorete VPC per acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare create-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 Developer Guide AWS .

L’esempio di codice seguente mostra come utilizzare create-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 Acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide AWS . AWS

L’esempio di codice seguente mostra come utilizzare create-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 accelerator in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare create-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 Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare create-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 Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare create-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 Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare deny-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. Non viene generata alcuna risposta per una chiamata deny-custom-routing-traffic 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 Endpoint di sottorete VPC per acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare deprovision-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 hai assegnato per l'utilizzo con le tue risorse. AWS 

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.

L’esempio di codice seguente mostra come utilizzare describe-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 Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare describe-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 Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare describe-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 Acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare describe-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 Acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare describe-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 accelerator in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare describe-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 Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare describe-endpoint-group.

AWS CLI

Come descrivere un gruppo di endpoint

L’esempio describe-endpoint-group seguente recupera i dettagli su un gruppo di endpoint con i seguenti endpoint: un’istanza Amazon EC2, 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 Endpoint groups in AWS Global Accelerator nella Global Accelerator Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare describe-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 Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare list-accelerators.

AWS CLI

Come elencare gli acceleratori

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

L’esempio di codice seguente mostra come utilizzare list-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, vedi ListByoipCidr in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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 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 Acceleratori di routing personalizzati in Global Accelerator nella AWS Global Accelerator Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare list-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 accelerator in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare list-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 Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare list-custom-routing-port-mappings-by-destination.

AWS CLI

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

L’esempio list-custom-routing-port-mappings-by-destination seguente fornisce le mappature delle porte per un determinato server EC2 di destinazione (all’indirizzo di destinazione) per un acceleratore di instradamento 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, vedi Come funzionano gli acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare list-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, vedi Come funzionano gli acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare list-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.

L’esempio di codice seguente mostra come utilizzare list-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 Developer Guide. AWS

  • Per i dettagli sull'API, vedi ListListeners in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-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 \
    --resource-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.

L’esempio di codice seguente mostra come utilizzare provision-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 risorse. AWS 

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

L’esempio di codice seguente mostra come utilizzare tag-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 TagResource Reference AWS CLI .

L’esempio di codice seguente mostra come utilizzare untag-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 UntagResource Reference AWS CLI .

L’esempio di codice seguente mostra come utilizzare update-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 Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare update-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 Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare update-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 Acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare update-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 Acceleratori di routing personalizzati in Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare update-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 Global Accelerator nella Global Accelerator Developer Guide. AWS AWS

L’esempio di codice seguente mostra come utilizzare update-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 Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare update-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 Developer Guide. AWS

L’esempio di codice seguente mostra come utilizzare withdraw-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 hai precedentemente pubblicizzato per l'uso 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 AWS Guide.