Skip to content

SecretsManagerClient

Index > SecretsManager > SecretsManagerClient

Auto-generated documentation for SecretsManager type annotations stubs module types-aiobotocore-secretsmanager.

SecretsManagerClient

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

Usage example
from aioboto3.session import Session
from types_aiobotocore_secretsmanager.client import SecretsManagerClient

session = Session()
async with session.client("secretsmanager") as client:
    client: SecretsManagerClient

Exceptions

aioboto3 client exceptions are generated in runtime. This class provides code completion for session.client("secretsmanager").exceptions structure.

Usage example
async with session.client("secretsmanager") as client:
    try:
        do_something(client)
    except (
            client.ClientError,
        client.DecryptionFailure,
        client.EncryptionFailure,
        client.InternalServiceError,
        client.InvalidNextTokenException,
        client.InvalidParameterException,
        client.InvalidRequestException,
        client.LimitExceededException,
        client.MalformedPolicyDocumentException,
        client.PreconditionNotMetException,
        client.PublicPolicyException,
        client.ResourceExistsException,
        client.ResourceNotFoundException,
    ) as e:
        print(e)
Type checking example
from types_aiobotocore_secretsmanager.client import Exceptions

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

Methods

can_paginate

Check if an operation can be paginated.

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

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

cancel_rotate_secret

Turns off automatic rotation, and if a rotation is currently in progress, cancels the rotation.

Type annotations and code completion for session.client("secretsmanager").cancel_rotate_secret method. boto3 documentation

Method definition
await def cancel_rotate_secret(
    self,
    *,
    SecretId: str,
) -> CancelRotateSecretResponseTypeDef:  # (1)
    ...
  1. See CancelRotateSecretResponseTypeDef
Usage example with kwargs
kwargs: CancelRotateSecretRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.cancel_rotate_secret(**kwargs)
  1. See CancelRotateSecretRequestRequestTypeDef

close

Closes underlying endpoint connections.

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

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

create_secret

Creates a new secret.

Type annotations and code completion for session.client("secretsmanager").create_secret method. boto3 documentation

Method definition
await def create_secret(
    self,
    *,
    Name: str,
    ClientRequestToken: str = ...,
    Description: str = ...,
    KmsKeyId: str = ...,
    SecretBinary: Union[str, bytes, IO[Any], StreamingBody] = ...,
    SecretString: str = ...,
    Tags: Sequence[TagTypeDef] = ...,  # (1)
    AddReplicaRegions: Sequence[ReplicaRegionTypeTypeDef] = ...,  # (2)
    ForceOverwriteReplicaSecret: bool = ...,
) -> CreateSecretResponseTypeDef:  # (3)
    ...
  1. See TagTypeDef
  2. See ReplicaRegionTypeTypeDef
  3. See CreateSecretResponseTypeDef
Usage example with kwargs
kwargs: CreateSecretRequestRequestTypeDef = {  # (1)
    "Name": ...,
}

parent.create_secret(**kwargs)
  1. See CreateSecretRequestRequestTypeDef

delete_resource_policy

Deletes the resource-based permission policy attached to the secret.

Type annotations and code completion for session.client("secretsmanager").delete_resource_policy method. boto3 documentation

Method definition
await def delete_resource_policy(
    self,
    *,
    SecretId: str,
) -> DeleteResourcePolicyResponseTypeDef:  # (1)
    ...
  1. See DeleteResourcePolicyResponseTypeDef
Usage example with kwargs
kwargs: DeleteResourcePolicyRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.delete_resource_policy(**kwargs)
  1. See DeleteResourcePolicyRequestRequestTypeDef

delete_secret

Deletes a secret and all of its versions.

Type annotations and code completion for session.client("secretsmanager").delete_secret method. boto3 documentation

Method definition
await def delete_secret(
    self,
    *,
    SecretId: str,
    RecoveryWindowInDays: int = ...,
    ForceDeleteWithoutRecovery: bool = ...,
) -> DeleteSecretResponseTypeDef:  # (1)
    ...
  1. See DeleteSecretResponseTypeDef
Usage example with kwargs
kwargs: DeleteSecretRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.delete_secret(**kwargs)
  1. See DeleteSecretRequestRequestTypeDef

