Contoh Global Accelerator menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh Global Accelerator menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface With Global Accelerator.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanadd-custom-routing-endpoints.

AWS CLI

Untuk menambahkan titik akhir subnet VPC ke grup titik akhir untuk akselerator perutean kustom

add-custom-routing-endpointsContoh berikut menambahkan titik akhir subnet VPC ke grup titik akhir untuk akselerator perutean kustom.

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

Untuk informasi selengkapnya, lihat titik akhir subnet VPC untuk akselerator perutean kustom di Global Accelerator di Panduan Pengembang Akselerator AWS Global.AWS

Contoh kode berikut menunjukkan cara menggunakanadvertise-byoip-cidr.

AWS CLI

Untuk mengiklankan rentang alamat

advertise-byoip-cidrContoh berikut meminta AWS untuk mengiklankan rentang alamat yang telah Anda sediakan untuk digunakan dengan sumber daya Anda. AWS 

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

Output:

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

Untuk informasi selengkapnya, lihat Membawa Alamat IP Anda Sendiri di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanallow-custom-routing-traffic.

AWS CLI

Untuk mengizinkan lalu lintas ke tujuan EC2 instans Amazon tertentu di subnet VPC untuk akselerator perutean khusus

allow-custom-routing-trafficContoh berikut menentukan bahwa lalu lintas diizinkan ke alamat IP EC2 instans (tujuan) Amazon tertentu dan port untuk titik akhir subnet VPC dalam akselerator perutean khusus dapat menerima lalu lintas.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat titik akhir subnet VPC untuk akselerator perutean kustom di Global Accelerator di Panduan Pengembang Akselerator AWS Global.AWS

Contoh kode berikut menunjukkan cara menggunakancreate-accelerator.

AWS CLI

Untuk membuat akselerator

create-acceleratorContoh berikut membuat akselerator dengan dua tag dengan dua alamat IP statis BYOIP. Anda harus menentukan US-West-2 (Oregon) Wilayah untuk membuat atau memperbarui akselerator.

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

Untuk informasi selengkapnya, lihat Akselerator di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakancreate-custom-routing-accelerator.

AWS CLI

Untuk membuat akselerator perutean kustom

create-custom-routing-acceleratorContoh berikut membuat akselerator routing kustom dengan tag Name dan. 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
    }
}

Untuk informasi selengkapnya, lihat Akselerator perutean khusus di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakancreate-custom-routing-endpoint-group.

AWS CLI

Untuk membuat grup endpoint untuk akselerator perutean kustom

create-custom-routing-endpoint-groupContoh berikut membuat grup endpoint untuk akselerator routing kustom.

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

Untuk informasi selengkapnya, lihat Grup titik akhir untuk akselerator perutean kustom di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakancreate-custom-routing-listener.

AWS CLI

Untuk membuat pendengar untuk akselerator perutean kustom

create-custom-routing-listenerContoh berikut membuat pendengar dengan rentang port dari 5000 hingga 10000 untuk akselerator perutean kustom.

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

Untuk informasi selengkapnya, lihat Pendengar untuk akselerator perutean kustom di Global Accelerator di Panduan AWS Pengembang AWS Akselerator Global.

Contoh kode berikut menunjukkan cara menggunakancreate-endpoint-group.

AWS CLI

Untuk membuat grup endpoint

create-endpoint-groupContoh berikut membuat grup endpoint dengan satu 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"
    }
}

Untuk informasi selengkapnya, lihat Grup titik akhir di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakancreate-listener.

AWS CLI

Untuk membuat pendengar

create-listenerContoh berikut membuat listener dengan dua port.

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

Untuk informasi selengkapnya, lihat Pendengar di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

  • Untuk detail API, lihat CreateListenerdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandeny-custom-routing-traffic.

AWS CLI

Untuk menentukan alamat tujuan yang tidak dapat menerima lalu lintas dalam akselerator perutean kustom

deny-custom-routing-trafficContoh berikut menentukan alamat tujuan atau alamat di titik akhir subnet yang tidak dapat menerima lalu lintas untuk akselerator perutean kustom. Untuk menentukan lebih dari satu alamat tujuan, pisahkan alamat dengan spasi. Tidak ada jawaban untuk deny-custom-routing-traffic panggilan yang berhasil.

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"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat titik akhir subnet VPC untuk akselerator perutean kustom di Global Accelerator di Panduan Pengembang Akselerator AWS Global.AWS

Contoh kode berikut menunjukkan cara menggunakandeprovision-byoip-cidr.

AWS CLI

Untuk menghentikan penyediaan rentang alamat

deprovision-byoip-cidrContoh berikut merilis rentang alamat tertentu yang Anda sediakan untuk digunakan dengan sumber daya Anda AWS .

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

Output:

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

Untuk informasi selengkapnya, lihat Membawa alamat IP Anda sendiri di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakandescribe-accelerator-attributes.

AWS CLI

