aws globalaccelerator create-listener

Create a listener to process inbound connections from clients to an accelerator. AWS CLI reference

1 example 5 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To create a listener

The following create-listener example creates a listener with two ports.

aws globalaccelerator create-listener --accelerator-arn arn:aws:globalaccelerator::123456789012:accelerator/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 --port-ranges FromPort=80,ToPort=80 FromPort=81,ToPort=81 --protocol TCP

Identify

--accelerator-arnThe Amazon Resource Name (ARN) of your accelerator.

--port-rangesThe list of port ranges to support for connections from clients to your accelerator.

--protocolThe protocol for connections from clients to your accelerator.

Its output

{
    "Listener": {
        "PortRanges": [
            {
                "ToPort": 80,
                "FromPort": 80
            },
            {
                "ToPort": 81,
                "FromPort": 81
            }
        ],
        "ClientAffinity": "NONE",
        "Protocol": "TCP",
        "ListenerArn": "arn:aws:globalaccelerator::123456789012:accelerator/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/listener/0123vxyz"
    }
}

For more information, see Listeners in AWS Global Accelerator in the AWS Global Accelerator Developer Guide.

Options

5 in the AWS CLI reference

--accelerator-arnThe Amazon Resource Name (ARN) of your accelerator.

--client-affinityClient affinity lets you direct all requests from a user to the same endpoint, if you have stateful applications, regardless of the port and protocol of the client request.

--idempotency-tokenA unique, case-sensitive identifier that you provide to ensure the idempotency—that is, the uniqueness—of the request.

--port-rangesThe list of port ranges to support for connections from clients to your accelerator.

--protocolThe protocol for connections from clients to your accelerator.