describe_secret

Retrieves the details of a secret.

Type annotations and code completion for session.client("secretsmanager").describe_secret method. boto3 documentation

Method definition
await def describe_secret(
    self,
    *,
    SecretId: str,
) -> DescribeSecretResponseTypeDef:  # (1)
    ...
  1. See DescribeSecretResponseTypeDef
Usage example with kwargs
kwargs: DescribeSecretRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.describe_secret(**kwargs)
  1. See DescribeSecretRequestRequestTypeDef

generate_presigned_url

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

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

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

get_random_password

Generates a random password.

Type annotations and code completion for session.client("secretsmanager").get_random_password method. boto3 documentation

Method definition
await def get_random_password(
    self,
    *,
    PasswordLength: int = ...,
    ExcludeCharacters: str = ...,
    ExcludeNumbers: bool = ...,
    ExcludePunctuation: bool = ...,
    ExcludeUppercase: bool = ...,
    ExcludeLowercase: bool = ...,
    IncludeSpace: bool = ...,
    RequireEachIncludedType: bool = ...,
) -> GetRandomPasswordResponseTypeDef:  # (1)
    ...
  1. See GetRandomPasswordResponseTypeDef
Usage example with kwargs
kwargs: GetRandomPasswordRequestRequestTypeDef = {  # (1)
    "PasswordLength": ...,
}

parent.get_random_password(**kwargs)
  1. See GetRandomPasswordRequestRequestTypeDef

get_resource_policy

Retrieves the JSON text of the resource-based policy document attached to the secret.

Type annotations and code completion for session.client("secretsmanager").get_resource_policy method. boto3 documentation

Method definition
await def get_resource_policy(
    self,
    *,
    SecretId: str,
) -> GetResourcePolicyResponseTypeDef:  # (1)
    ...
  1. See GetResourcePolicyResponseTypeDef
Usage example with kwargs
kwargs: GetResourcePolicyRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.get_resource_policy(**kwargs)
  1. See GetResourcePolicyRequestRequestTypeDef

get_secret_value

Retrieves the contents of the encrypted fields SecretString or SecretBinary from the specified version of a secret, whichever contains content.

Type annotations and code completion for session.client("secretsmanager").get_secret_value method. boto3 documentation

Method definition
await def get_secret_value(
    self,
    *,
    SecretId: str,
    VersionId: str = ...,
    VersionStage: str = ...,
) -> GetSecretValueResponseTypeDef:  # (1)
    ...
  1. See GetSecretValueResponseTypeDef
Usage example with kwargs
kwargs: GetSecretValueRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.get_secret_value(**kwargs)
  1. See GetSecretValueRequestRequestTypeDef

list_secret_version_ids

Lists the versions of a secret.

Type annotations and code completion for session.client("secretsmanager").list_secret_version_ids method. boto3 documentation

Method definition
await def list_secret_version_ids(
    self,
    *,
    SecretId: str,
    MaxResults: int = ...,
    NextToken: str = ...,
    IncludeDeprecated: bool = ...,
) -> ListSecretVersionIdsResponseTypeDef:  # (1)
    ...
  1. See ListSecretVersionIdsResponseTypeDef
Usage example with kwargs
kwargs: ListSecretVersionIdsRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.list_secret_version_ids(**kwargs)
  1. See ListSecretVersionIdsRequestRequestTypeDef

list_secrets

.

Type annotations and code completion for session.client("secretsmanager").list_secrets method. boto3 documentation

Method definition
await def list_secrets(
    self,
    *,
    MaxResults: int = ...,
    NextToken: str = ...,
    Filters: Sequence[FilterTypeDef] = ...,  # (1)
    SortOrder: SortOrderTypeType = ...,  # (2)
) -> ListSecretsResponseTypeDef:  # (3)
    ...
  1. See FilterTypeDef
  2. See SortOrderTypeType
  3. See ListSecretsResponseTypeDef
Usage example with kwargs
kwargs: ListSecretsRequestRequestTypeDef = {  # (1)
    "MaxResults": ...,
}

parent.list_secrets(**kwargs)
  1. See ListSecretsRequestRequestTypeDef

put_resource_policy

Attaches a resource-based permission policy to a secret.

