Skip to content

PcaConnectorAdClient#

Index > PcaConnectorAd > PcaConnectorAdClient

Auto-generated documentation for PcaConnectorAd type annotations stubs module mypy-boto3-pca-connector-ad.

PcaConnectorAdClient#

Type annotations and code completion for boto3.client("pca-connector-ad"). boto3 documentation

# PcaConnectorAdClient usage example

from boto3.session import Session
from mypy_boto3_pca_connector_ad.client import PcaConnectorAdClient

def get_pca-connector-ad_client() -> PcaConnectorAdClient:
    return Session().client("pca-connector-ad")

Exceptions#

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("pca-connector-ad").exceptions structure.

# Exceptions.exceptions usage example

client = boto3.client("pca-connector-ad")

try:
    do_something(client)
except (
    client.exceptions.AccessDeniedException,
    client.exceptions.ClientError,
    client.exceptions.ConflictException,
    client.exceptions.InternalServerException,
    client.exceptions.ResourceNotFoundException,
    client.exceptions.ServiceQuotaExceededException,
    client.exceptions.ThrottlingException,
    client.exceptions.ValidationException,
) as e:
    print(e)
# Exceptions.exceptions type checking example

from mypy_boto3_pca_connector_ad.client import Exceptions

def handle_error(exc: Exceptions.AccessDeniedException) -> None:
    ...

Methods#

can_paginate#

Type annotations and code completion for boto3.client("pca-connector-ad").can_paginate method. boto3 documentation

# can_paginate method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

generate_presigned_url#

Type annotations and code completion for boto3.client("pca-connector-ad").generate_presigned_url method. boto3 documentation

# generate_presigned_url method definition

def generate_presigned_url(
    self,
    ClientMethod: str,
    Params: Mapping[str, Any] = ...,
    ExpiresIn: int = 3600,
    HttpMethod: str = ...,
) -> str:
    ...

create_connector#

Creates a connector between Amazon Web Services Private CA and an Active Directory.

Type annotations and code completion for boto3.client("pca-connector-ad").create_connector method. boto3 documentation

# create_connector method definition

def create_connector(
    self,
    *,
    CertificateAuthorityArn: str,
    DirectoryId: str,
    VpcInformation: VpcInformationUnionTypeDef,  # (1)
    ClientToken: str = ...,
    Tags: Mapping[str, str] = ...,
) -> CreateConnectorResponseTypeDef:  # (2)
    ...
  1. See VpcInformationTypeDef VpcInformationOutputTypeDef
  2. See CreateConnectorResponseTypeDef
# create_connector method usage example with argument unpacking

kwargs: CreateConnectorRequestTypeDef = {  # (1)
    "CertificateAuthorityArn": ...,
    "DirectoryId": ...,
    "VpcInformation": ...,
}

parent.create_connector(**kwargs)
  1. See CreateConnectorRequestTypeDef

create_directory_registration#

Creates a directory registration that authorizes communication between Amazon Web Services Private CA and an Active Directory.

Type annotations and code completion for boto3.client("pca-connector-ad").create_directory_registration method. boto3 documentation

# create_directory_registration method definition

def create_directory_registration(
    self,
    *,
    DirectoryId: str,
    ClientToken: str = ...,
    Tags: Mapping[str, str] = ...,
) -> CreateDirectoryRegistrationResponseTypeDef:  # (1)
    ...
  1. See CreateDirectoryRegistrationResponseTypeDef
# create_directory_registration method usage example with argument unpacking

kwargs: CreateDirectoryRegistrationRequestTypeDef = {  # (1)
    "DirectoryId": ...,
}

parent.create_directory_registration(**kwargs)
  1. See CreateDirectoryRegistrationRequestTypeDef

create_service_principal_name#

Creates a service principal name (SPN) for the service account in Active Directory.

Type annotations and code completion for boto3.client("pca-connector-ad").create_service_principal_name method. boto3 documentation

# create_service_principal_name method definition

