使用全球加速器示例 AWS CLI

以下代码示例向您展示了如何使用与 Global Accelerator AWS Command Line Interface 配合使用来执行操作和实现常见场景。

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以在其中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

操作

以下代码示例演示如何使用 add-custom-routing-endpoints。

AWS CLI

向自定义路由加速器的终端节点组添加VPC子网终端节点

以下add-custom-routing-endpoints示例将子VPC网终端节点添加到自定义路由加速器的终端节点组中。


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"

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中自定义路由加速器的VPC子网终端节点。AWS

有关API详细信息，请参阅AWS CLI 命令参考AddCustomRoutingEndpoints中的。

以下代码示例演示如何使用 advertise-byoip-cidr。

AWS CLI

宣传地址范围

以下advertise-byoip-cidr示例请求 AWS 宣传您预配置的用于 AWS 资源的地址范围。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的自带AWS 全球加速器的 IP 地址。

有关API详细信息，请参阅AWS CLI 命令参考AdvertiseByoipCidr中的。

以下代码示例演示如何使用 allow-custom-routing-traffic。

AWS CLI

允许流量流向VPC子网中的特定 Amazon EC2 实例目的地，以实现自定义路由加速器

以下allow-custom-routing-traffic示例指定允许流量流向某些 Amazon EC2 实例（目标）IP 地址，自定义路由加速器中的VPC子网终端节点可以接收流量。


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

此命令不生成任何输出。

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中自定义路由加速器的VPC子网终端节点。AWS

有关API详细信息，请参阅AWS CLI 命令参考AllowCustomRoutingTraffic中的。

以下代码示例演示如何使用 create-accelerator。

AWS CLI

创建加速器

以下create-accelerator示例创建了一个带有两个标签和两个BYOIP静态 IP 地址的加速器。您必须指定要创建或更新加速器的US-West-2 (Oregon)区域。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器。

有关API详细信息，请参阅AWS CLI 命令参考CreateAccelerator中的。

以下代码示例演示如何使用 create-custom-routing-accelerator。

AWS CLI

创建自定义路由加速器

以下create-custom-routing-accelerator示例使用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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中的AWS 自定义路由加速器。

有关API详细信息，请参阅AWS CLI 命令参考CreateCustomRoutingAccelerator中的。

以下代码示例演示如何使用 create-custom-routing-endpoint-group。

AWS CLI

为自定义路由加速器创建终端节点组

以下create-custom-routing-endpoint-group示例为自定义路由加速器创建终端节点组。


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"

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中自定义路由加速器的终端节点组。AWS

有关API详细信息，请参阅AWS CLI 命令参考CreateCustomRoutingEndpointGroup中的。

以下代码示例演示如何使用 create-custom-routing-listener。

AWS CLI

为自定义路由加速器创建监听器

以下create-custom-routing-listener示例为自定义路由加速器创建端口范围为 5000 到 10000 的侦听器。


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

输出：


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

有关API详细信息，请参阅AWS CLI 命令参考CreateCustomRoutingListener中的。

以下代码示例演示如何使用 create-endpoint-group。

AWS CLI

创建终端节点组

以下create-endpoint-group示例创建了一个包含一个终端节点的终端节点组。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器中的端点组。

有关API详细信息，请参阅AWS CLI 命令参考CreateEndpointGroup中的。

以下代码示例演示如何使用 create-listener。

AWS CLI

创建监听器

以下create-listener示例创建了一个具有两个端口的监听器。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的 AWS 全球加速器中的监听器。

有关API详细信息，请参阅AWS CLI 命令参考CreateListener中的。

以下代码示例演示如何使用 deny-custom-routing-traffic。

AWS CLI

指定无法在自定义路由加速器中接收流量的目标地址

以下deny-custom-routing-traffic示例指定了无法接收自定义路由加速器流量的子网终端节点中的一个或多个目标地址。要指定多个目的地址，请用空格分隔各个地址。成功 deny-custom-routing-traffic呼叫没有回应。


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"

此命令不生成任何输出。

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中自定义路由加速器的VPC子网终端节点。AWS

有关API详细信息，请参阅AWS CLI 命令参考DenyCustomRoutingTraffic中的。

以下代码示例演示如何使用 deprovision-byoip-cidr。

AWS CLI

取消配置地址范围

以下deprovision-byoip-cidr示例释放了您预配置的用于 AWS 资源的指定地址范围。


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 “ AWS 在全球加速器中AWS 自带 IP 地址”。

有关API详细信息，请参阅AWS CLI 命令参考DeprovisionByoipCidr中的。

以下代码示例演示如何使用 describe-accelerator-attributes。

AWS CLI

描述加速器的属性

以下describe-accelerator-attributes示例检索加速器的属性详细信息。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器。

有关API详细信息，请参阅AWS CLI 命令参考DescribeAcceleratorAttributes中的。

以下代码示例演示如何使用 describe-accelerator。

AWS CLI

描述加速器

以下describe-accelerator示例检索有关指定加速器的详细信息。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器。