Type annotations and code completion for session.client("secretsmanager").put_resource_policy method. boto3 documentation

Method definition
await def put_resource_policy(
    self,
    *,
    SecretId: str,
    ResourcePolicy: str,
    BlockPublicPolicy: bool = ...,
) -> PutResourcePolicyResponseTypeDef:  # (1)
    ...
  1. See PutResourcePolicyResponseTypeDef
Usage example with kwargs
kwargs: PutResourcePolicyRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
    "ResourcePolicy": ...,
}

parent.put_resource_policy(**kwargs)
  1. See PutResourcePolicyRequestRequestTypeDef

put_secret_value

Creates a new version with a new encrypted secret value and attaches it to the secret.

Type annotations and code completion for session.client("secretsmanager").put_secret_value method. boto3 documentation

Method definition
await def put_secret_value(
    self,
    *,
    SecretId: str,
    ClientRequestToken: str = ...,
    SecretBinary: Union[str, bytes, IO[Any], StreamingBody] = ...,
    SecretString: str = ...,
    VersionStages: Sequence[str] = ...,
) -> PutSecretValueResponseTypeDef:  # (1)
    ...
  1. See PutSecretValueResponseTypeDef
Usage example with kwargs
kwargs: PutSecretValueRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.put_secret_value(**kwargs)
  1. See PutSecretValueRequestRequestTypeDef

remove_regions_from_replication

For a secret that is replicated to other Regions, deletes the secret replicas from the Regions you specify.

Type annotations and code completion for session.client("secretsmanager").remove_regions_from_replication method. boto3 documentation

Method definition
await def remove_regions_from_replication(
    self,
    *,
    SecretId: str,
    RemoveReplicaRegions: Sequence[str],
) -> RemoveRegionsFromReplicationResponseTypeDef:  # (1)
    ...
  1. See RemoveRegionsFromReplicationResponseTypeDef
Usage example with kwargs
kwargs: RemoveRegionsFromReplicationRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
    "RemoveReplicaRegions": ...,
}

parent.remove_regions_from_replication(**kwargs)
  1. See RemoveRegionsFromReplicationRequestRequestTypeDef

replicate_secret_to_regions

Replicates the secret to a new Regions.

Type annotations and code completion for session.client("secretsmanager").replicate_secret_to_regions method. boto3 documentation

Method definition
await def replicate_secret_to_regions(
    self,
    *,
    SecretId: str,
    AddReplicaRegions: Sequence[ReplicaRegionTypeTypeDef],  # (1)
    ForceOverwriteReplicaSecret: bool = ...,
) -> ReplicateSecretToRegionsResponseTypeDef:  # (2)
    ...
  1. See ReplicaRegionTypeTypeDef
  2. See ReplicateSecretToRegionsResponseTypeDef
Usage example with kwargs
kwargs: ReplicateSecretToRegionsRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
    "AddReplicaRegions": ...,
}

parent.replicate_secret_to_regions(**kwargs)
  1. See ReplicateSecretToRegionsRequestRequestTypeDef

restore_secret

Cancels the scheduled deletion of a secret by removing the DeletedDate time stamp.

Type annotations and code completion for session.client("secretsmanager").restore_secret method. boto3 documentation

Method definition
await def restore_secret(
    self,
    *,
    SecretId: str,
) -> RestoreSecretResponseTypeDef:  # (1)
    ...
  1. See RestoreSecretResponseTypeDef
Usage example with kwargs
kwargs: RestoreSecretRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.restore_secret(**kwargs)
  1. See RestoreSecretRequestRequestTypeDef

rotate_secret

Configures and starts the asynchronous process of rotating the secret.

Type annotations and code completion for session.client("secretsmanager").rotate_secret method. boto3 documentation

Method definition
await def rotate_secret(
    self,
    *,
    SecretId: str,
    ClientRequestToken: str = ...,
    RotationLambdaARN: str = ...,
    RotationRules: RotationRulesTypeTypeDef = ...,  # (1)
    RotateImmediately: bool = ...,
) -> RotateSecretResponseTypeDef:  # (2)
    ...
  1. See RotationRulesTypeTypeDef
  2. See RotateSecretResponseTypeDef
