Contoh VPC Lattice menggunakan AWS CLI - AWS Contoh Kode SDK
Tindakan

Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh SDK AWS Doc. GitHub

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

Contoh VPC Lattice menggunakan AWS CLI

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

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 menggunakancreate-listener.

AWS CLI

Untuk membuat pendengar

create-listenerContoh berikut membuat pendengar HTTPS dengan aturan default yang meneruskan lalu lintas ke grup target VPC Lattice yang ditentukan.

aws vpc-lattice create-listener \
    --name my-service-listener \
    --protocol HTTPS \
    --port 443 \
    --service-identifier svc-0285b53b2eEXAMPLE \
    --default-action file://listener-config.json

Isi dari listener-config.json:

{
    "forward": {
        "targetGroups": [
            {
                "targetGroupIdentifier": "tg-0eaa4b9ab4EXAMPLE"
            }
        ]
    }
}

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE/listener/listener-07cc7fb0abEXAMPLE",
    "defaultAction": {
        "forward": {
            "targetGroups": [
                {
                    "targetGroupIdentifier": "tg-0eaa4b9ab4EXAMPLE",
                    "weight": 100
                }
            ]
        }
    },
    "id": "listener-07cc7fb0abEXAMPLE",
    "name": "my-service-listener",
    "port": 443,
    "protocol": "HTTPS",
    "serviceArn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "serviceId": "svc-0285b53b2eEXAMPLE"
}

Untuk informasi selengkapnya, lihat Pendengar di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakancreate-resource-configuration.

AWS CLI

Untuk membuat konfigurasi sumber daya

create-resource-configurationContoh berikut membuat konfigurasi sumber daya yang menentukan IPv4 alamat tunggal.

aws vpc-lattice create-resource-configuration \
    --name my-resource-config \
    --type SINGLE \
    --resource-gateway-identifier rgw-0bba03f3d56060135 \
    --resource-configuration-definition 'ipResource={ipAddress=10.0.14.85}'

Output:

{
    "allowAssociationToShareableServiceNetwork": true,
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625",
    "id": "rcfg-07129f3acded87625",
    "name": "my-resource-config",
    "portRanges": [
        "1-65535"
    ],
    "protocol": "TCP",
    "resourceConfigurationDefinition": {
        "ipResource": {
            "ipAddress": "10.0.14.85"
        }
    },
    "resourceGatewayId": "rgw-0bba03f3d56060135",
    "status": "ACTIVE",
    "type": "SINGLE"
}

Untuk informasi selengkapnya, lihat Konfigurasi sumber daya untuk sumber daya VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakancreate-resource-gateway.

AWS CLI

Untuk membuat gateway sumber daya

create-resource-gatewayContoh berikut membuat gateway sumber daya untuk subnet tertentu.

aws vpc-lattice create-resource-gateway \
    --name my-resource-gateway \
    --vpc-identifier vpc-0bf4c2739bc05a69 \
    --subnet-ids subnet-08e8943905b63a683

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-0bba03f3d56060135",
    "id": "rgw-0bba03f3d56060135",
    "ipAddressType": "IPV4",
    "name": "my-resource-gateway",
    "securityGroupIds": [
        "sg-087ffd596c5fe962c"
    ],
    "status": "ACTIVE",
    "subnetIds": [
        "subnet-08e8943905b63a683"
    ],
    "vpcIdentifier": "vpc-0bf4c2739bc05a694"
}

Untuk informasi selengkapnya, lihat Gateway sumber daya di Kisi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakancreate-service-network-service-association.

AWS CLI

Untuk membuat asosiasi layanan

create-service-network-service-associationContoh berikut mengaitkan layanan yang ditentukan dengan jaringan layanan yang ditentukan.

aws vpc-lattice create-service-network-service-association \
    --service-identifier svc-0285b53b2eEXAMPLE \
    --service-network-identifier sn-080ec7dc93EXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkserviceassociation/snsa-0e16955a8cEXAMPLE",
    "createdBy": "123456789012",
    "dnsEntry": {
        "domainName": "my-lattice-service-0285b53b2eEXAMPLE.7d67968.vpc-lattice-svcs.us-east-2.on.aws",
        "hostedZoneId": "Z09127221KTH2CEXAMPLE"
    },
    "id": "snsa-0e16955a8cEXAMPLE",
    "status": "CREATE_IN_PROGRESS"
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi layanan di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakancreate-service-network-vpc-association.

