---
title: "POST /ListPrivateConnections"
method: POST
path: "/ListPrivateConnections"
---

# POST /ListPrivateConnections

`POST /ListPrivateConnections`

Lists the private connections in your account.

## Request body

- object
  - `maxResults` integer — Maximum results for pagination.
  - `nextToken` string — Pagination token.

## Response `200`

Success

- ListPrivateConnectionsOutput
  - `privateConnections` PrivateConnectionSummary[], required — The list of private connections.
    - `name` string, required — The name of the private connection.
    - `type` 'SERVICE_MANAGED' | 'SELF_MANAGED', required — The type of the private connection, indicating whether it is service-managed or self-managed.
    - `status` 'ACTIVE' | 'CREATE_IN_PROGRESS' | 'CREATE_FAILED' | 'DELETE_IN_PROGRESS' | 'DELETE_FAILED', required — The current status of the private connection.
    - `resourceGatewayId` string — The identifier or ARN of the VPC Lattice resource gateway.
    - `hostAddress` string — The IP address or DNS name of the target resource.
    - `vpcId` string — The identifier of the VPC the resource gateway is created in.
    - `resourceConfigurationId` string — The identifier or ARN of the VPC Lattice resource configuration.
    - `certificateExpiryTime` string, date-time — The date and time the connection's certificate expires, in UTC format.
    - `dnsResolution` 'PUBLIC' | 'IN_VPC' — The DNS resolution mode for the resource gateway.
    - `failureMessage` string — A message describing why the private connection entered a failed state, if applicable.
    - `tags` object — The tags attached to the private connection.
  - `nextToken` string — The token to use to retrieve the next page of results, if more results are available.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — ThrottlingException
- `483` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/securityagent.md) · [All operations](https://skmtc.net/aws/apis/securityagent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/securityagent/versions/cad56717d636/schema)