Skip to content

ACMClient

Index > ACM > ACMClient

Auto-generated documentation for ACM type annotations stubs module mypy-boto3-acm.

ACMClient

Type annotations and code completion for boto3.client("acm"). boto3 documentation

Usage example
from boto3.session import Session
from mypy_boto3_acm.client import ACMClient

def get_acm_client() -> ACMClient:
    return Session().client("acm")

Exceptions

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("acm").exceptions structure.

Usage example
client = boto3.client("acm")

try:
    do_something(client)
except (
    client.AccessDeniedException,
    client.ClientError,
    client.ConflictException,
    client.InvalidArgsException,
    client.InvalidArnException,
    client.InvalidDomainValidationOptionsException,
    client.InvalidParameterException,
    client.InvalidStateException,
    client.InvalidTagException,
    client.LimitExceededException,
    client.RequestInProgressException,
    client.ResourceInUseException,
    client.ResourceNotFoundException,
    client.TagPolicyException,
    client.ThrottlingException,
    client.TooManyTagsException,
    client.ValidationException,
) as e:
    print(e)
Type checking example
from mypy_boto3_acm.client import Exceptions

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

Methods

add_tags_to_certificate

Adds one or more tags to an ACM certificate.

Type annotations and code completion for boto3.client("acm").add_tags_to_certificate method. boto3 documentation

Method definition
def add_tags_to_certificate(
    self,
    *,
    CertificateArn: str,
    Tags: Sequence[TagTypeDef],  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See TagTypeDef
  2. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: AddTagsToCertificateRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
    "Tags": ...,
}

parent.add_tags_to_certificate(**kwargs)
  1. See AddTagsToCertificateRequestRequestTypeDef

can_paginate

Check if an operation can be paginated.

Type annotations and code completion for boto3.client("acm").can_paginate method. boto3 documentation

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

close

Closes underlying endpoint connections.

Type annotations and code completion for boto3.client("acm").close method. boto3 documentation

Method definition
def close(
    self,
) -> None:
    ...

delete_certificate

Deletes a certificate and its associated private key.

Type annotations and code completion for boto3.client("acm").delete_certificate method. boto3 documentation

Method definition
def delete_certificate(
    self,
    *,
    CertificateArn: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: DeleteCertificateRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
}

parent.delete_certificate(**kwargs)
  1. See DeleteCertificateRequestRequestTypeDef

describe_certificate

Returns detailed metadata about the specified ACM certificate.

Type annotations and code completion for boto3.client("acm").describe_certificate method. boto3 documentation

Method definition
def describe_certificate(
    self,
    *,
    CertificateArn: str,
) -> DescribeCertificateResponseTypeDef:  # (1)
    ...
  1. See DescribeCertificateResponseTypeDef
Usage example with kwargs
kwargs: DescribeCertificateRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
}

parent.describe_certificate(**kwargs)
  1. See DescribeCertificateRequestRequestTypeDef

export_certificate

Exports a private certificate issued by a private certificate authority (CA) for use anywhere.

Type annotations and code completion for boto3.client("acm").export_certificate method. boto3 documentation

Method definition
def export_certificate(
    self,
    *,
    CertificateArn: str,
    Passphrase: Union[str, bytes, IO[Any], StreamingBody],
) -> ExportCertificateResponseTypeDef:  # (1)
    ...
  1. See ExportCertificateResponseTypeDef
Usage example with kwargs
kwargs: ExportCertificateRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
    "Passphrase": ...,
}

parent.export_certificate(**kwargs)
  1. See ExportCertificateRequestRequestTypeDef

generate_presigned_url

Generate a presigned url given a client, its method, and arguments.

Type annotations and code completion for boto3.client("acm").generate_presigned_url method. boto3 documentation

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

get_account_configuration

Returns the account configuration options associated with an Amazon Web Services account.

Type annotations and code completion for boto3.client("acm").get_account_configuration method. boto3 documentation

Method definition
def get_account_configuration(
    self,
) -> GetAccountConfigurationResponseTypeDef:  # (1)
    ...
  1. See GetAccountConfigurationResponseTypeDef

get_certificate

Retrieves an Amazon-issued certificate and its certificate chain.

Type annotations and code completion for boto3.client("acm").get_certificate method. boto3 documentation

Method definition
def get_certificate(
    self,
    *,
    CertificateArn: str,
) -> GetCertificateResponseTypeDef:  # (1)
    ...
  1. See GetCertificateResponseTypeDef
Usage example with kwargs
kwargs: GetCertificateRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
}

parent.get_certificate(**kwargs)
  1. See GetCertificateRequestRequestTypeDef

import_certificate

Imports a certificate into Amazon Web Services Certificate Manager (ACM) to use with services that are integrated with ACM.

Type annotations and code completion for boto3.client("acm").import_certificate method. boto3 documentation

Method definition
def import_certificate(
    self,
    *,
    Certificate: Union[str, bytes, IO[Any], StreamingBody],
    PrivateKey: Union[str, bytes, IO[Any], StreamingBody],
    CertificateArn: str = ...,
    CertificateChain: Union[str, bytes, IO[Any], StreamingBody] = ...,
    Tags: Sequence[TagTypeDef] = ...,  # (1)
) -> ImportCertificateResponseTypeDef:  # (2)
    ...
  1. See TagTypeDef
  2. See ImportCertificateResponseTypeDef
Usage example with kwargs
kwargs: ImportCertificateRequestRequestTypeDef = {  # (1)
    "Certificate": ...,
    "PrivateKey": ...,
}

parent.import_certificate(**kwargs)
  1. See ImportCertificateRequestRequestTypeDef

