Utilisation CreateVpcEndpoint avec un AWS SDK ou une CLI

Les exemples de code suivants montrent comment utiliserCreateVpcEndpoint.

CLI

AWS CLI

Exemple 1 : pour créer un point de terminaison de passerelle

L'create-vpc-endpointexemple suivant crée un point de terminaison VPC de passerelle entre le VPC et Amazon vpc-1a2b3c4d S3 dans la us-east-1 région, et associe une table rtb-11aa22bb de routage au point de terminaison.

aws ec2 create-vpc-endpoint \
    --vpc-id vpc-1a2b3c4d \
    --service-name com.amazonaws.us-east-1.s3 \
    --route-table-ids rtb-11aa22bb

Sortie :

{
    "VpcEndpoint": {
        "PolicyDocument": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"\",\"Effect\":\"Allow\",\"Principal\":\"\*\",\"Action\":\"\*\",\"Resource\":\"\*\"}]}",
        "VpcId": "vpc-1a2b3c4d",
        "State": "available",
        "ServiceName": "com.amazonaws.us-east-1.s3",
        "RouteTableIds": [
            "rtb-11aa22bb"
        ],
        "VpcEndpointId": "vpc-1a2b3c4d",
        "CreationTimestamp": "2015-05-15T09:40:50Z"
    }
}

Pour plus d'informations, consultez la section Création d'un point de terminaison de passerelle dans le AWS PrivateLink Guide.

Exemple 2 : pour créer un point de terminaison d'interface

L'create-vpc-endpointexemple suivant crée un point de terminaison VPC d'interface entre VPC et Amazon vpc-1a2b3c4d S3 dans la région. us-east-1 La commande crée le point de terminaison dans un sous-réseausubnet-1a2b3c4d, l'associe au groupe sg-1a2b3c4d de sécurité et ajoute une balise avec la clé « Service » et la valeur « S3 ».

aws ec2 create-vpc-endpoint \
    --vpc-id vpc-1a2b3c4d \
    --vpc-endpoint-type Interface \
    --service-name com.amazonaws.us-east-1.s3 \
    --subnet-ids subnet-7b16de0c \
    --security-group-id sg-1a2b3c4d \
    --tag-specifications ResourceType=vpc-endpoint,Tags=[{Key=service,Value=S3}]

Sortie :

{
    "VpcEndpoint": {
        "VpcEndpointId": "vpce-1a2b3c4d5e6f1a2b3",
        "VpcEndpointType": "Interface",
        "VpcId": "vpc-1a2b3c4d",
        "ServiceName": "com.amazonaws.us-east-1.s3",
        "State": "pending",
        "RouteTableIds": [],
        "SubnetIds": [
            "subnet-1a2b3c4d"
        ],
        "Groups": [
            {
                "GroupId": "sg-1a2b3c4d",
                "GroupName": "default"
            }
        ],
        "PrivateDnsEnabled": false,
        "RequesterManaged": false,
        "NetworkInterfaceIds": [
            "eni-0b16f0581c8ac6877"
        ],
        "DnsEntries": [
            {
                "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg.s3.us-east-1.vpce.amazonaws.com",
                "HostedZoneId": "Z7HUB22UULQXV"
            },
            {
                "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg-us-east-1c.s3.us-east-1.vpce.amazonaws.com",
                "HostedZoneId": "Z7HUB22UULQXV"
            }
        ],
        "CreationTimestamp": "2021-03-05T14:46:16.030000+00:00",
        "Tags": [
            {
                "Key": "service",
                "Value": "S3"
            }
        ],
        "OwnerId": "123456789012"
    }
}

Pour plus d'informations, consultez la section Création d'un point de terminaison d'interface dans le guide de l'utilisateur pour AWS PrivateLink.

Exemple 3 : pour créer un point de terminaison Gateway Load Balancer

L'create-vpc-endpointexemple suivant crée un point de terminaison Gateway Load Balancer entre un VPC vpc-111122223333aabbc et un service configuré à l'aide d'un Gateway Load Balancer.

aws ec2 create-vpc-endpoint \
    --service-name com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123 \
    --vpc-endpoint-type GatewayLoadBalancer \
    --vpc-id vpc-111122223333aabbc \
    --subnet-ids subnet-0011aabbcc2233445

Sortie :

{
    "VpcEndpoint": {
        "VpcEndpointId": "vpce-aabbaabbaabbaabba",
        "VpcEndpointType": "GatewayLoadBalancer",
        "VpcId": "vpc-111122223333aabbc",
        "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123",
        "State": "pending",
        "SubnetIds": [
            "subnet-0011aabbcc2233445"
        ],
        "RequesterManaged": false,
        "NetworkInterfaceIds": [
            "eni-01010120203030405"
        ],
        "CreationTimestamp": "2020-11-11T08:06:03.522Z",
        "OwnerId": "123456789012"
    }
}

Pour plus d'informations, consultez la section Points de terminaison Gateway Load Balancer dans le guide de l'utilisateur de. AWS PrivateLink

• Pour plus de détails sur l'API, reportez-vous CreateVpcEndpointà la section Référence des AWS CLI commandes.

PowerShell

Outils pour PowerShell

Exemple 1 : Cet exemple crée un nouveau point de terminaison VPC pour le service com.amazonaws.eu-west-1.s3 dans le VPC vpc-0fc1ff23f45b678eb

New-EC2VpcEndpoint -ServiceName com.amazonaws.eu-west-1.s3 -VpcId vpc-0fc1ff23f45b678eb

Sortie :

ClientToken VpcEndpoint
----------- -----------
            Amazon.EC2.Model.VpcEndpoint

• Pour plus de détails sur l'API, reportez-vous CreateVpcEndpointà la section Référence des AWS Tools for PowerShell applets de commande.

Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultezCréation de ressources Amazon EC2 à l'aide d'un SDK AWS. Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes de SDK.