Esempi di VPC Lattice utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with VPC Lattice.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Azioni

Il seguente esempio di codice mostra come utilizzare. create-listener

AWS CLI

Come creare un listener

L’esempio create-listener seguente crea un listener HTTPS con una regola predefinita che inoltra il traffico al gruppo di destinazione VPC Lattice specificato.


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

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

Per ulteriori informazioni, consulta Listener nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta CreateListener AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarecreate-resource-configuration.

AWS CLI

Come creare una configurazione delle risorse

L'create-resource-configurationesempio seguente crea una configurazione delle risorse che specifica un singolo IPv4 indirizzo.


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

Per ulteriori informazioni, consulta Configurazione delle risorse per risorse VPC nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, vedere CreateResourceConfigurationin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-resource-gateway.

AWS CLI

Come creare un gateway per le risorse

L’esempio create-resource-gateway seguente crea un gateway per le risorse per la sottorete specificata.


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

Per ulteriori informazioni, consulta Gateway per le risorse in VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta CreateResourceGateway AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarecreate-service-network-service-association.

AWS CLI

Come creare un’associazione a un servizio

L’esempio create-service-network-service-association seguente associa il servizio specificato alla rete di servizi specificata.


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

Per ulteriori informazioni, consulta Gestire le associazioni dei servizi nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta CreateServiceNetworkServiceAssociation AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarecreate-service-network-vpc-association.

AWS CLI

Come creare un’associazione a un VPC

L’esempio create-service-network-vpc-association seguente associa il VPC specificato alla rete di servizi specificata. Il gruppo di sicurezza specificato controlla quali risorse nel VPC possono accedere alla rete di servizi e ai relativi servizi.


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

Per ulteriori informazioni, consulta Gestire le associazioni VPC nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta CreateServiceNetworkVpcAssociation AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarecreate-service-network.

AWS CLI

Come creare una rete di servizi

L’esempio create-service-network seguente crea una rete di servizi con il nome specificato.


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

Per ulteriori informazioni, consulta Reti di servizio nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta CreateServiceNetwork AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarecreate-service.

AWS CLI

Come creare un servizio

L’esempio create-service seguente crea un servizio con il nome specificato.


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

Per ulteriori informazioni, consulta Servizi in VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta CreateService AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarecreate-target-group.

AWS CLI

Esempio 1: come creare un gruppo di destinazione di tipo INSTANCE

L’esempio create-target-group seguente crea un gruppo di destinazione con il nome, il tipo e la configurazione specificati.


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

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

Esempio 2: come creare un gruppo di destinazione di tipo IP

L’esempio create-target-group seguente crea un gruppo di destinazione con il nome, il tipo e la configurazione specificati.


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

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

Esempio 3: come creare un gruppo di destinazione di tipo LAMBDA

L’esempio create-target-group seguente crea un gruppo di destinazione con il nome, il tipo e la configurazione specificati.


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

Esempio 4: come creare un gruppo di destinazione di tipo ALB

L’esempio create-target-group seguente crea un gruppo di destinazione con il nome, il tipo e la configurazione specificati.


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

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

Per ulteriori informazioni, consulta Gruppi di destinazione nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta CreateTargetGroup AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-auth-policy.

AWS CLI

Come eliminare una policy di autenticazione

L’esempio delete-auth-policy seguente elimina la policy di autenticazione per il servizio specificato.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Policy di autenticazione nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeleteAuthPolicy AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-listener.

AWS CLI

Come eliminare un listener

L’esempio delete-listener seguente elimina il listener specificato.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Listener nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeleteListener AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-resource-configuration.

AWS CLI

Come eliminare una configurazione di risorse

L’esempio delete-resource-configuration seguente elimina la configurazione di risorse specificata.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Gateway per le risorse in VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeleteResourceConfiguration AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-resource-gateway.

AWS CLI

Come eliminare un gateway per le risorse

L’esempio delete-resource-gateway seguente elimina il gateway per le risorse specificato.


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

Per ulteriori informazioni, consulta Gateway per le risorse in VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeleteResourceGateway AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-service-network-service-association.

AWS CLI

Come eliminare un’associazione di servizi

L’esempio delete-service-network-service-association seguente elimina l’associazione di servizi specificata.


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