list_certificates

Retrieves a list of certificate ARNs and domain names.

Type annotations and code completion for boto3.client("acm").list_certificates method. boto3 documentation

Method definition
def list_certificates(
    self,
    *,
    CertificateStatuses: Sequence[CertificateStatusType] = ...,  # (1)
    Includes: FiltersTypeDef = ...,  # (2)
    NextToken: str = ...,
    MaxItems: int = ...,
) -> ListCertificatesResponseTypeDef:  # (3)
    ...
  1. See CertificateStatusType
  2. See FiltersTypeDef
  3. See ListCertificatesResponseTypeDef
Usage example with kwargs
kwargs: ListCertificatesRequestRequestTypeDef = {  # (1)
    "CertificateStatuses": ...,
}

parent.list_certificates(**kwargs)
  1. See ListCertificatesRequestRequestTypeDef

list_tags_for_certificate

Lists the tags that have been applied to the ACM certificate.

Type annotations and code completion for boto3.client("acm").list_tags_for_certificate method. boto3 documentation

Method definition
def list_tags_for_certificate(
    self,
    *,
    CertificateArn: str,
) -> ListTagsForCertificateResponseTypeDef:  # (1)
    ...
  1. See ListTagsForCertificateResponseTypeDef
Usage example with kwargs
kwargs: ListTagsForCertificateRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
}

parent.list_tags_for_certificate(**kwargs)
  1. See ListTagsForCertificateRequestRequestTypeDef

put_account_configuration

Adds or modifies account-level configurations in ACM.

Type annotations and code completion for boto3.client("acm").put_account_configuration method. boto3 documentation

Method definition
def put_account_configuration(
    self,
    *,
    IdempotencyToken: str,
    ExpiryEvents: ExpiryEventsConfigurationTypeDef = ...,  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See ExpiryEventsConfigurationTypeDef
  2. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: PutAccountConfigurationRequestRequestTypeDef = {  # (1)
    "IdempotencyToken": ...,
}

parent.put_account_configuration(**kwargs)
  1. See PutAccountConfigurationRequestRequestTypeDef

remove_tags_from_certificate

Remove one or more tags from an ACM certificate.

Type annotations and code completion for boto3.client("acm").remove_tags_from_certificate method. boto3 documentation

Method definition
def remove_tags_from_certificate(
    self,
    *,
    CertificateArn: str,
    Tags: Sequence[TagTypeDef],  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See TagTypeDef
  2. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: RemoveTagsFromCertificateRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
    "Tags": ...,
}

parent.remove_tags_from_certificate(**kwargs)
  1. See RemoveTagsFromCertificateRequestRequestTypeDef

renew_certificate

Renews an eligible ACM certificate.

Type annotations and code completion for boto3.client("acm").renew_certificate method. boto3 documentation

Method definition
def renew_certificate(
    self,
    *,
    CertificateArn: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: RenewCertificateRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
}

parent.renew_certificate(**kwargs)
  1. See RenewCertificateRequestRequestTypeDef

request_certificate

Requests an ACM certificate for use with other Amazon Web Services services.

Type annotations and code completion for boto3.client("acm").request_certificate method. boto3 documentation

Method definition
def request_certificate(
    self,
    *,
    DomainName: str,
    ValidationMethod: ValidationMethodType = ...,  # (1)
    SubjectAlternativeNames: Sequence[str] = ...,
    IdempotencyToken: str = ...,
    DomainValidationOptions: Sequence[DomainValidationOptionTypeDef] = ...,  # (2)
    Options: CertificateOptionsTypeDef = ...,  # (3)
    CertificateAuthorityArn: str = ...,
    Tags: Sequence[TagTypeDef] = ...,  # (4)
) -> RequestCertificateResponseTypeDef:  # (5)
    ...
  1. See ValidationMethodType
  2. See DomainValidationOptionTypeDef
  3. See CertificateOptionsTypeDef
  4. See TagTypeDef
  5. See RequestCertificateResponseTypeDef
Usage example with kwargs
kwargs: RequestCertificateRequestRequestTypeDef = {  # (1)
    "DomainName": ...,
}

parent.request_certificate(**kwargs)
  1. See RequestCertificateRequestRequestTypeDef

resend_validation_email

Resends the email that requests domain ownership validation.

Type annotations and code completion for boto3.client("acm").resend_validation_email method. boto3 documentation

Method definition
def resend_validation_email(
    self,
    *,
    CertificateArn: str,
    Domain: str,
    ValidationDomain: str,
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: ResendValidationEmailRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
    "Domain": ...,
    "ValidationDomain": ...,
}

parent.resend_validation_email(**kwargs)
  1. See ResendValidationEmailRequestRequestTypeDef

update_certificate_options

Updates a certificate.

Type annotations and code completion for boto3.client("acm").update_certificate_options method. boto3 documentation

Method definition
def update_certificate_options(
    self,
    *,
    CertificateArn: str,
    Options: CertificateOptionsTypeDef,  # (1)
) -> EmptyResponseMetadataTypeDef:  # (2)
    ...
  1. See CertificateOptionsTypeDef
  2. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: UpdateCertificateOptionsRequestRequestTypeDef = {  # (1)
    "CertificateArn": ...,
    "Options": ...,
}

parent.update_certificate_options(**kwargs)
  1. See UpdateCertificateOptionsRequestRequestTypeDef

get_paginator

Type annotations and code completion for boto3.client("acm").get_paginator method with overloads.

get_waiter

Type annotations and code completion for boto3.client("acm").get_waiter method with overloads.