---
title: "GET /connectors"
method: GET
path: "/connectors"
---

# GET /connectors

`GET /connectors`

Lists the connectors that you created by using the <a href="https://docs.aws.amazon.com/pca-connector-ad/latest/APIReference/API_CreateConnector">https://docs.aws.amazon.com/pca-connector-ad/latest/APIReference/API_CreateConnector</a> action.

## Query parameters

- `MaxResults` integer
- `NextToken` string

## Response `200`

Success

- ListConnectorsResponse
  - `Connectors` ConnectorSummary[] — Summary information about each connector you have created.
    - `Arn` string — The Amazon Resource Name (ARN) that was returned when you called <a href="https://docs.aws.amazon.com/pca-connector-ad/latest/APIReference/API_CreateConnector.html">CreateConnector</a>.
    - `CertificateAuthorityArn` string — The Amazon Resource Name (ARN) of the certificate authority being used.
    - `CertificateEnrollmentPolicyServerEndpoint` string — Certificate enrollment endpoint for Active Directory domain-joined objects to request certificates.
    - `CreatedAt` string, date-time — The date and time that the connector was created.
    - `DirectoryId` string — The identifier of the Active Directory.
    - `Status` 'CREATING' | 'ACTIVE' | 'DELETING' | 'FAILED' — Status of the connector. Status can be creating, active, deleting, or failed.
    - `StatusReason` 'CA_CERTIFICATE_REGISTRATION_FAILED' | 'DIRECTORY_ACCESS_DENIED' | 'INTERNAL_FAILURE' | 'INSUFFICIENT_FREE_ADDRESSES' | 'INVALID_SUBNET_IP_PROTOCOL' | 'PRIVATECA_ACCESS_DENIED' | 'PRIVATECA_RESOURCE_NOT_FOUND' | 'SECURITY_GROUP_NOT_IN_VPC' | 'VPC_ACCESS_DENIED' | 'VPC_ENDPOINT_LIMIT_EXCEEDED' | 'VPC_RESOURCE_NOT_FOUND' — Additional information about the connector status if the status is failed.
    - `UpdatedAt` string, date-time — The date and time that the connector was updated.
    - `VpcInformation` object — Information of the VPC and security group(s) used with the connector.
      - `IpAddressType` 'IPV4' | 'DUALSTACK' — The VPC IP address type.
      - `SecurityGroupIds` SecurityGroupId[], required — The security groups used with the connector. You can use a maximum of 4 security groups with a connector.
  - `NextToken` string — Use this parameter when paginating results in a subsequent request after you receive a response with truncated results. Set it to the value of the NextToken parameter from the response you just received.

## Other responses

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

---

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