有关API详细信息，请参阅AWS CLI 命令参考DescribeAccelerator中的。

以下代码示例演示如何使用 describe-custom-routing-accelerator-attributes。

AWS CLI

描述自定义路由加速器的属性

以下describe-custom-routing-accelerator-attributes示例描述了自定义路由加速器的属性。


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中的AWS 自定义路由加速器。

有关API详细信息，请参阅AWS CLI 命令参考DescribeCustomRoutingAcceleratorAttributes中的。

以下代码示例演示如何使用 describe-custom-routing-accelerator。

AWS CLI

描述自定义路由加速器

以下describe-custom-routing-accelerator示例检索有关指定自定义路由加速器的详细信息。


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中的AWS 自定义路由加速器。

有关API详细信息，请参阅AWS CLI 命令参考DescribeCustomRoutingAccelerator中的。

以下代码示例演示如何使用 describe-custom-routing-endpoint-group。

AWS CLI

描述自定义路由加速器的终端节点组

以下describe-custom-routing-endpoint-group示例描述了自定义路由加速器的终端节点组。


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中自定义路由加速器的终端节点组。AWS

有关API详细信息，请参阅AWS CLI 命令参考DescribeCustomRoutingEndpointGroup中的。

以下代码示例演示如何使用 describe-custom-routing-listener。

AWS CLI

描述自定义路由加速器的监听器

以下describe-custom-routing-listener示例描述了自定义路由加速器的监听器。


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

输出：


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

有关API详细信息，请参阅AWS CLI 命令参考DescribeCustomRoutingListener中的。

以下代码示例演示如何使用 describe-endpoint-group。

AWS CLI

描述终端节点组

以下describe-endpoint-group示例检索具有以下终端节点的终端节点组的详细信息：Amazon EC2 实例ALB、和。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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器中的端点组。

有关API详细信息，请参阅AWS CLI 命令参考DescribeEndpointGroup中的。

以下代码示例演示如何使用 describe-listener。

AWS CLI

描述听众

以下describe-listener示例描述了一个监听器。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的 AWS 全球加速器中的监听器。

有关API详细信息，请参阅AWS CLI 命令参考DescribeListener中的。

以下代码示例演示如何使用 list-accelerators。

AWS CLI

列出您的加速器

以下list-accelerators示例列出了您 AWS 账户中的加速器。该账户有两个加速器。


aws globalaccelerator list-accelerators

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器。

有关API详细信息，请参阅AWS CLI 命令参考ListAccelerators中的。

以下代码示例演示如何使用 list-byoip-cidr。

AWS CLI

列出您的地址范围

以下list-byoip-cidr示例列出了您为全球加速器配置的自带 IP 地址 (BYOIP) 地址范围。


aws globalaccelerator list-byoip-cidrs

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 “ AWS 在全球加速器中AWS 自带 IP 地址”。

有关API详细信息，请参阅AWS CLI 命令参考ListByoipCidr中的。

以下代码示例演示如何使用 list-custom-routing-accelerators。

AWS CLI

列出您的自定义路由加速器

以下list-custom-routing-accelerators示例列出了 AWS 账户中的自定义路由加速器。


aws globalaccelerator list-custom-routing-accelerators

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中的AWS 自定义路由加速器。

有关API详细信息，请参阅AWS CLI 命令参考ListCustomRoutingAccelerators中的。

以下代码示例演示如何使用 list-custom-routing-endpoint-groups。

AWS CLI

列出自定义路由加速器中监听器的终端节点组

以下list-custom-routing-endpoint-groups示例列出了自定义路由加速器中监听器的终端节点组。


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中自定义路由加速器的终端节点组。AWS

有关API详细信息，请参阅AWS CLI 命令参考ListCustomRoutingEndpointGroups中的。

以下代码示例演示如何使用 list-custom-routing-listeners。

AWS CLI

列出自定义路由加速器的监听器

以下list-custom-routing-listeners示例列出了自定义路由加速器的监听器。


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

输出：


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

有关API详细信息，请参阅AWS CLI 命令参考ListCustomRoutingListeners中的。

以下代码示例演示如何使用 list-custom-routing-port-mappings-by-destination。

AWS CLI

列出特定自定义路由加速器目标的端口映射

以下list-custom-routing-port-mappings-by-destination示例提供了自定义路由加速器的特定目标EC2服务器（目标地址）的端口映射。


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

输出：


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

有关API详细信息，请参阅AWS CLI 命令参考ListCustomRoutingPortMappingsByDestination中的。

以下代码示例演示如何使用 list-custom-routing-port-mappings。

AWS CLI

在自定义路由加速器中列出端口映射

以下list-custom-routing-port-mappings示例提供了自定义路由加速器中端口映射的部分列表。


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

输出：


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

有关API详细信息，请参阅AWS CLI 命令参考ListCustomRoutingPortMappings中的。

以下代码示例演示如何使用 list-endpoint-groups。

AWS CLI

列出终端节点组