def create_service_principal_name(
    self,
    *,
    ConnectorArn: str,
    DirectoryRegistrationArn: str,
    ClientToken: str = ...,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# create_service_principal_name method usage example with argument unpacking

kwargs: CreateServicePrincipalNameRequestTypeDef = {  # (1)
    "ConnectorArn": ...,
    "DirectoryRegistrationArn": ...,
}

parent.create_service_principal_name(**kwargs)
  1. See CreateServicePrincipalNameRequestTypeDef

create_template#

Creates an Active Directory compatible certificate template.

Type annotations and code completion for boto3.client("pca-connector-ad").create_template method. boto3 documentation

# create_template method definition

def create_template(
    self,
    *,
    ConnectorArn: str,
    Definition: TemplateDefinitionUnionTypeDef,  # (1)
    Name: str,
    ClientToken: str = ...,
    Tags: Mapping[str, str] = ...,
) -> CreateTemplateResponseTypeDef:  # (2)
    ...
  1. See TemplateDefinitionTypeDef TemplateDefinitionOutputTypeDef
  2. See CreateTemplateResponseTypeDef
# create_template method usage example with argument unpacking

kwargs: CreateTemplateRequestTypeDef = {  # (1)
    "ConnectorArn": ...,
    "Definition": ...,
    "Name": ...,
}

parent.create_template(**kwargs)
  1. See CreateTemplateRequestTypeDef

create_template_group_access_control_entry#

Create a group access control entry.

Type annotations and code completion for boto3.client("pca-connector-ad").create_template_group_access_control_entry method. boto3 documentation

# create_template_group_access_control_entry method definition

def create_template_group_access_control_entry(
    self,
    *,
    AccessRights: AccessRightsTypeDef,  # (1)
    GroupDisplayName: str,
    GroupSecurityIdentifier: str,
    TemplateArn: str,
    ClientToken: str = ...,
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See AccessRightsTypeDef
  2. See EmptyResponseMetadataTypeDef
# create_template_group_access_control_entry method usage example with argument unpacking

kwargs: CreateTemplateGroupAccessControlEntryRequestTypeDef = {  # (1)
    "AccessRights": ...,
    "GroupDisplayName": ...,
    "GroupSecurityIdentifier": ...,
    "TemplateArn": ...,
}

parent.create_template_group_access_control_entry(**kwargs)
  1. See CreateTemplateGroupAccessControlEntryRequestTypeDef

delete_connector#

Deletes a connector for Active Directory.

Type annotations and code completion for boto3.client("pca-connector-ad").delete_connector method. boto3 documentation

# delete_connector method definition

def delete_connector(
    self,
    *,
    ConnectorArn: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# delete_connector method usage example with argument unpacking

kwargs: DeleteConnectorRequestTypeDef = {  # (1)
    "ConnectorArn": ...,
}

parent.delete_connector(**kwargs)
  1. See DeleteConnectorRequestTypeDef

delete_directory_registration#

Deletes a directory registration.

Type annotations and code completion for boto3.client("pca-connector-ad").delete_directory_registration method. boto3 documentation

# delete_directory_registration method definition

def delete_directory_registration(
    self,
    *,
    DirectoryRegistrationArn: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# delete_directory_registration method usage example with argument unpacking

kwargs: DeleteDirectoryRegistrationRequestTypeDef = {  # (1)
    "DirectoryRegistrationArn": ...,
}

parent.delete_directory_registration(**kwargs)
  1. See DeleteDirectoryRegistrationRequestTypeDef

delete_service_principal_name#

Deletes the service principal name (SPN) used by a connector to authenticate with your Active Directory.

Type annotations and code completion for boto3.client("pca-connector-ad").delete_service_principal_name method. boto3 documentation

# delete_service_principal_name method definition

def delete_service_principal_name(
    self,
    *,
    ConnectorArn: str,
    DirectoryRegistrationArn: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# delete_service_principal_name method usage example with argument unpacking

kwargs: DeleteServicePrincipalNameRequestTypeDef = {  # (1)
    "ConnectorArn": ...,
    "DirectoryRegistrationArn": ...,
}

parent.delete_service_principal_name(**kwargs)
  1. See DeleteServicePrincipalNameRequestTypeDef

delete_template#

Deletes a template.

Type annotations and code completion for boto3.client("pca-connector-ad").delete_template method. boto3 documentation

# delete_template method definition

def delete_template(
    self,
    *,
    TemplateArn: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# delete_template method usage example with argument unpacking

kwargs: DeleteTemplateRequestTypeDef = {  # (1)
    "TemplateArn": ...,
}

parent.delete_template(**kwargs)
  1. See DeleteTemplateRequestTypeDef

delete_template_group_access_control_entry#

Deletes a group access control entry.

Type annotations and code completion for boto3.client("pca-connector-ad").delete_template_group_access_control_entry method. boto3 documentation

# delete_template_group_access_control_entry method definition

def delete_template_group_access_control_entry(
    self,
    *,
    GroupSecurityIdentifier: str,
    TemplateArn: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# delete_template_group_access_control_entry method usage example with argument unpacking

kwargs: DeleteTemplateGroupAccessControlEntryRequestTypeDef = {  # (1)
    "GroupSecurityIdentifier": ...,
    "TemplateArn": ...,
}

parent.delete_template_group_access_control_entry(**kwargs)
  1. See DeleteTemplateGroupAccessControlEntryRequestTypeDef

get_connector#

Lists information about your connector.

Type annotations and code completion for boto3.client("pca-connector-ad").get_connector method. boto3 documentation

# get_connector method definition

def get_connector(
    self,
    *,
    ConnectorArn: str,
) -> GetConnectorResponseTypeDef:  # (1)
    ...
  1. See GetConnectorResponseTypeDef
# get_connector method usage example with argument unpacking

kwargs: GetConnectorRequestTypeDef = {  # (1)
    "ConnectorArn": ...,
}

parent.get_connector(**kwargs)
  1. See GetConnectorRequestTypeDef

get_directory_registration#

A structure that contains information about your directory registration.

Type annotations and code completion for boto3.client("pca-connector-ad").get_directory_registration method. boto3 documentation

# get_directory_registration method definition

def get_directory_registration(
    self,
    *,
    DirectoryRegistrationArn: str,
) -> GetDirectoryRegistrationResponseTypeDef:  # (1)
    ...
  1. See GetDirectoryRegistrationResponseTypeDef
# get_directory_registration method usage example with argument unpacking

kwargs: GetDirectoryRegistrationRequestTypeDef = {  # (1)
    "DirectoryRegistrationArn": ...,
}

parent.get_directory_registration(**kwargs)
  1. See GetDirectoryRegistrationRequestTypeDef

get_service_principal_name#

Lists the service principal name that the connector uses to authenticate with Active Directory.

Type annotations and code completion for boto3.client("pca-connector-ad").get_service_principal_name method. boto3 documentation

# get_service_principal_name method definition

def get_service_principal_name(
    self,
    *,
    ConnectorArn: str,
    DirectoryRegistrationArn: str,
) -> GetServicePrincipalNameResponseTypeDef:  # (1)
    ...
  1. See GetServicePrincipalNameResponseTypeDef
# get_service_principal_name method usage example with argument unpacking

kwargs: GetServicePrincipalNameRequestTypeDef = {  # (1)
    "ConnectorArn": ...,
    "DirectoryRegistrationArn": ...,
}

parent.get_service_principal_name(**kwargs)
  1. See GetServicePrincipalNameRequestTypeDef

get_template#

Retrieves a certificate template that the connector uses to issue certificates from a private CA.

Type annotations and code completion for boto3.client("pca-connector-ad").get_template method. boto3 documentation

# get_template method definition

def get_template(
    self,
    *,
    TemplateArn: str,
) -> GetTemplateResponseTypeDef:  # (1)
    ...
  1. See GetTemplateResponseTypeDef
# get_template method usage example with argument unpacking

kwargs: GetTemplateRequestTypeDef = {  # (1)
    "TemplateArn": ...,
}

parent.get_template(**kwargs)
  1. See GetTemplateRequestTypeDef

get_template_group_access_control_entry#

Retrieves the group access control entries for a template.

Type annotations and code completion for boto3.client("pca-connector-ad").get_template_group_access_control_entry method. boto3 documentation

# get_template_group_access_control_entry method definition

def get_template_group_access_control_entry(
    self,
    *,
    GroupSecurityIdentifier: str,
    TemplateArn: str,
) -> GetTemplateGroupAccessControlEntryResponseTypeDef:  # (1)
    ...
  1. See GetTemplateGroupAccessControlEntryResponseTypeDef
# get_template_group_access_control_entry method usage example with argument unpacking

kwargs: GetTemplateGroupAccessControlEntryRequestTypeDef = {  # (1)
    "GroupSecurityIdentifier": ...,
    "TemplateArn": ...,
}

parent.get_template_group_access_control_entry(**kwargs)
  1. See GetTemplateGroupAccessControlEntryRequestTypeDef

list_connectors#

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

Type annotations and code completion for boto3.client("pca-connector-ad").list_connectors method. boto3 documentation

# list_connectors method definition

def list_connectors(
    self,
    *,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListConnectorsResponseTypeDef:  # (1)
    ...
  1. See ListConnectorsResponseTypeDef
# list_connectors method usage example with argument unpacking

kwargs: ListConnectorsRequestTypeDef = {  # (1)
    "MaxResults": ...,
}

parent.list_connectors(**kwargs)
  1. See ListConnectorsRequestTypeDef

list_directory_registrations#

Lists the directory registrations that you created by using the https://docs.aws.amazon.com/pca-connector-ad/latest/APIReference/API_CreateDirectoryRegistration action.

Type annotations and code completion for boto3.client("pca-connector-ad").list_directory_registrations method. boto3 documentation

# list_directory_registrations method definition

def list_directory_registrations(
    self,
    *,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListDirectoryRegistrationsResponseTypeDef:  # (1)
    ...
  1. See ListDirectoryRegistrationsResponseTypeDef
# list_directory_registrations method usage example with argument unpacking

kwargs: ListDirectoryRegistrationsRequestTypeDef = {  # (1)
    "MaxResults": ...,
}

parent.list_directory_registrations(**kwargs)
  1. See ListDirectoryRegistrationsRequestTypeDef

list_service_principal_names#

Lists the service principal names that the connector uses to authenticate with Active Directory.

Type annotations and code completion for boto3.client("pca-connector-ad").list_service_principal_names method. boto3 documentation

# list_service_principal_names method definition

def list_service_principal_names(
    self,
    *,
    DirectoryRegistrationArn: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListServicePrincipalNamesResponseTypeDef:  # (1)
    ...
  1. See ListServicePrincipalNamesResponseTypeDef
# list_service_principal_names method usage example with argument unpacking

kwargs: ListServicePrincipalNamesRequestTypeDef = {  # (1)
    "DirectoryRegistrationArn": ...,
}

parent.list_service_principal_names(**kwargs)
  1. See ListServicePrincipalNamesRequestTypeDef

list_tags_for_resource#

Lists the tags, if any, that are associated with your resource.

Type annotations and code completion for boto3.client("pca-connector-ad").list_tags_for_resource method. boto3 documentation

# list_tags_for_resource method definition

def list_tags_for_resource(
    self,
    *,
    ResourceArn: str,
) -> ListTagsForResourceResponseTypeDef:  # (1)
    ...
  1. See ListTagsForResourceResponseTypeDef
# list_tags_for_resource method usage example with argument unpacking

kwargs: ListTagsForResourceRequestTypeDef = {  # (1)
    "ResourceArn": ...,
}

parent.list_tags_for_resource(**kwargs)
  1. See ListTagsForResourceRequestTypeDef

list_template_group_access_control_entries#

Lists group access control entries you created.

Type annotations and code completion for boto3.client("pca-connector-ad").list_template_group_access_control_entries method. boto3 documentation

# list_template_group_access_control_entries method definition

def list_template_group_access_control_entries(
    self,
    *,
    TemplateArn: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListTemplateGroupAccessControlEntriesResponseTypeDef:  # (1)
    ...
  1. See ListTemplateGroupAccessControlEntriesResponseTypeDef
# list_template_group_access_control_entries method usage example with argument unpacking

kwargs: ListTemplateGroupAccessControlEntriesRequestTypeDef = {  # (1)
    "TemplateArn": ...,
}

parent.list_template_group_access_control_entries(**kwargs)
  1. See ListTemplateGroupAccessControlEntriesRequestTypeDef

list_templates#

Lists the templates, if any, that are associated with a connector.

Type annotations and code completion for boto3.client("pca-connector-ad").list_templates method. boto3 documentation

# list_templates method definition

def list_templates(
    self,
    *,
    ConnectorArn: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> ListTemplatesResponseTypeDef:  # (1)
    ...
  1. See ListTemplatesResponseTypeDef
# list_templates method usage example with argument unpacking

kwargs: ListTemplatesRequestTypeDef = {  # (1)
    "ConnectorArn": ...,
}

parent.list_templates(**kwargs)
  1. See ListTemplatesRequestTypeDef

tag_resource#

Adds one or more tags to your resource.

Type annotations and code completion for boto3.client("pca-connector-ad").tag_resource method. boto3 documentation

# tag_resource method definition

def tag_resource(
    self,
    *,
    ResourceArn: str,
    Tags: Mapping[str, str],
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# tag_resource method usage example with argument unpacking

kwargs: TagResourceRequestTypeDef = {  # (1)
    "ResourceArn": ...,
    "Tags": ...,
}

parent.tag_resource(**kwargs)
  1. See TagResourceRequestTypeDef

untag_resource#

Removes one or more tags from your resource.

Type annotations and code completion for boto3.client("pca-connector-ad").untag_resource method. boto3 documentation

# untag_resource method definition

def untag_resource(
    self,
    *,
    ResourceArn: str,
    TagKeys: Sequence[str],
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
# untag_resource method usage example with argument unpacking

kwargs: UntagResourceRequestTypeDef = {  # (1)
    "ResourceArn": ...,
    "TagKeys": ...,
}

parent.untag_resource(**kwargs)
  1. See UntagResourceRequestTypeDef

update_template#

Update template configuration to define the information included in certificates.

Type annotations and code completion for boto3.client("pca-connector-ad").update_template method. boto3 documentation

# update_template method definition

def update_template(
    self,
    *,
    TemplateArn: str,
    Definition: TemplateDefinitionUnionTypeDef = ...,  # (1)
    ReenrollAllCertificateHolders: bool = ...,
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See TemplateDefinitionTypeDef TemplateDefinitionOutputTypeDef
  2. See EmptyResponseMetadataTypeDef
# update_template method usage example with argument unpacking

kwargs: UpdateTemplateRequestTypeDef = {  # (1)
    "TemplateArn": ...,
}

parent.update_template(**kwargs)
  1. See UpdateTemplateRequestTypeDef

update_template_group_access_control_entry#

Update a group access control entry you created using CreateTemplateGroupAccessControlEntry.

Type annotations and code completion for boto3.client("pca-connector-ad").update_template_group_access_control_entry method. boto3 documentation

# update_template_group_access_control_entry method definition

def update_template_group_access_control_entry(
    self,
    *,
    GroupSecurityIdentifier: str,
    TemplateArn: str,
    AccessRights: AccessRightsTypeDef = ...,  # (1)
    GroupDisplayName: str = ...,
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See AccessRightsTypeDef
  2. See EmptyResponseMetadataTypeDef
# update_template_group_access_control_entry method usage example with argument unpacking

kwargs: UpdateTemplateGroupAccessControlEntryRequestTypeDef = {  # (1)
    "GroupSecurityIdentifier": ...,
    "TemplateArn": ...,
}

parent.update_template_group_access_control_entry(**kwargs)
  1. See UpdateTemplateGroupAccessControlEntryRequestTypeDef

get_paginator#

Type annotations and code completion for boto3.client("pca-connector-ad").get_paginator method with overloads.