AWS CLI

Untuk membuat asosiasi VPC

create-service-network-vpc-associationContoh berikut mengaitkan vpc yang ditentukan dengan jaringan layanan yang ditentukan. Grup keamanan yang ditentukan mengontrol sumber daya mana di VPC dapat mengakses jaringan layanan dan layanannya.

aws vpc-lattice create-service-network-vpc-association \
    --vpc-identifier vpc-0a1b2c3d4eEXAMPLE \
    --service-network-identifier sn-080ec7dc93EXAMPLE \
    --security-group-ids sg-0aee16bc6cEXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkvpcassociation/snva-0821fc8631EXAMPLE",
    "createdBy": "123456789012",
    "id": "snva-0821fc8631EXAMPLE",
    "securityGroupIds": [
        "sg-0aee16bc6cEXAMPLE"
    ],
    "status": "CREATE_IN_PROGRESS"
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakancreate-service-network.

AWS CLI

Untuk membuat jaringan layanan

create-service-networkContoh berikut membuat jaringan layanan dengan nama yang ditentukan.

aws vpc-lattice create-service-network \
    --name my-service-network

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
    "authType": "NONE",
    "id": "sn-080ec7dc93EXAMPLE",
    "name": "my-service-network"
}

Untuk informasi selengkapnya, lihat Jaringan layanan di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakancreate-service.

AWS CLI

Untuk membuat layanan

create-serviceContoh berikut membuat layanan dengan nama yang ditentukan.

aws vpc-lattice create-service \
    --name my-lattice-service

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "authType": "NONE",
    "dnsEntry": {
        "domainName": "my-lattice-service-0285b53b2eEXAMPLE.1a2b3c4.vpc-lattice-svcs.us-east-2.on.aws",
        "hostedZoneId": "Z09127221KTH2CEXAMPLE"
    },
    "id": "svc-0285b53b2eEXAMPLE",
    "name": "my-lattice-service",
    "status": "CREATE_IN_PROGRESS"
}

Untuk informasi selengkapnya, lihat Layanan di Kisi VPC di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakancreate-target-group.

AWS CLI

Contoh 1: Untuk membuat grup target tipe INSTANCE

create-target-groupContoh berikut membuat grup target dengan nama, jenis, dan konfigurasi yang ditentukan.

aws vpc-lattice create-target-group \
    --name my-lattice-target-group-instance \
    --type INSTANCE \
    --config file://tg-config.json

Isi dari tg-config.json:

{
    "port": 443,
    "protocol": "HTTPS",
    "protocolVersion": "HTTP1",
    "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
}

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "config": {
        "healthCheck": {
            "enabled": true,
            "healthCheckIntervalSeconds": 30,
            "healthCheckTimeoutSeconds": 5,
            "healthyThresholdCount": 5,
            "matcher": {
                "httpCode": "200"
            },
            "path": "/",
            "protocol": "HTTPS",
            "protocolVersion": "HTTP1",
            "unhealthyThresholdCount": 2
        },
        "port": 443,
        "protocol": "HTTPS",
        "protocolVersion": "HTTP1",
        "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
    },
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "name": "my-lattice-target-group-instance",
    "status": "CREATE_IN_PROGRESS",
    "type": "INSTANCE"
}

Contoh 2: Untuk membuat grup target tipe IP

create-target-groupContoh berikut membuat grup target dengan nama, jenis, dan konfigurasi yang ditentukan.

aws vpc-lattice create-target-group \
    --name my-lattice-target-group-ip \
    --type IP \
    --config file://tg-config.json

Isi dari tg-config.json:

{
    "ipAddressType": "IPV4",
    "port": 443,
    "protocol": "HTTPS",
    "protocolVersion": "HTTP1",
    "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
}

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "config": {
        "healthCheck": {
            "enabled": true,
            "healthCheckIntervalSeconds": 30,
            "healthCheckTimeoutSeconds": 5,
            "healthyThresholdCount": 5,
            "matcher": {
                "httpCode": "200"
            },
            "path": "/",
            "protocol": "HTTPS",
            "protocolVersion": "HTTP1",
            "unhealthyThresholdCount": 2
        },
        "ipAddressType": "IPV4",
        "port": 443,
        "protocol": "HTTPS",
        "protocolVersion": "HTTP1",
        "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
    },
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "name": "my-lattice-target-group-ip",
    "status": "CREATE_IN_PROGRESS",
    "type": "IP"
}

Contoh 3: Untuk membuat grup target tipe LAMBDA

create-target-groupContoh berikut membuat grup target dengan nama, jenis, dan konfigurasi yang ditentukan.

aws vpc-lattice create-target-group \
    --name my-lattice-target-group-lambda \
    --type LAMBDA

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "name": "my-lattice-target-group-lambda",
    "status": "CREATE_IN_PROGRESS",
    "type": "LAMBDA"
}

Contoh 4: Untuk membuat grup target tipe ALB

create-target-groupContoh berikut membuat grup target dengan nama, jenis, dan konfigurasi yang ditentukan.

aws vpc-lattice create-target-group \
    --name my-lattice-target-group-alb \
    --type ALB \
    --config file://tg-config.json

Isi dari tg-config.json:

{
    "port": 443,
    "protocol": "HTTPS",
    "protocolVersion": "HTTP1",
    "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
}

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "config": {
        "port": 443,
        "protocol": "HTTPS",
        "protocolVersion": "HTTP1",
        "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
    },
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "name": "my-lattice-target-group-alb",
    "status": "CREATE_IN_PROGRESS",
    "type": "ALB"
}

Untuk informasi selengkapnya, lihat Grup sasaran di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakandelete-auth-policy.

AWS CLI

Untuk menghapus kebijakan autentikasi

delete-auth-policyContoh berikut menghapus kebijakan autentikasi untuk layanan yang ditentukan.

aws vpc-lattice delete-auth-policy \
    --resource-identifier svc-0285b53b2eEXAMPLE

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Kebijakan autentikasi di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakandelete-listener.

AWS CLI

Untuk menghapus pendengar

delete-listenerContoh berikut menghapus pendengar yang ditentukan.

aws vpc-lattice delete-listener \
    --listener-identifier listener-07cc7fb0abEXAMPLE \
    --service-identifier svc-0285b53b2eEXAMPLE

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Pendengar di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakandelete-resource-configuration.

AWS CLI

Untuk menghapus konfigurasi sumber daya

delete-resource-configurationContoh berikut menghapus konfigurasi sumber daya yang ditentukan.

aws vpc-lattice delete-resource-configuration \
    --resource-configuration-identifier rcfg-07129f3acded87625

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Gateway sumber daya di Kisi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakandelete-resource-gateway.

AWS CLI

Untuk menghapus gateway sumber daya

delete-resource-gatewayContoh berikut menghapus gateway sumber daya yang ditentukan.

aws vpc-lattice delete-resource-gateway \
    --resource-gateway-identifier rgw-0bba03f3d56060135

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-0bba03f3d56060135",
    "id": "rgw-0bba03f3d56060135",
    "name": "my-resource-gateway",
    "status": "DELETE_IN_PROGRESS"
}

Untuk informasi selengkapnya, lihat Gateway sumber daya di Kisi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakandelete-service-network-service-association.

AWS CLI

Untuk menghapus asosiasi layanan

delete-service-network-service-associationContoh berikut memisahkan asosiasi layanan yang ditentukan.

aws vpc-lattice delete-service-network-service-association \
    --service-network-service-association-identifier snsa-031fabb4d8EXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkserviceassociation/snsa-031fabb4d8EXAMPLE",
    "id": "snsa-031fabb4d8EXAMPLE",
    "status": "DELETE_IN_PROGRESS"
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi layanan di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakandelete-service-network-vpc-association.

AWS CLI

Untuk menghapus asosiasi VPC

delete-service-network-vpc-associationContoh berikut memisahkan asosiasi VPC yang ditentukan.

aws vpc-lattice delete-service-network-vpc-association \
    --service-network-vpc-association-identifier snva-0821fc8631EXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkvpcassociation/snva-0821fc8631EXAMPLE",
    "id": "snva-0821fc8631EXAMPLE",
    "status": "DELETE_IN_PROGRESS"
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakandelete-service-network.