Untuk menggambarkan atribut akselerator

describe-accelerator-attributesContoh berikut mengambil rincian atribut untuk akselerator.

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

Untuk informasi selengkapnya, lihat Akselerator di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakandescribe-accelerator.

AWS CLI

Untuk menggambarkan akselerator

describe-acceleratorContoh berikut mengambil rincian tentang akselerator yang ditentukan.

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

Untuk informasi selengkapnya, lihat Akselerator di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakandescribe-custom-routing-accelerator-attributes.

AWS CLI

Untuk menggambarkan atribut akselerator perutean kustom

describe-custom-routing-accelerator-attributesContoh berikut menjelaskan atribut untuk akselerator routing kustom.

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

Output:

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

Untuk informasi selengkapnya, lihat Akselerator perutean khusus di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakandescribe-custom-routing-accelerator.

AWS CLI

Untuk menggambarkan akselerator perutean khusus

describe-custom-routing-acceleratorContoh berikut mengambil rincian tentang akselerator routing kustom yang ditentukan.

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

Untuk informasi selengkapnya, lihat Akselerator perutean khusus di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakandescribe-custom-routing-endpoint-group.

AWS CLI

Untuk mendeskripsikan grup endpoint untuk akselerator perutean kustom

describe-custom-routing-endpoint-groupContoh berikut menjelaskan grup endpoint untuk akselerator routing kustom.

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

Untuk informasi selengkapnya, lihat Grup titik akhir untuk akselerator perutean kustom di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakandescribe-custom-routing-listener.

AWS CLI

Untuk mendeskripsikan pendengar untuk akselerator perutean kustom

describe-custom-routing-listenerContoh berikut menjelaskan pendengar untuk akselerator perutean kustom.

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

Untuk informasi selengkapnya, lihat Pendengar untuk akselerator perutean kustom di Global Accelerator di Panduan AWS Pengembang AWS Akselerator Global.

Contoh kode berikut menunjukkan cara menggunakandescribe-endpoint-group.

AWS CLI

Untuk menggambarkan grup titik akhir

describe-endpoint-groupContoh berikut mengambil detail tentang grup titik akhir dengan titik akhir berikut: EC2 instans Amazon, ALB, dan 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"
    }
}

Untuk informasi selengkapnya, lihat Grup titik akhir di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakandescribe-listener.

AWS CLI

Untuk menggambarkan pendengar

describe-listenerContoh berikut menjelaskan pendengar.

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

Untuk informasi selengkapnya, lihat Pendengar di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanlist-accelerators.

AWS CLI

Untuk membuat daftar akselerator Anda

list-acceleratorsContoh berikut mencantumkan akselerator di AWS akun Anda. Akun ini memiliki dua akselerator.

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

Untuk informasi selengkapnya, lihat Akselerator di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanlist-byoip-cidr.

AWS CLI

Untuk mencantumkan rentang alamat Anda

list-byoip-cidrContoh berikut mencantumkan rentang alamat alamat IP Anda sendiri (BYOIP) yang telah Anda sediakan untuk digunakan dengan 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"
        }
    ]
}

Untuk informasi selengkapnya, lihat Membawa alamat IP Anda sendiri di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.

  • Untuk detail API, lihat ListByoipCidrdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-custom-routing-accelerators.

AWS CLI

Untuk membuat daftar akselerator perutean kustom

list-custom-routing-acceleratorsContoh berikut mencantumkan akselerator perutean kustom di akun 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
        },
    ]
}

Untuk informasi selengkapnya, lihat Akselerator perutean khusus di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanlist-custom-routing-endpoint-groups.

AWS CLI

Untuk mencantumkan grup titik akhir untuk pendengar dalam akselerator perutean kustom

list-custom-routing-endpoint-groupsContoh berikut mencantumkan grup titik akhir untuk pendengar dalam akselerator perutean kustom.

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

Untuk informasi selengkapnya, lihat Grup titik akhir untuk akselerator perutean kustom di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanlist-custom-routing-listeners.

AWS CLI

Untuk membuat daftar pendengar untuk akselerator perutean kustom

list-custom-routing-listenersContoh berikut mencantumkan pendengar untuk akselerator perutean kustom.

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

Untuk informasi selengkapnya, lihat Pendengar untuk akselerator perutean kustom di Global Accelerator di Panduan AWS Pengembang AWS Akselerator Global.

Contoh kode berikut menunjukkan cara menggunakanlist-custom-routing-port-mappings-by-destination.

AWS CLI

Untuk membuat daftar pemetaan port untuk tujuan akselerator perutean kustom tertentu

list-custom-routing-port-mappings-by-destinationContoh berikut menyediakan pemetaan port untuk EC2 server tujuan tertentu (di alamat tujuan) untuk akselerator perutean kustom.

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

Untuk informasi selengkapnya, lihat Cara kerja akselerator perutean kustom di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanlist-custom-routing-port-mappings.