Usage example with kwargs
kwargs: RotateSecretRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.rotate_secret(**kwargs)
  1. See RotateSecretRequestRequestTypeDef

stop_replication_to_replica

Removes the link between the replica secret and the primary secret and promotes the replica to a primary secret in the replica Region.

Type annotations and code completion for session.client("secretsmanager").stop_replication_to_replica method. boto3 documentation

Method definition
await def stop_replication_to_replica(
    self,
    *,
    SecretId: str,
) -> StopReplicationToReplicaResponseTypeDef:  # (1)
    ...
  1. See StopReplicationToReplicaResponseTypeDef
Usage example with kwargs
kwargs: StopReplicationToReplicaRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.stop_replication_to_replica(**kwargs)
  1. See StopReplicationToReplicaRequestRequestTypeDef

tag_resource

Attaches tags to a secret.

Type annotations and code completion for session.client("secretsmanager").tag_resource method. boto3 documentation

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

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

untag_resource

Removes specific tags from a secret.

Type annotations and code completion for session.client("secretsmanager").untag_resource method. boto3 documentation

Method definition
await def untag_resource(
    self,
    *,
    SecretId: str,
    TagKeys: Sequence[str],
) -> EmptyResponseMetadataTypeDef:  # (1)
    ...
  1. See EmptyResponseMetadataTypeDef
Usage example with kwargs
kwargs: UntagResourceRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
    "TagKeys": ...,
}

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

update_secret

Modifies the details of a secret, including metadata and the secret value.

Type annotations and code completion for session.client("secretsmanager").update_secret method. boto3 documentation

Method definition
await def update_secret(
    self,
    *,
    SecretId: str,
    ClientRequestToken: str = ...,
    Description: str = ...,
    KmsKeyId: str = ...,
    SecretBinary: Union[str, bytes, IO[Any], StreamingBody] = ...,
    SecretString: str = ...,
) -> UpdateSecretResponseTypeDef:  # (1)
    ...
  1. See UpdateSecretResponseTypeDef
Usage example with kwargs
kwargs: UpdateSecretRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
}

parent.update_secret(**kwargs)
  1. See UpdateSecretRequestRequestTypeDef

update_secret_version_stage

Modifies the staging labels attached to a version of a secret.

Type annotations and code completion for session.client("secretsmanager").update_secret_version_stage method. boto3 documentation

Method definition
await def update_secret_version_stage(
    self,
    *,
    SecretId: str,
    VersionStage: str,
    RemoveFromVersionId: str = ...,
    MoveToVersionId: str = ...,
) -> UpdateSecretVersionStageResponseTypeDef:  # (1)
    ...
  1. See UpdateSecretVersionStageResponseTypeDef
Usage example with kwargs
kwargs: UpdateSecretVersionStageRequestRequestTypeDef = {  # (1)
    "SecretId": ...,
    "VersionStage": ...,
}

parent.update_secret_version_stage(**kwargs)
  1. See UpdateSecretVersionStageRequestRequestTypeDef

validate_resource_policy

Validates that a resource policy does not grant a wide range of principals access to your secret.

Type annotations and code completion for session.client("secretsmanager").validate_resource_policy method. boto3 documentation

Method definition
await def validate_resource_policy(
    self,
    *,
    ResourcePolicy: str,
    SecretId: str = ...,
) -> ValidateResourcePolicyResponseTypeDef:  # (1)
    ...
  1. See ValidateResourcePolicyResponseTypeDef
Usage example with kwargs
kwargs: ValidateResourcePolicyRequestRequestTypeDef = {  # (1)
    "ResourcePolicy": ...,
}

parent.validate_resource_policy(**kwargs)
  1. See ValidateResourcePolicyRequestRequestTypeDef

__aenter__

Type annotations and code completion for session.client("secretsmanager").__aenter__ method. boto3 documentation

Method definition
await def __aenter__(
    self,
) -> SecretsManagerClient:
    ...

__aexit__

Type annotations and code completion for session.client("secretsmanager").__aexit__ method. boto3 documentation

Method definition
await def __aexit__(
    self,
    exc_type: Any,
    exc_val: Any,
    exc_tb: Any,
) -> Any:
    ...

get_paginator

Type annotations and code completion for session.client("secretsmanager").get_paginator method with overloads.