:doc:`PcaConnectorAd <../../pca-connector-ad>` / Client / create_connector

****************
create_connector
****************



.. py:method:: PcaConnectorAd.Client.create_connector(**kwargs)

  

  Creates a connector between Amazon Web Services Private CA and an Active Directory. You must specify the private CA, directory ID, and security groups.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/pca-connector-ad-2018-05-10/CreateConnector>`_  


  **Request Syntax**
  ::

    response = client.create_connector(
        CertificateAuthorityArn='string',
        ClientToken='string',
        DirectoryId='string',
        Tags={
            'string': 'string'
        },
        VpcInformation={
            'IpAddressType': 'IPV4'|'DUALSTACK',
            'SecurityGroupIds': [
                'string',
            ]
        }
    )
    
  :type CertificateAuthorityArn: string
  :param CertificateAuthorityArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the certificate authority being used.

    

  
  :type ClientToken: string
  :param ClientToken: 

    Idempotency token.

    This field is autopopulated if not provided.

  
  :type DirectoryId: string
  :param DirectoryId: **[REQUIRED]** 

    The identifier of the Active Directory.

    

  
  :type Tags: dict
  :param Tags: 

    Metadata assigned to a connector consisting of a key-value pair.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  :type VpcInformation: dict
  :param VpcInformation: **[REQUIRED]** 

    Information about your VPC and security groups used with the connector.

    

  
    - **IpAddressType** *(string) --* 

      The VPC IP address type.

      

    
    - **SecurityGroupIds** *(list) --* **[REQUIRED]** 

      The security groups used with the connector. You can use a maximum of 4 security groups with a connector.

      

    
      - *(string) --* 

      
  
  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'ConnectorArn': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ConnectorArn** *(string) --* 

        If successful, the Amazon Resource Name (ARN) of the connector for Active Directory.

        
  
  **Exceptions**
  
  *   :py:class:`PcaConnectorAd.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`PcaConnectorAd.Client.exceptions.ValidationException`

  
  *   :py:class:`PcaConnectorAd.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`PcaConnectorAd.Client.exceptions.ThrottlingException`

  
  *   :py:class:`PcaConnectorAd.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`PcaConnectorAd.Client.exceptions.InternalServerException`

  
  *   :py:class:`PcaConnectorAd.Client.exceptions.ConflictException`

  