Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface treillis avec VPC.
Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utilisercreate-listener
.
- AWS CLI
-
Pour créer un écouteur
L'
create-listener
exemple suivant crée un écouteur HTTPS avec une règle par défaut qui transmet le trafic au groupe cible VPC Lattice spécifié.aws vpc-lattice create-listener \ --name
my-service-listener
\ --protocolHTTPS
\ --port443
\ --service-identifiersvc-0285b53b2eEXAMPLE
\ --default-actionfile://listener-config.json
Contenu de
listener-config.json
:{ "forward": { "targetGroups": [ { "targetGroupIdentifier": "tg-0eaa4b9ab4EXAMPLE" } ] } }
Sortie :
{ "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" }
Pour plus d'informations, consultez la section Listeners dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous CreateListener
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-service-network-service-association
.
- AWS CLI
-
Pour créer une association de services
L'
create-service-network-service-association
exemple suivant associe le service spécifié au réseau de service spécifié.aws vpc-lattice create-service-network-service-association \ --service-identifier
svc-0285b53b2eEXAMPLE
\ --service-network-identifiersn-080ec7dc93EXAMPLE
Sortie :
{ "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" }
Pour plus d'informations, consultez Gérer les associations de services dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous CreateServiceNetworkServiceAssociation
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-service-network-vpc-association
.
- AWS CLI
-
Pour créer une association VPC
L'
create-service-network-vpc-association
exemple suivant associe le vpc spécifié au réseau de service spécifié. Le groupe de sécurité spécifié contrôle les ressources du VPC qui peuvent accéder au réseau de services et à ses services.aws vpc-lattice create-service-network-vpc-association \ --vpc-identifier
vpc-0a1b2c3d4eEXAMPLE
\ --service-network-identifiersn-080ec7dc93EXAMPLE
\ --security-group-idssg-0aee16bc6cEXAMPLE
Sortie :
{ "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkvpcassociation/snva-0821fc8631EXAMPLE", "createdBy": "123456789012", "id": "snva-0821fc8631EXAMPLE", "securityGroupIds": [ "sg-0aee16bc6cEXAMPLE" ], "status": "CREATE_IN_PROGRESS" }
Pour plus d'informations, consultez Gérer les associations VPC dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous CreateServiceNetworkVpcAssociation
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-service-network
.
- AWS CLI
-
Pour créer un réseau de service
L'
create-service-network
exemple suivant crée un réseau de service portant le nom spécifié.aws vpc-lattice create-service-network \ --name
my-service-network
Sortie :
{ "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE", "authType": "NONE", "id": "sn-080ec7dc93EXAMPLE", "name": "my-service-network" }
Pour plus d'informations, consultez la section Réseaux de services dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous CreateServiceNetwork
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-service
.
- AWS CLI
-
Pour créer un service
L'
create-service
exemple suivant crée un service portant le nom spécifié.aws vpc-lattice create-service \ --name
my-lattice-service
Sortie :
{ "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" }
Pour plus d'informations, consultez la section Services in VPC Lattice dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous CreateService
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-target-group
.
- AWS CLI
-
Exemple 1 : pour créer un groupe cible de type INSTANCE
L'
create-target-group
exemple suivant crée un groupe cible avec le nom, le type et la configuration spécifiés.aws vpc-lattice create-target-group \ --name
my-lattice-target-group-instance
\ --typeINSTANCE
\ --configfile://tg-config.json
Contenu de
tg-config.json
:{ "port": 443, "protocol": "HTTPS", "protocolVersion": "HTTP1", "vpcIdentifier": "vpc-f1663d9868EXAMPLE" }
Sortie :
{ "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" }
Exemple 2 : pour créer un groupe cible de type IP
L'
create-target-group
exemple suivant crée un groupe cible avec le nom, le type et la configuration spécifiés.aws vpc-lattice create-target-group \ --name
my-lattice-target-group-ip
\ --typeIP
\ --configfile://tg-config.json
Contenu de
tg-config.json
:{ "ipAddressType": "IPV4", "port": 443, "protocol": "HTTPS", "protocolVersion": "HTTP1", "vpcIdentifier": "vpc-f1663d9868EXAMPLE" }
Sortie :
{ "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" }
Exemple 3 : pour créer un groupe cible de type LAMBDA
L'
create-target-group
exemple suivant crée un groupe cible avec le nom, le type et la configuration spécifiés.aws vpc-lattice create-target-group \ --name
my-lattice-target-group-lambda
\ --typeLAMBDA
Sortie :
{ "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" }
Exemple 4 : Pour créer un groupe cible de type ALB
L'
create-target-group
exemple suivant crée un groupe cible avec le nom, le type et la configuration spécifiés.aws vpc-lattice create-target-group \ --name
my-lattice-target-group-alb
\ --typeALB
\ --configfile://tg-config.json
Contenu de
tg-config.json
:{ "port": 443, "protocol": "HTTPS", "protocolVersion": "HTTP1", "vpcIdentifier": "vpc-f1663d9868EXAMPLE" }
Sortie :
{ "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" }
Pour plus d'informations, consultez la section Groupes cibles dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous CreateTargetGroup
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-auth-policy
.
- AWS CLI
-
Pour supprimer une politique d'authentification
L'
delete-auth-policy
exemple suivant supprime la politique d'authentification pour le service spécifié.aws vpc-lattice delete-auth-policy \ --resource-identifier
svc-0285b53b2eEXAMPLE
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez les politiques d'authentification dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous DeleteAuthPolicy
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-listener
.
- AWS CLI
-
Pour supprimer un écouteur
L'
delete-listener
exemple suivant supprime l'écouteur spécifié.aws vpc-lattice delete-listener \ --listener-identifier
listener-07cc7fb0abEXAMPLE
\ --service-identifiersvc-0285b53b2eEXAMPLE
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Listeners dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous DeleteListener
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-service-network-service-association
.
- AWS CLI
-
Pour supprimer une association de services
L'
delete-service-network-service-association
exemple suivant dissocie l'association de service spécifiée.aws vpc-lattice delete-service-network-service-association \ --service-network-service-association-identifier
snsa-031fabb4d8EXAMPLE
Sortie :
{ "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkserviceassociation/snsa-031fabb4d8EXAMPLE", "id": "snsa-031fabb4d8EXAMPLE", "status": "DELETE_IN_PROGRESS" }
Pour plus d'informations, consultez Gérer les associations de services dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous DeleteServiceNetworkServiceAssociation
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-service-network-vpc-association
.
- AWS CLI
-
Pour supprimer une association VPC
L'
delete-service-network-vpc-association
exemple suivant dissocie l'association VPC spécifiée.aws vpc-lattice delete-service-network-vpc-association \ --service-network-vpc-association-identifier
snva-0821fc8631EXAMPLE
Sortie :
{ "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkvpcassociation/snva-0821fc8631EXAMPLE", "id": "snva-0821fc8631EXAMPLE", "status": "DELETE_IN_PROGRESS" }
Pour plus d'informations, consultez Gérer les associations VPC dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous DeleteServiceNetworkVpcAssociation
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-service-network
.
- AWS CLI
-
Pour supprimer un réseau de service
L'
delete-service-network
exemple suivant supprime le réseau de service spécifié.aws vpc-lattice delete-service-network \ --service-network-identifier
sn-080ec7dc93EXAMPLE
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez la section Réseaux de services dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous DeleteServiceNetwork
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-service
.
- AWS CLI
-
Pour supprimer un service
L'
delete-service
exemple suivant supprime le service spécifié.aws vpc-lattice delete-service \ --service-identifier
svc-0285b53b2eEXAMPLE
Sortie :
{ "arn": "arn:aws:vpc-lattice:us-west-2:123456789012:service/svc-0285b53b2eEXAMPLE", "id": "svc-0285b53b2eEXAMPLE", "name": "my-lattice-service", "status": "DELETE_IN_PROGRESS" }
Pour plus d'informations, consultez la section Services in VPC Lattice dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous DeleteService
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-target-group
.
- AWS CLI
-
Pour supprimer un groupe cible
L'
delete-target-group
exemple suivant supprime le groupe cible spécifié.aws vpc-lattice delete-target-group \ --target-group-identifier
tg-0eaa4b9ab4EXAMPLE
Sortie :
{ "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE", "id": "tg-0eaa4b9ab4EXAMPLE", "status": "DELETE_IN_PROGRESS" }
Pour plus d'informations, consultez la section Groupes cibles dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous DeleteTargetGroup
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserderegister-targets
.
- AWS CLI
-
Pour désenregistrer une cible
L'
deregister-targets
exemple suivant désenregistre la cible spécifiée du groupe cible spécifié.aws vpc-lattice deregister-targets \ --targets
i-07dd579bc5EXAMPLE
\ --target-group-identifiertg-0eaa4b9ab4EXAMPLE
Sortie :
{ "successful": [ { "id": "i-07dd579bc5EXAMPLE", "port": 443 } ], "unsuccessful": [] }
Pour plus d'informations, consultez la section Enregistrer des cibles dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous DeregisterTargets
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-auth-policy
.
- AWS CLI
-
Pour obtenir des informations sur une politique d'authentification
L'
get-auth-policy
exemple suivant permet d'obtenir des informations sur la politique d'authentification pour le service spécifié.aws vpc-lattice get-auth-policy \ --resource-identifier
svc-0285b53b2eEXAMPLE
Sortie :
{ "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" }
Pour plus d'informations, consultez les politiques d'authentification dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous GetAuthPolicy
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-listener
.
- AWS CLI
-
Pour obtenir des informations sur un service listener
L'
get-listener
exemple suivant permet d'obtenir des informations sur l'écouteur spécifié pour le service spécifié.aws vpc-lattice get-listener \ --listener-identifier
listener-0ccf55918cEXAMPLE
\ --service-identifiersvc-0285b53b2eEXAMPLE
Sortie :
{ "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" }
Pour plus d'informations, consultez la section Définir le routage dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous GetListener
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-service-network-service-association
.
- AWS CLI
-
Pour obtenir des informations sur une association de services
L'
get-service-network-service-association
exemple suivant permet d'obtenir des informations sur l'association de services spécifiée.aws vpc-lattice get-service-network-service-association \ --service-network-service-association-identifier
snsa-031fabb4d8EXAMPLE
Sortie :
{ "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" }
Pour plus d'informations, consultez Gérer les associations de services dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous GetServiceNetworkServiceAssociation
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-service-network-vpc-association
.
- AWS CLI
-
Pour obtenir des informations sur une association VPC
L'
get-service-network-vpc-association
exemple suivant obtient des informations sur l'association VPC spécifiée.aws vpc-lattice get-service-network-vpc-association \ --service-network-vpc-association-identifier
snva-0821fc8631EXAMPLE
Sortie :
{ "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" }
Pour plus d'informations, consultez Gérer les associations VPC dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous GetServiceNetworkVpcAssociation
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-service-network
.
- AWS CLI
-
Pour obtenir des informations sur un réseau de service
L'
get-service-network
exemple suivant permet d'obtenir des informations sur le réseau de service spécifié.aws vpc-lattice get-service-network \ --service-network-identifier
sn-080ec7dc93EXAMPLE
Sortie :
{ "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 }
Pour plus d'informations, consultez la section Réseaux de services dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous GetServiceNetwork
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-service
.
- AWS CLI
-
Pour obtenir des informations sur un service
L'
get-service
exemple suivant permet d'obtenir des informations sur le service spécifié.aws vpc-lattice get-service \ --service-identifier
svc-0285b53b2eEXAMPLE
Sortie :
{ "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" }
Pour plus d'informations, consultez la section Services du guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous GetService
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-target-group
.
- AWS CLI
-
Pour obtenir des informations sur un groupe cible
L'
get-target-group
exemple suivant obtient des informations sur le groupe cible spécifié, dont le type de cible estINSTANCE
.aws vpc-lattice get-target-group \ --target-group-identifier
tg-0eaa4b9ab4EXAMPLE
Sortie :
{ "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" }
Pour plus d'informations, consultez la section Groupes cibles dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous GetTargetGroup
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-listeners
.
- AWS CLI
-
Pour répertorier les auditeurs du service
L'
list-listeners
exemple suivant répertorie les écouteurs pour le service spécifié.aws vpc-lattice list-listeners \ --service-identifier
svc-0285b53b2eEXAMPLE
Sortie :
{ "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" } ] }
Pour plus d'informations, consultez la section Définir le routage dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous ListListeners
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-service-network-service-associations
.
- AWS CLI
-
Pour répertorier les associations de services
L'
list-service-network-service-associations
exemple suivant répertorie les associations de service pour le réseau de service spécifié. L'--query
option étend la sortie à l'une IDs des associations de services.aws vpc-lattice list-service-network-service-associations \ --service-network-identifier
sn-080ec7dc93EXAMPLE
\ --queryitems[*].id
Sortie :
[ "snsa-031fabb4d8EXAMPLE", "snsa-0e16955a8cEXAMPLE" ]
Pour plus d'informations, consultez Gérer les associations de services dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous ListServiceNetworkServiceAssociations
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-service-network-vpc-associations
.
- AWS CLI
-
Pour répertorier les associations de VPC
L'
list-service-network-vpc-associations
exemple suivant répertorie les associations VPC pour le réseau de service spécifié. L'--query
option étend la sortie à l'une IDs des associations VPC.aws vpc-lattice list-service-network-vpc-associations \ --service-network-identifier
sn-080ec7dc93EXAMPLE
\ --queryitems[*].id
Sortie :
[ "snva-0821fc8631EXAMPLE", "snva-0c5dcb60d6EXAMPLE" ]
Pour plus d'informations, consultez Gérer les associations VPC dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous ListServiceNetworkVpcAssociations
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-service-networks
.
- AWS CLI
-
Pour répertorier vos réseaux de service
L'
list-service-networks
exemple suivant répertorie les réseaux de service détenus ou partagés avec le compte d'appel. L'--query
option étend les résultats aux Amazon Resource Names (ARN) des réseaux de services.aws vpc-lattice list-service-networks \ --query
items[*].arn
Sortie :
[ "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE", "arn:aws:vpc-lattice:us-east-2:111122223333:servicenetwork/sn-0ec4d436cfEXAMPLE" ]
Pour plus d'informations, consultez la section Réseaux de services dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous ListServiceNetworks
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-services
.
- AWS CLI
-
Pour répertorier vos services
L'
list-services
exemple suivant répertorie les services détenus ou partagés avec le compte d'appel. L'--query
option étend les résultats aux Amazon Resource Names (ARN) des services.aws vpc-lattice list-services \ --query
items[*].arn
Sortie :
[ "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE", "arn:aws:vpc-lattice:us-east-2:111122223333:service/svc-0b8ac96550EXAMPLE" ]
Pour plus d'informations, consultez la section Services du guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous ListServices
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-target-groups
.
- AWS CLI
-
Pour répertorier vos groupes cibles
L'
list-target-groups
exemple suivant répertorie les groupes cibles dont le type de cible estLAMBDA
.aws vpc-lattice list-target-groups \ --target-group-type
LAMBDA
Sortie :
{ "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" } ] }
Pour plus d'informations, consultez la section Groupes cibles dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous ListTargetGroups
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-targets
.
- AWS CLI
-
Pour répertorier les cibles d'un groupe cible
L'
list-targets
exemple suivant répertorie les cibles pour le groupe cible spécifié.aws vpc-lattice list-targets \ --target-group-identifier
tg-0eaa4b9ab4EXAMPLE
Sortie :
{ "items": [ { "id": "i-07dd579bc5EXAMPLE", "port": 443, "status": "HEALTHY" }, { "id": "i-047b3c9078EXAMPLE", "port": 443, "reasonCode": "HealthCheckFailed", "status": "UNHEALTHY" } ] }
Pour plus d'informations, consultez la section Groupes cibles dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous ListTargets
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserput-auth-policy
.
- AWS CLI
-
Pour créer une politique d'authentification pour un service
L'
put-auth-policy
exemple suivant autorise l'accès aux demandes provenant de n'importe quel principal authentifié utilisant le rôle IAM spécifié. La ressource est l'ARN du service auquel la politique est attachée.aws vpc-lattice put-auth-policy \ --resource-identifier
svc-0285b53b2eEXAMPLE
\ --policyfile://auth-policy.json
Contenu de
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" } ] }
Sortie :
{ "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" }
Pour plus d'informations, consultez les politiques d'authentification dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous PutAuthPolicy
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserregister-targets
.
- AWS CLI
-
Pour enregistrer une cible
L'
register-targets
exemple suivant enregistre les cibles spécifiées auprès du groupe cible spécifié.aws vpc-lattice register-targets \ --targets
id=i-047b3c9078EXAMPLE
id=i-07dd579bc5EXAMPLE
\ --target-group-identifiertg-0eaa4b9ab4EXAMPLE
Sortie :
{ "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 } ] }
Pour plus d'informations, consultez la section Enregistrer des cibles dans le guide de l'utilisateur Amazon VPC Lattice.
-
Pour plus de détails sur l'API, reportez-vous RegisterTargets
à la section Référence des AWS CLI commandes.
-