Per ulteriori informazioni, consulta Gestire le associazioni dei servizi nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeleteServiceNetworkServiceAssociation AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-service-network-vpc-association.

AWS CLI

Come eliminare un’associazione VPC

L’esempio delete-service-network-vpc-association seguente elimina l’associazione VPC specificata.


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

Per ulteriori informazioni, consulta Gestire le associazioni VPC nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeleteServiceNetworkVpcAssociation AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-service-network.

AWS CLI

Come eliminare una rete di servizi

L’esempio delete-service-network seguente elimina la rete di servizi specificata.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Reti di servizio nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeleteServiceNetwork AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-service.

AWS CLI

Come eliminare un servizio

L’esempio delete-service seguente elimina il servizio specificato.


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

Per ulteriori informazioni, consulta Servizi in VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeleteService AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-target-group.

AWS CLI

Come eliminare un gruppo di destinazione

L’esempio delete-target-group seguente elimina il gruppo di destinazione specificato.


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

Per ulteriori informazioni, consulta Gruppi di destinazione nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeleteTargetGroup AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarederegister-targets.

AWS CLI

Come annullare la registrazione di una destinazione

L’esempio deregister-targets seguente annulla la registrazione della destinazione specificata nel gruppo di destinazione specificato.


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

Output:


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

Per ulteriori informazioni, consulta Registrare le destinazioni nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta DeregisterTargets AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-auth-policy.

AWS CLI

Come ottenere informazioni su una policy di autorizzazione

L’esempio get-auth-policy seguente ottiene informazioni sulla policy di autenticazione per il servizio specificato.


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

Per ulteriori informazioni, consulta Policy di autenticazione nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta GetAuthPolicy AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-listener.

AWS CLI

Come ottenere informazioni su un listener di un servizio

L’esempio get-listener seguente ottiene informazioni sul listener specificato per il servizio specificato.


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

Per ulteriori informazioni, consulta Definire il routing nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta GetListener AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-resource-configuration.

AWS CLI

Come ottenere informazioni su una configurazione delle risorse

L’esempio get-resource-configuration seguente ottiene informazioni sulla configurazione delle risorse specificata.


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

Per ulteriori informazioni, consulta Gateway per le risorse in VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta GetResourceConfiguration AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-resource-gateway.

AWS CLI

Come ottenere informazioni su un gateway per le risorse

L’esempio get-resource-gateway seguente ottiene informazioni sul gateway per le risorse specificato.


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

Per ulteriori informazioni, consulta Gateway per le risorse in VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta GetResourceGateway AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-service-network-service-association.

AWS CLI

Come ottenere informazioni su un’associazione di servizi

L’esempio get-service-network-service-association seguente ottiene informazioni sull’associazione di servizi specificata.


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

Per ulteriori informazioni, consulta Gestire le associazioni dei servizi nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta GetServiceNetworkServiceAssociation AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-service-network-vpc-association.

AWS CLI

Come ottenere informazioni su un’associazione VPC

L’esempio get-service-network-vpc-association seguente ottiene informazioni sull’associazione VPC specificata.


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

Per ulteriori informazioni, consulta Gestire le associazioni VPC nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta GetServiceNetworkVpcAssociation AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-service-network.

AWS CLI

Come ottenere informazioni su una rete di servizi

L’esempio get-service-network seguente ottiene informazioni sulla rete di servizi specificata.


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
}

Per ulteriori informazioni, consulta Reti di servizio nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta GetServiceNetwork AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-service.

AWS CLI

Come ottenere informazioni su un servizio

L’esempio get-service seguente ottiene informazioni sul servizio specificato.


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

Per ulteriori informazioni, consulta Servizi nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta GetService AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-target-group.

AWS CLI

Come ottenere informazioni su un gruppo di destinazione

L’esempio get-target-group seguente ottiene informazioni sul gruppo di destinazione specificato, che ha un tipo di destinazione INSTANCE.


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

Per ulteriori informazioni, consulta Gruppi di destinazione nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta GetTargetGroup AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-listeners.

AWS CLI

Come elencare i listener per un servizio

L’esempio list-listeners seguente elenca i listener per il servizio specificato.


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

Per ulteriori informazioni, consulta Definire il routing nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta ListListeners AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-resource-configurations.

