Getting Information About Your VPC Endpoints

You can get information about one or more of your Virtual Private Cloud (VPC) endpoints, like the name of the targeted service or the VPC in which it is.

If you exceed the number of identical requests allowed for a configured time period, the RequestLimitExceeded error message is returned.

This procedure uses AWS CLI only. Information about these resources is also available from Cockpit v1. For more information, see VPC User Interface.

To get information about one or more of your VPC endpoints, use the describe-vpc-endpoints command following this syntax:

Request sample
$ aws ec2 describe-vpc-endpoint \
    --profile YOUR_PROFILE \
    --vpc-endpoint-ids vpce-12345678 \
    [--filters NOT_SPECIFIED] \
    --endpoint https://fcu.eu-west-2.outscale.com

This command contains the following attributes that you need to specify:

  • (optional) profile: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI.

  • vpc-endpoints-ids: One or more IDs of VPC endpoints.

  • (optional) filters: One or more filters, in the "Name=X,Values=Y" format.

    You can specify several values for a same filter using the "Name=X,Values=Y, Z" format.

    The following filters are available:

    • service-name: The name of the prefix list corresponding to the service. For more information, see Getting Information About Prefix Lists.

    • vpc-id: The ID of the VPC.

    • vpc-endpoint-id: The ID of the VPC endpoint.

    • vpc-endpoint-state: The state of the VPC endpoint (pending | available). For more information, see About VPC Endpoints.

  • endpoint: The endpoint corresponding to the Region you want to send the request to.

The describe-vpc-endpoints command returns the following elements:

  • VpcEndpoints: Information about one or more VPC endpoints. This element contains the following information:

    • VpcId: The ID of the VPC in which the VPC endpoint is.

    • State: The state of the VPC endpoint. For more information, see About VPC Endpoints.

    • ServiceName: The name of the prefix list corresponding to the service.

    • RouteTableIds: One or more IDs of route tables routing traffic to the service using the VPC endpoint.

    • VpcEndpointId: The ID of the VPC endpoint.

    • CreationTimestamp: The date and time of creation of the VPC endpoint.

Result sample
{
  "VpcEndpoints": [
                   {
                    "VpcId": "vpc-1234abcd",
                    "State": "available",
                    "ServiceName": "com.outscale.eu-west-2.oos",
                    "RouteTableIds": [
                                      "rtb-87654321"
                                     ],
                    "VpcEndpointId": "vpce-12345678",
                    "CreationTimestamp": "2016-10-16T17:02:42Z"
                   }
                  ]
}

Related Pages

Corresponding API Method

AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.