以下list-endpoint-groups示例列出了监听器的终端节点组。该监听器有两个终端节点组。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器中的端点组。

有关API详细信息，请参阅AWS CLI 命令参考ListEndpointGroups中的。

以下代码示例演示如何使用 list-listeners。

AWS CLI

列出听众

以下list-listeners示例列出了加速器的监听器。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的 AWS 全球加速器中的监听器。

有关API详细信息，请参阅AWS CLI 命令参考ListListeners中的。

以下代码示例演示如何使用 list-tags-for-resource。

AWS CLI

列出加速器的标签

以下list-tags-for-resource示例列出了特定加速器的标签。


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 “ AWS AWS 在全球加速器中添加标签”。

有关API详细信息，请参阅AWS CLI 命令参考ListTagsForResource中的。

以下代码示例演示如何使用 provision-byoip-cidr。

AWS CLI

配置地址范围

以下provision-byoip-cidr示例预置了用于您的 AWS 资源的指定地址范围。


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 “ AWS 在全球加速器中AWS 自带 IP 地址”。

有关API详细信息，请参阅AWS CLI 命令参考ProvisionByoipCidr中的。

以下代码示例演示如何使用 tag-resource。

AWS CLI

标记加速器

以下tag-resource示例向加速器添加标签 Name 和 Project，以及每个标签的相应值。


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"

此命令不生成任何输出。

有关更多信息，请参阅《全球加速器开发者指南》中的 “ AWS AWS 在全球加速器中添加标签”。

有关API详细信息，请参阅AWS CLI 命令参考TagResource中的。

以下代码示例演示如何使用 untag-resource。

AWS CLI

从加速器中移除标签

以下untag-resource示例从加速器中移除标签 “名称” 和 “项目”。


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

此命令不生成任何输出。

有关更多信息，请参阅《全球加速器开发者指南》中的 “ AWS AWS 在全球加速器中添加标签”。

有关API详细信息，请参阅AWS CLI 命令参考UntagResource中的。

以下代码示例演示如何使用 update-accelerator-attributes。

AWS CLI

更新加速器的属性

以下update-accelerator-attributes示例更新加速器以启用流日志。您必须指定要创建或更新加速器属性的US-West-2 (Oregon)区域。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器。

有关API详细信息，请参阅AWS CLI 命令参考UpdateAcceleratorAttributes中的。

以下代码示例演示如何使用 update-accelerator。

AWS CLI

更新加速器

以下update-accelerator示例修改加速器以将加速器名称更改为。ExampleAcceleratorNew您必须指定要创建或更新加速器的US-West-2 (Oregon)区域。


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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器。

有关API详细信息，请参阅AWS CLI 命令参考UpdateAccelerator中的。

以下代码示例演示如何使用 update-custom-routing-accelerator-attributes。

AWS CLI

更新自定义路由加速器的属性

以下update-custom-routing-accelerator-attributes示例更新自定义路由加速器以启用流日志。


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中的AWS 自定义路由加速器。

有关API详细信息，请参阅AWS CLI 命令参考UpdateCustomRoutingAcceleratorAttributes中的。

以下代码示例演示如何使用 update-custom-routing-accelerator。

AWS CLI

更新自定义路由加速器

以下update-custom-routing-accelerator示例修改自定义路由加速器以更改加速器名称。


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 AWS 全球加速器中的AWS 自定义路由加速器。

有关API详细信息，请参阅AWS CLI 命令参考UpdateCustomRoutingAccelerator中的。

以下代码示例演示如何使用 update-custom-routing-listener。

AWS CLI

更新自定义路由加速器的监听器

以下update-custom-routing-listener示例更新侦听器以更改端口范围。


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

输出：


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

有关API详细信息，请参阅AWS CLI 命令参考UpdateCustomRoutingListener中的。

以下代码示例演示如何使用 update-endpoint-group。

AWS CLI

更新终端节点组

以下update-endpoint-group示例向终端节点组添加了三个终端节点：弹性 IP 地址ALB、和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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的AWS 全球加速器中的端点组。

有关API详细信息，请参阅AWS CLI 命令参考UpdateEndpointGroup中的。

以下代码示例演示如何使用 update-listener。

AWS CLI

更新监听器

以下update-listener示例更新侦听器以将端口更改为 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

输出：


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

有关更多信息，请参阅《AWS 全球加速器开发者指南》中的 AWS 全球加速器中的监听器。

有关API详细信息，请参阅AWS CLI 命令参考UpdateListener中的。

以下代码示例演示如何使用 withdraw-byoip-cidr。

AWS CLI

撤回地址范围

以下withdraw-byoip-cidr示例从 AWS 全球加速器中撤回了您之前发布的用于资源的地址范围。 AWS


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

输出：


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

有关更多信息，请参阅《全球加速器开发者指南》中的 “ AWS 在全球加速器中AWS 自带 IP 地址”。

有关API详细信息，请参阅AWS CLI 命令参考WithdrawByoipCidr中的。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

Amazon GameLift

AWS Glue