AWS CLI

Come elencare le configurazioni delle risorse

L’esempio list-resource-configurations seguente elenca le configurazioni delle risorse.


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

Per ulteriori informazioni, consulta Configurazione delle risorse nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta ListResourceConfigurations AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-resource-endpoint-associations.

AWS CLI

Come elencare le associazioni di endpoint VPC

L’esempio list-resource-endpoint-associations seguente elenca gli endpoint VPC associati alla configurazione delle risorse specificata.


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

Per ulteriori informazioni, consulta Gestire le associazioni per una configurazione di risorse VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta ListResourceEndpointAssociations AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-resource-gateways.

AWS CLI

Come elencare i gateway per le risorse

L’esempio list-resource-gateways seguente elenca tutti i gateway per le risorse in uso.


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

Per ulteriori informazioni, consulta Gateway per le risorse in VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta ListResourceGateways AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-service-network-service-associations.

AWS CLI

Come elencare le associazioni di servizi

L’esempio list-service-network-service-associations seguente elenca le associazioni di servizi per la rete di servizi specificata. L'--queryopzione indirizza l'output alle associazioni IDs di servizi.


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

Output:


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

Per ulteriori informazioni, consulta Gestire le associazioni dei servizi nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, vedere ListServiceNetworkServiceAssociationsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-service-network-vpc-associations.

AWS CLI

Come elencare le associazioni VPC

L’esempio list-service-network-vpc-associations seguente elenca le associazioni VPC per la rete di servizi specificata. L'--queryopzione indirizza l'output alle IDs associazioni VPC.


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

Output:


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

Per ulteriori informazioni, consulta Gestire le associazioni VPC nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, vedere ListServiceNetworkVpcAssociationsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-service-network-vpc-endpoint-associations.

AWS CLI

Come elencare le associazioni di endpoint VPC

L’esempio list-service-network-vpc-endpoint-associations seguente elenca gli endpoint VPC associati alla rete di servizi specificata.


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

Per ulteriori informazioni, consulta Gestire le associazioni per una rete di servizio di VPC Lattice nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta ListServiceNetworkVpcEndpointAssociations AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-service-networks.

AWS CLI

Come elencare le reti di servizi

L’esempio list-service-networks seguente elenca le reti di servizi di proprietà o condivise con l’account chiamante. L’opzione --query definisce i nomi delle risorse Amazon (ARN) delle reti di servizi come ambito dei risultati.


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

Per ulteriori informazioni, consulta Reti di servizio nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta ListServiceNetworks AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-services.

AWS CLI

Come elencare i servizi

L’esempio list-services seguente elenca i servizi di proprietà o condivisi con l’account chiamante. L’opzione --query definisce i nomi delle risorse Amazon (ARN) dei servizi come ambito dei risultati.


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

Per ulteriori informazioni, consulta Servizi nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta ListServices AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-target-groups.

AWS CLI

Come elencare i gruppi di destinazione

L’esempio list-target-groups seguente elenca i gruppi di destinazione con un tipo di destinazione LAMBDA.


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

Per ulteriori informazioni, consulta Gruppi di destinazione nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta ListTargetGroups AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-targets.

AWS CLI

Come elencare le destinazioni per un gruppo di destinazione

L’esempio list-targets seguente elenca le destinazioni per il gruppo di destinazione specificato.


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

Per ulteriori informazioni, consulta Gruppi di destinazione nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta ListTargets AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareput-auth-policy.

AWS CLI

Come creare una policy di autenticazione per un servizio

L’esempio put-auth-policy seguente concede l’accesso alle richieste da qualsiasi principale autenticato che utilizza il ruolo IAM specificato. La risorsa è l’ARN del servizio a cui è collegata la policy.


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

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

Per ulteriori informazioni, consulta Policy di autenticazione nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta PutAuthPolicy AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareregister-targets.

AWS CLI

Come registrare una destinazione

L’esempio register-targets seguente registra la destinazione specificata nel gruppo di destinazione specificato.


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

Per ulteriori informazioni, consulta Registrare le destinazioni nella Guida per l’utente di Amazon VPC Lattice.

Per i dettagli sull'API, consulta RegisterTargets AWS CLICommand Reference.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Autorizzazioni verificate da Amazon

AWS WAF Classic