使用 的 Global Accelerator 範例 AWS CLI - AWS SDK 程式碼範例
動作

文件 AWS SDK AWS 範例 SDK 儲存庫中有更多可用的 GitHub 範例。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 的 Global Accelerator 範例 AWS CLI

下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 Global Accelerator 來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會示範如何呼叫個別服務函數，但您可以在相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結，您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的自訂路由加速器的 VPC 子網路端點。 AWS

下列程式碼範例示範如何使用 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"
    }
}

如需詳細資訊，請參閱 Global Accelerator 開發人員指南中的在 AWS Global Accelerator 中自有 IP 地址。 AWS

下列程式碼範例示範如何使用 allow-custom-routing-traffic。

AWS CLI

允許流量傳送至自訂路由加速器 EC2 子網路中的特定 Amazon VPC 執行個體目的地

下列allow-custom-routing-traffic範例指定允許流量到自訂路由加速器中 VPC 子網路端點的特定 Amazon EC2 執行個體 （目的地） IP 地址和連接埠，可以接收流量。

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 Global Accelerator 開發人員指南中的自訂路由加速器的 VPC 子網路端點。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的自訂路由加速器。 AWS

下列程式碼範例示範如何使用 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": []
    }
}

如需詳細資訊，請參閱 Global Accelerator AWS 開發人員指南中的 AWS Global Accelerator 中的自訂路由加速器端點群組。

下列程式碼範例示範如何使用 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"
    }
}

如需詳細資訊，請參閱 AWS 全球加速器開發人員指南中的 Global Accelerator 中的適用於自訂路由加速器的接聽程式。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的端點群組。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的接聽程式。 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 Global Accelerator 開發人員指南中的自訂路由加速器的 VPC 子網路端點。 AWS

下列程式碼範例示範如何使用 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"
    }
}

如需詳細資訊，請參閱 Global Accelerator 開發人員指南中的在 AWS Global Accelerator 中攜帶您自己的 IP 地址。 AWS

下列程式碼範例示範如何使用 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 開發人員指南中的全球加速器。

下列程式碼範例示範如何使用 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 開發人員指南中的全球加速器。

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的自訂路由加速器。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的自訂路由加速器。 AWS

下列程式碼範例示範如何使用 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"
            }
        ]
    }
}

如需詳細資訊，請參閱 Global AWS Accelerator 開發人員指南中的 AWS Global Accelerator 中的自訂路由加速器端點群組。

下列程式碼範例示範如何使用 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"
    }
}

如需詳細資訊，請參閱 AWS 全球加速器開發人員指南中的 Global Accelerator 中的適用於自訂路由加速器的接聽程式。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的端點群組。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的接聽程式。 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範例列出您已佈建用於 Global Accelerator 的自有 IP 地址 (BYOIP) 地址範圍。

aws globalaccelerator list-byoip-cidrs

輸出：

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

如需詳細資訊，請參閱 Global Accelerator 開發人員指南中的在 AWS Global Accelerator 中攜帶您自己的 IP 地址。 AWS

  • 如需 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的自訂路由加速器。 AWS

下列程式碼範例示範如何使用 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"
                }
            ]
        }
    ]
}

如需詳細資訊，請參閱 Global AWS Accelerator 開發人員指南中的 AWS Global Accelerator 中的自訂路由加速器端點群組。

下列程式碼範例示範如何使用 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"
        }
    ]
}

如需詳細資訊，請參閱 Global Accelerator 開發人員指南中的 接聽程式，以取得 AWS Global Accelerator 中的自訂路由加速器。 AWS

下列程式碼範例示範如何使用 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"
        }
    ]
}

如需詳細資訊，請參閱 AWS Global Accelerator 開發人員指南中的自訂路由加速器如何在 Global Accelerator 中運作。 AWS

下列程式碼範例示範如何使用 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"
        }
    ]
}

如需詳細資訊，請參閱 Global Accelerator 開發人員指南中的自訂路由加速器如何在 AWS Global Accelerator 中運作。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的端點群組。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的接聽程式。 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 Global Accelerator 開發人員指南中的在 Global Accelerator 中標記。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 中攜帶您自己的 IP 地址。 AWS

下列程式碼範例示範如何使用 tag-resource。

AWS CLI

標記加速器

下列tag-resource範例會將標籤名稱和專案新增至加速器，以及每個項目的對應值。

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 Global Accelerator 開發人員指南中的在 Global Accelerator 中標記。 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 Global Accelerator 開發人員指南中的在 Global Accelerator 中標記。 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 開發人員指南中的全球加速器。

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的自訂路由加速器。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的自訂路由加速器。 AWS

下列程式碼範例示範如何使用 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"
    }
}

如需詳細資訊，請參閱 AWS Global Accelerator 開發人員指南中的適用於自訂路由加速器的接聽程式。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的端點群組。 AWS

下列程式碼範例示範如何使用 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 Global Accelerator 開發人員指南中的 Global Accelerator 中的接聽程式。 AWS

  • 如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 UpdateListener。

下列程式碼範例示範如何使用 withdraw-byoip-cidr。

AWS CLI

若要撤銷地址範圍

下列withdraw-byoip-cidr範例會從您先前公告用於 AWS 資源的 AWS Global Accelerator 中，撤銷地址範圍。

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

輸出：

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

如需詳細資訊，請參閱 Global Accelerator 開發人員指南中的在 AWS Global Accelerator 中攜帶您自己的 IP 地址。 AWS

  • 如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 WithdrawByoipCidr。