AWS CLI

Untuk menghapus jaringan layanan

delete-service-networkContoh berikut menghapus jaringan layanan yang ditentukan.

aws vpc-lattice delete-service-network \
    --service-network-identifier sn-080ec7dc93EXAMPLE

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Jaringan layanan di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakandelete-service.

AWS CLI

Untuk menghapus layanan

delete-serviceContoh berikut menghapus layanan yang ditentukan.

aws vpc-lattice delete-service \
    --service-identifier svc-0285b53b2eEXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-west-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "id": "svc-0285b53b2eEXAMPLE",
    "name": "my-lattice-service",
    "status": "DELETE_IN_PROGRESS"
}

Untuk informasi selengkapnya, lihat Layanan di Kisi VPC di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakandelete-target-group.

AWS CLI

Untuk menghapus grup target

delete-target-groupContoh berikut menghapus kelompok target yang ditentukan.

aws vpc-lattice delete-target-group \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "status": "DELETE_IN_PROGRESS"
}

Untuk informasi selengkapnya, lihat Grup sasaran di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanderegister-targets.

AWS CLI

Untuk membatalkan pendaftaran target

deregister-targetsContoh berikut membatalkan pendaftaran target yang ditentukan dari kelompok target yang ditentukan.

aws vpc-lattice deregister-targets \
    --targets i-07dd579bc5EXAMPLE \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

Output:

{
    "successful": [
        {
            "id": "i-07dd579bc5EXAMPLE",
            "port": 443
        }
    ],
    "unsuccessful": []
}

Untuk informasi selengkapnya, lihat Mendaftarkan target di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanget-auth-policy.

AWS CLI

Untuk mendapatkan informasi tentang kebijakan autentikasi

get-auth-policyContoh berikut mendapatkan informasi tentang kebijakan autentikasi untuk layanan yang ditentukan.

aws vpc-lattice get-auth-policy \
    --resource-identifier svc-0285b53b2eEXAMPLE

Output:

{
    "createdAt": "2023-06-07T03:51:20.266Z",
    "lastUpdatedAt": "2023-06-07T04:39:27.082Z",
    "policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:role/my-clients\"},\"Action\":\"vpc-lattice-svcs:Invoke\",\"Resource\":\"arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE\"}]}",
    "state": "Active"
}

Untuk informasi selengkapnya, lihat Kebijakan autentikasi di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakanget-listener.

AWS CLI

Untuk mendapatkan informasi tentang pendengar layanan

get-listenerContoh berikut mendapatkan informasi tentang listener tertentu untuk layanan tertentu.

aws vpc-lattice get-listener \
    --listener-identifier listener-0ccf55918cEXAMPLE \
    --service-identifier svc-0285b53b2eEXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE/listener/listener-0ccf55918cEXAMPLE",
    "createdAt": "2023-05-07T05:08:45.192Z",
    "defaultAction": {
        "forward": {
            "targetGroups": [
                {
                    "targetGroupIdentifier": "tg-0ff213abb6EXAMPLE",
                    "weight": 1
                }
            ]
        }
    },
    "id": "listener-0ccf55918cEXAMPLE",
    "lastUpdatedAt": "2023-05-07T05:08:45.192Z",
    "name": "http-80",
    "port": 80,
    "protocol": "HTTP",
    "serviceArn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "serviceId": "svc-0285b53b2eEXAMPLE"
}

Untuk informasi selengkapnya, lihat Mendefinisikan perutean di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakanget-resource-configuration.

AWS CLI

Untuk mendapatkan informasi tentang konfigurasi sumber daya

get-resource-configurationContoh berikut mendapatkan informasi tentang konfigurasi sumber daya yang ditentukan.

aws vpc-lattice get-resource-configuration \
    --resource-configuration-identifier rcfg-07129f3acded87625

Output:

{
    "allowAssociationToShareableServiceNetwork": true,
    "amazonManaged": false,
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625",
    "createdAt": "2025-02-01T00:57:35.871000+00:00",
    "id": "rcfg-07129f3acded87625",
    "lastUpdatedAt": "2025-02-01T00:57:46.874000+00:00",
    "name": "my-resource-config",
    "portRanges": [
        "1-65535"
    ],
    "protocol": "TCP",
    "resourceConfigurationDefinition": {
        "ipResource": {
            "ipAddress": "10.0.14.85"
        }
    },
    "resourceGatewayId": "rgw-0bba03f3d56060135",
    "status": "ACTIVE",
    "type": "SINGLE"
}

Untuk informasi selengkapnya, lihat Gateway sumber daya di Kisi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanget-resource-gateway.

AWS CLI

Untuk mendapatkan informasi tentang gateway sumber daya

get-resource-gatewayContoh berikut mendapatkan informasi tentang gateway sumber daya yang ditentukan.

aws vpc-lattice get-resource-gateway \
    --resource-gateway-identifier rgw-0bba03f3d56060135

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-0bba03f3d56060135",
    "createdAt": "2025-02-01T00:57:33.241000+00:00",
    "id": "rgw-0bba03f3d56060135",
    "ipAddressType": "IPV4",
    "lastUpdatedAt": "2025-02-01T00:57:44.351000+00:00",
    "name": "my-resource-gateway",
    "securityGroupIds": [
        "sg-087ffd596c5fe962c"
    ],
    "status": "ACTIVE",
    "subnetIds": [
        "subnet-08e8943905b63a683"
    ],
    "vpcId": "vpc-0bf4c2739bc05a694"
}

Untuk informasi selengkapnya, lihat Gateway sumber daya di Kisi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanget-service-network-service-association.

AWS CLI

Untuk mendapatkan informasi tentang asosiasi layanan

get-service-network-service-associationContoh berikut mendapat informasi tentang asosiasi layanan yang ditentukan.

aws vpc-lattice get-service-network-service-association \
    --service-network-service-association-identifier snsa-031fabb4d8EXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkserviceassociation/snsa-031fabb4d8EXAMPLE",
    "createdAt": "2023-05-05T21:48:16.076Z",
    "createdBy": "123456789012",
    "dnsEntry": {
        "domainName": "my-lattice-service-0285b53b2eEXAMPLE.7d67968.vpc-lattice-svcs.us-east-2.on.aws",
        "hostedZoneId": "Z09127221KTH2CEXAMPLE"
    },
    "id": "snsa-031fabb4d8EXAMPLE",
    "serviceArn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "serviceId": "svc-0285b53b2eEXAMPLE",
    "serviceName": "my-lattice-service",
    "serviceNetworkArn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
    "serviceNetworkId": "sn-080ec7dc93EXAMPLE",
    "serviceNetworkName": "my-service-network",
    "status": "ACTIVE"
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi layanan di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanget-service-network-vpc-association.

AWS CLI

Untuk mendapatkan informasi tentang asosiasi VPC

get-service-network-vpc-associationContoh berikut mendapat informasi tentang asosiasi VPC tertentu.

aws vpc-lattice get-service-network-vpc-association \
    --service-network-vpc-association-identifier snva-0821fc8631EXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkvpcassociation/snva-0821fc8631EXAMPLE",
    "createdAt": "2023-06-06T23:41:08.421Z",
    "createdBy": "123456789012",
    "id": "snva-0c5dcb60d6EXAMPLE",
    "lastUpdatedAt": "2023-06-06T23:41:08.421Z",
    "securityGroupIds": [
        "sg-0aee16bc6cEXAMPLE"
    ],
    "serviceNetworkArn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
    "serviceNetworkId": "sn-080ec7dc93EXAMPLE",
    "serviceNetworkName": "my-service-network",
    "status": "ACTIVE",
    "vpcId": "vpc-0a1b2c3d4eEXAMPLE"
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanget-service-network.

AWS CLI

Untuk mendapatkan informasi tentang jaringan layanan

get-service-networkContoh berikut mendapat informasi tentang jaringan layanan yang ditentukan.

aws vpc-lattice get-service-network \
    --service-network-identifier sn-080ec7dc93EXAMPLE

Output:

{
   "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
   "authType": "AWS_IAM",
   "createdAt": "2023-05-05T15:26:08.417Z",
   "id": "sn-080ec7dc93EXAMPLE",
   "lastUpdatedAt": "2023-05-05T15:26:08.417Z",
   "name": "my-service-network",
   "numberOfAssociatedServices": 2,
   "numberOfAssociatedVPCs": 3
}

Untuk informasi selengkapnya, lihat Jaringan layanan di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanget-service.

AWS CLI

Untuk mendapatkan informasi tentang layanan

get-serviceContoh berikut mendapat informasi tentang layanan yang ditentukan.

aws vpc-lattice get-service \
    --service-identifier svc-0285b53b2eEXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "authType": "AWS_IAM",
    "createdAt": "2023-05-05T21:35:29.339Z",
    "dnsEntry": {
        "domainName": "my-lattice-service-0285b53b2eEXAMPLE.7d67968.vpc-lattice-svcs.us-east-2.on.aws",
        "hostedZoneId": "Z09127221KTH2CFUOHIZH"
    },
    "id": "svc-0285b53b2eEXAMPLE",
    "lastUpdatedAt": "2023-05-05T21:35:29.339Z",
    "name": "my-lattice-service",
    "status": "ACTIVE"
}

Untuk informasi selengkapnya, lihat Layanan di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakanget-target-group.

AWS CLI

Untuk mendapatkan informasi tentang kelompok sasaran

get-target-groupContoh berikut mendapat informasi tentang kelompok target yang ditentukan, yang memiliki jenis targetINSTANCE.

aws vpc-lattice get-target-group \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

Output:

{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "config": {
        "healthCheck": {
            "enabled": true,
            "healthCheckIntervalSeconds": 30,
            "healthCheckTimeoutSeconds": 5,
            "healthyThresholdCount": 5,
            "matcher": {
                "httpCode": "200"
            },
            "path": "/",
            "protocol": "HTTPS",
            "protocolVersion": "HTTP1",
            "unhealthyThresholdCount": 2
        },
        "port": 443,
        "protocol": "HTTPS",
        "protocolVersion": "HTTP1",
        "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
    },
    "createdAt": "2023-05-06T04:41:04.122Z",
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "lastUpdatedAt": "2023-05-06T04:41:04.122Z",
    "name": "my-target-group",
    "serviceArns": [
        "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE"
    ],
    "status": "ACTIVE",
    "type": "INSTANCE"
}

Untuk informasi selengkapnya, lihat Grup sasaran di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakanlist-listeners.

AWS CLI

Untuk daftar pendengar layanan

list-listenersContoh berikut mencantumkan pendengar untuk layanan yang ditentukan.

aws vpc-lattice list-listeners \
    --service-identifier svc-0285b53b2eEXAMPLE

Output:

{
    "items": [
        {
            "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE/listener/listener-0ccf55918cEXAMPLE",
            "createdAt": "2023-05-07T05:08:45.192Z",
            "id": "listener-0ccf55918cEXAMPLE",
            "lastUpdatedAt": "2023-05-07T05:08:45.192Z",
            "name": "http-80",
            "port": 80,
            "protocol": "HTTP"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mendefinisikan perutean di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakanlist-resource-configurations.

AWS CLI

Untuk membuat daftar konfigurasi sumber daya

list-resource-configurationsContoh berikut mencantumkan konfigurasi sumber daya Anda.

aws vpc-lattice list-resource-configurations

Output:

{
    "items": [
        {
            "amazonManaged": false,
            "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625",
            "createdAt": "2025-02-01T00:57:35.871000+00:00",
            "id": "rcfg-07129f3acded87625",
            "lastUpdatedAt": "2025-02-01T00:57:46.874000+00:00",
            "name": "my-resource-config",
            "resourceGatewayId": "rgw-0bba03f3d56060135",
            "status": "ACTIVE",
            "type": "SINGLE"
        }
    ]
}

Untuk informasi selengkapnya, lihat Konfigurasi sumber daya di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanlist-resource-endpoint-associations.

AWS CLI

Untuk membuat daftar asosiasi titik akhir VPC

list-resource-endpoint-associationsContoh berikut mencantumkan titik akhir VPC yang terkait dengan konfigurasi sumber daya yang ditentukan.

aws vpc-lattice list-resource-endpoint-associations \
    --resource-configuration-identifier rcfg-07129f3acded87625

Output:

{
    "items": [
        {
            "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceendpointassociation/rea-0956a7435baf89326",
            "createdAt": "2025-02-01T00:57:38.998000+00:00",
            "id": "rea-0956a7435baf89326",
            "resourceConfigurationArn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625",
            "resourceConfigurationId": "rcfg-07129f3acded87625",
            "vpcEndpointId": "vpce-019b90d6f16d4f958",
            "vpcEndpointOwner": "123456789012"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi untuk konfigurasi sumber daya Kisi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanlist-resource-gateways.

AWS CLI

Untuk membuat daftar gateway sumber daya Anda

list-resource-gatewaysContoh berikut mencantumkan gateway sumber daya Anda.

aws vpc-lattice list-resource-gateways

Output:

{
    "items": [
        {
            "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-0bba03f3d56060135",
            "createdAt": "2025-02-01T00:57:33.241000+00:00",
            "id": "rgw-0bba03f3d56060135",
            "ipAddressType": "IPV4",
            "lastUpdatedAt": "2025-02-01T00:57:44.351000+00:00",
            "name": "my-resource-gateway",
            "seurityGroupIds": [
                "sg-087ffd596c5fe962c"
            ],
            "status": "ACTIVE",
            "subnetIds": [
                "subnet-08e8943905b63a683"
            ],
            "vpcIdentifier": "vpc-0bf4c2739bc05a694"
        }
    ]
}

Untuk informasi selengkapnya, lihat Gateway sumber daya di Kisi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanlist-service-network-service-associations.

AWS CLI

Untuk membuat daftar asosiasi layanan

list-service-network-service-associationsContoh berikut mencantumkan asosiasi layanan untuk jaringan layanan yang ditentukan. --queryOpsi ini mencakup output ke IDs asosiasi layanan.

aws vpc-lattice list-service-network-service-associations \
    --service-network-identifier sn-080ec7dc93EXAMPLE \
    --query items[*].id

Output:

[
    "snsa-031fabb4d8EXAMPLE",
    "snsa-0e16955a8cEXAMPLE"
]

Untuk informasi selengkapnya, lihat Mengelola asosiasi layanan di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanlist-service-network-vpc-associations.

AWS CLI

Untuk membuat daftar asosiasi VPC

list-service-network-vpc-associationsContoh berikut mencantumkan asosiasi VPC untuk jaringan layanan yang ditentukan. --queryOpsi ini mencakup output ke IDs asosiasi VPC.

aws vpc-lattice list-service-network-vpc-associations \
    --service-network-identifier sn-080ec7dc93EXAMPLE \
    --query items[*].id

Output:

[
    "snva-0821fc8631EXAMPLE",
    "snva-0c5dcb60d6EXAMPLE"
]

Untuk informasi selengkapnya, lihat Mengelola asosiasi VPC di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanlist-service-network-vpc-endpoint-associations.

AWS CLI

Untuk membuat daftar asosiasi titik akhir VPC

list-service-network-vpc-endpoint-associationsContoh berikut mencantumkan titik akhir VPC yang terkait dengan jaringan layanan tertentu.

aws vpc-lattice list-service-network-vpc-endpoint-associations \
    --service-network-identifier sn-0808d1748faee0c1e

Output:

{
    "items": [
        {
            "createdAt": "2025-02-01T01:21:36.667000+00:00",
            "serviceNetworkArn": "arn:aws:vpc-lattice:us-east-1:123456789012:servicenetwork/sn-0808d1748faee0c1e",
            "state": "ACTIVE",
            "vpcEndpointId": "vpce-0cc199f605eaeace7",
            "vpcEndpointOwnerId": "123456789012"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola asosiasi untuk jaringan layanan VPC Lattice di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanlist-service-networks.

AWS CLI

Untuk membuat daftar jaringan layanan Anda

list-service-networksContoh berikut mencantumkan jaringan layanan yang dimiliki atau dibagikan dengan akun panggilan. --queryOpsi ini mencakup hasil ke Nama Sumber Daya Amazon (ARN) dari jaringan layanan.

aws vpc-lattice list-service-networks \
    --query items[*].arn

Output:

[
    "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
    "arn:aws:vpc-lattice:us-east-2:111122223333:servicenetwork/sn-0ec4d436cfEXAMPLE"
]

Untuk informasi selengkapnya, lihat Jaringan layanan di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanlist-services.

AWS CLI

Untuk membuat daftar layanan Anda

list-servicesContoh berikut mencantumkan layanan yang dimiliki atau dibagikan dengan akun panggilan. --queryOpsi ini mencakup hasil ke Nama Sumber Daya Amazon (ARN) layanan.

aws vpc-lattice list-services \
    --query items[*].arn

Output:

[
    "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "arn:aws:vpc-lattice:us-east-2:111122223333:service/svc-0b8ac96550EXAMPLE"
]

Untuk informasi selengkapnya, lihat Layanan di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakanlist-target-groups.

AWS CLI

Untuk membuat daftar grup target Anda

list-target-groupsContoh berikut mencantumkan kelompok target dengan jenis targetLAMBDA.

aws vpc-lattice list-target-groups \
    --target-group-type LAMBDA

Output:

{
    "items": [
        {
            "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-045c1b7d9dEXAMPLE",
            "createdAt": "2023-05-06T05:22:16.637Z",
            "id": "tg-045c1b7d9dEXAMPLE",
            "lastUpdatedAt": "2023-05-06T05:22:16.637Z",
            "name": "my-target-group-lam",
            "serviceArns": [
                "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE"
            ],
            "status": "ACTIVE",
            "type": "LAMBDA"
        }
    ]
}

Untuk informasi selengkapnya, lihat Grup sasaran di Panduan Pengguna Amazon VPC Lattice.

Contoh kode berikut menunjukkan cara menggunakanlist-targets.

AWS CLI

Untuk membuat daftar target untuk kelompok sasaran

list-targetsContoh berikut mencantumkan target untuk kelompok target yang ditentukan.

aws vpc-lattice list-targets \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

Output:

{
    "items": [
        {
            "id": "i-07dd579bc5EXAMPLE",
            "port": 443,
            "status": "HEALTHY"
        },
        {
            "id": "i-047b3c9078EXAMPLE",
            "port": 443,
            "reasonCode": "HealthCheckFailed",
            "status": "UNHEALTHY"
        }
    ]
}

Untuk informasi selengkapnya, lihat Grup sasaran di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakanput-auth-policy.

AWS CLI

Untuk membuat kebijakan autentikasi untuk layanan

put-auth-policyContoh berikut memberikan akses ke permintaan dari prinsipal yang diautentikasi yang menggunakan peran IAM yang ditentukan. Sumber daya adalah ARN dari layanan yang dilampirkan kebijakan tersebut.

aws vpc-lattice put-auth-policy \
    --resource-identifier svc-0285b53b2eEXAMPLE \
    --policy file://auth-policy.json

Isi dari auth-policy.json:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/my-clients"
            },
            "Action": "vpc-lattice-svcs:Invoke",
            "Resource": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE"
        }
    ]
}

Output:

{
    "policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:role/my-clients\"},\"Action\":\"vpc-lattice-svcs:Invoke\",\"Resource\":\"arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE\"}]}",
    "state": "Active"
}

Untuk informasi selengkapnya, lihat Kebijakan autentikasi di Panduan Pengguna Amazon VPC Lattice.

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

Contoh kode berikut menunjukkan cara menggunakanregister-targets.

AWS CLI

Untuk mendaftarkan target

register-targetsContoh berikut mendaftarkan target yang ditentukan dengan kelompok target yang ditentukan.

aws vpc-lattice register-targets \
    --targets id=i-047b3c9078EXAMPLE id=i-07dd579bc5EXAMPLE \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

Output:

{
    "successful": [
        {
            "id": "i-07dd579bc5EXAMPLE",
            "port": 443
        }
    ],
    "unsuccessful": [
        {
            "failureCode": "UnsupportedTarget",
            "failureMessage": "Instance targets must be in the same VPC as their target group",
            "id": "i-047b3c9078EXAMPLE",
            "port": 443
        }
    ]
}

Untuk informasi selengkapnya, lihat Mendaftarkan target di Panduan Pengguna Amazon VPC Lattice.