AWS CLI

Untuk membuat daftar pemetaan port dalam akselerator perutean kustom

list-custom-routing-port-mappingsContoh berikut menyediakan sebagian daftar pemetaan port dalam akselerator routing kustom.

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

Untuk informasi selengkapnya, lihat Cara kerja akselerator perutean kustom di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanlist-endpoint-groups.

AWS CLI

Untuk membuat daftar grup titik akhir

list-endpoint-groupsContoh berikut mencantumkan grup endpoint untuk listener. Listener ini memiliki dua grup 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
        }
    ]
}

Untuk informasi selengkapnya, lihat Grup Titik Akhir di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanlist-listeners.

AWS CLI

Untuk daftar pendengar

list-listenersContoh berikut mencantumkan pendengar untuk akselerator.

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

Untuk informasi selengkapnya, lihat Pendengar di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

  • Untuk detail API, lihat ListListenersdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk daftar tag untuk akselerator

list-tags-for-resourceContoh berikut mencantumkan tag untuk akselerator tertentu.

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

Output:

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

Untuk informasi selengkapnya, lihat Menandai Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanprovision-byoip-cidr.

AWS CLI

Untuk menyediakan rentang alamat

provision-byoip-cidrContoh berikut menyediakan rentang alamat yang ditentukan untuk digunakan dengan AWS sumber daya Anda.

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

Untuk informasi selengkapnya, lihat Membawa alamat IP Anda sendiri di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menandai akselerator

tag-resourceContoh berikut menambahkan tag Nama dan Proyek ke akselerator, bersama dengan nilai yang sesuai untuk masing-masing.

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"

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

  • Untuk detail API, lihat TagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari akselerator

untag-resourceContoh berikut menghapus tag Nama dan Proyek dari akselerator.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

  • Untuk detail API, lihat UntagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-accelerator-attributes.

AWS CLI

Untuk memperbarui atribut akselerator

update-accelerator-attributesContoh berikut memperbarui akselerator untuk mengaktifkan log aliran. Anda harus menentukan US-West-2 (Oregon) Wilayah untuk membuat atau memperbarui atribut akselerator.

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

Untuk informasi selengkapnya, lihat Akselerator di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanupdate-accelerator.

AWS CLI

Untuk memperbarui akselerator

update-acceleratorContoh berikut memodifikasi akselerator untuk mengubah nama akselerator menjadi. ExampleAcceleratorNew Anda harus menentukan US-West-2 (Oregon) Wilayah untuk membuat atau memperbarui akselerator.

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

Untuk informasi selengkapnya, lihat Akselerator di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanupdate-custom-routing-accelerator-attributes.

AWS CLI

Untuk memperbarui atribut akselerator perutean kustom

update-custom-routing-accelerator-attributesContoh berikut memperbarui akselerator perutean kustom untuk mengaktifkan log aliran.

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

Untuk informasi selengkapnya, lihat Akselerator perutean khusus di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanupdate-custom-routing-accelerator.

AWS CLI

Untuk memperbarui akselerator perutean kustom

update-custom-routing-acceleratorContoh berikut memodifikasi akselerator routing kustom untuk mengubah nama akselerator.

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

Untuk informasi selengkapnya, lihat Akselerator perutean khusus di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanupdate-custom-routing-listener.

AWS CLI

Untuk memperbarui listener untuk akselerator perutean kustom

update-custom-routing-listenerContoh berikut memperbarui listener untuk mengubah rentang port.

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

Untuk informasi selengkapnya, lihat Pendengar untuk akselerator perutean kustom di Global Accelerator di Panduan AWS Pengembang AWS Akselerator Global.

Contoh kode berikut menunjukkan cara menggunakanupdate-endpoint-group.

AWS CLI

Untuk memperbarui grup titik akhir

update-endpoint-groupContoh berikut menambahkan tiga titik akhir ke grup endpoint: alamat IP Elastis, ALB, dan 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"
    }
}

Untuk informasi selengkapnya, lihat Grup titik akhir di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

Contoh kode berikut menunjukkan cara menggunakanupdate-listener.

AWS CLI

Untuk memperbarui pendengar

update-listenerContoh berikut memperbarui listener untuk mengubah port ke 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"
    }
}

Untuk informasi selengkapnya, lihat Pendengar di Akselerator AWS Global di Panduan Pengembang Akselerator AWS Global.

  • Untuk detail API, lihat UpdateListenerdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanwithdraw-byoip-cidr.

AWS CLI

Untuk menarik rentang alamat

withdraw-byoip-cidrContoh berikut menarik rentang alamat dari AWS Global Accelerator yang sebelumnya Anda iklankan untuk digunakan dengan sumber daya Anda. AWS 

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

Output:

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

Untuk informasi selengkapnya, lihat Membawa alamat IP Anda sendiri di AWS Global Accelerator di Panduan Pengembang Akselerator AWS Global.