types-boto3-secretsmanager 1.36.0__py3-none-any.whl

types_boto3_secretsmanager/__init__.py

@@ -0,0 +1,29 @@
+"""
+Main interface for secretsmanager service.
+
+Usage::
+
+    ```python
+    from boto3.session import Session
+    from types_boto3_secretsmanager import (
+        Client,
+        ListSecretsPaginator,
+        SecretsManagerClient,
+    )
+
+    session = Session()
+    client: SecretsManagerClient = session.client("secretsmanager")
+
+    list_secrets_paginator: ListSecretsPaginator = client.get_paginator("list_secrets")
+    ```
+
+Copyright 2025 Vlad Emelianov
+"""
+
+from .client import SecretsManagerClient
+from .paginator import ListSecretsPaginator
+
+Client = SecretsManagerClient
+
+
+__all__ = ("Client", "ListSecretsPaginator", "SecretsManagerClient")

types_boto3_secretsmanager/__init__.pyi

@@ -0,0 +1,28 @@
+"""
+Main interface for secretsmanager service.
+
+Usage::
+
+    ```python
+    from boto3.session import Session
+    from types_boto3_secretsmanager import (
+        Client,
+        ListSecretsPaginator,
+        SecretsManagerClient,
+    )
+
+    session = Session()
+    client: SecretsManagerClient = session.client("secretsmanager")
+
+    list_secrets_paginator: ListSecretsPaginator = client.get_paginator("list_secrets")
+    ```
+
+Copyright 2025 Vlad Emelianov
+"""
+
+from .client import SecretsManagerClient
+from .paginator import ListSecretsPaginator
+
+Client = SecretsManagerClient
+
+__all__ = ("Client", "ListSecretsPaginator", "SecretsManagerClient")

types_boto3_secretsmanager/__main__.py

@@ -0,0 +1,43 @@
+"""
+Main CLI entrypoint.
+
+Copyright 2025 Vlad Emelianov
+"""
+
+import sys
+
+
+def print_info() -> None:
+    """
+    Print package info to stdout.
+    """
+    sys.stdout.write(
+        "Type annotations for boto3 SecretsManager 1.36.0\n"
+        "Version:         1.36.0\n"
+        "Builder version: 8.8.0\n"
+        "Docs:            https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager//\n"
+        "Boto3 docs:      https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager.html#secretsmanager\n"
+        "Other services:  https://pypi.org/project/boto3-stubs/\n"
+        "Changelog:       https://github.com/youtype/mypy_boto3_builder/releases\n"
+    )
+
+
+def print_version() -> None:
+    """
+    Print package version to stdout.
+    """
+    sys.stdout.write("1.36.0\n")
+
+
+def main() -> None:
+    """
+    Main CLI entrypoint.
+    """
+    if "--version" in sys.argv:
+        print_version()
+        return
+    print_info()
+
+
+if __name__ == "__main__":
+    main()

types_boto3_secretsmanager/client.py

@@ -0,0 +1,391 @@
+"""
+Type annotations for secretsmanager service Client.
+
+[Documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/)
+
+Usage::
+
+    ```python
+    from boto3.session import Session
+    from types_boto3_secretsmanager.client import SecretsManagerClient
+
+    session = Session()
+    client: SecretsManagerClient = session.client("secretsmanager")
+    ```
+
+Copyright 2025 Vlad Emelianov
+"""
+
+from __future__ import annotations
+
+import sys
+from typing import Any
+
+from botocore.client import BaseClient, ClientMeta
+from botocore.errorfactory import BaseClientExceptions
+from botocore.exceptions import ClientError as BotocoreClientError
+
+from .paginator import ListSecretsPaginator
+from .type_defs import (
+    BatchGetSecretValueRequestRequestTypeDef,
+    BatchGetSecretValueResponseTypeDef,
+    CancelRotateSecretRequestRequestTypeDef,
+    CancelRotateSecretResponseTypeDef,
+    CreateSecretRequestRequestTypeDef,
+    CreateSecretResponseTypeDef,
+    DeleteResourcePolicyRequestRequestTypeDef,
+    DeleteResourcePolicyResponseTypeDef,
+    DeleteSecretRequestRequestTypeDef,
+    DeleteSecretResponseTypeDef,
+    DescribeSecretRequestRequestTypeDef,
+    DescribeSecretResponseTypeDef,
+    EmptyResponseMetadataTypeDef,
+    GetRandomPasswordRequestRequestTypeDef,
+    GetRandomPasswordResponseTypeDef,
+    GetResourcePolicyRequestRequestTypeDef,
+    GetResourcePolicyResponseTypeDef,
+    GetSecretValueRequestRequestTypeDef,
+    GetSecretValueResponseTypeDef,
+    ListSecretsRequestRequestTypeDef,
+    ListSecretsResponseTypeDef,
+    ListSecretVersionIdsRequestRequestTypeDef,
+    ListSecretVersionIdsResponseTypeDef,
+    PutResourcePolicyRequestRequestTypeDef,
+    PutResourcePolicyResponseTypeDef,
+    PutSecretValueRequestRequestTypeDef,
+    PutSecretValueResponseTypeDef,
+    RemoveRegionsFromReplicationRequestRequestTypeDef,
+    RemoveRegionsFromReplicationResponseTypeDef,
+    ReplicateSecretToRegionsRequestRequestTypeDef,
+    ReplicateSecretToRegionsResponseTypeDef,
+    RestoreSecretRequestRequestTypeDef,
+    RestoreSecretResponseTypeDef,
+    RotateSecretRequestRequestTypeDef,
+    RotateSecretResponseTypeDef,
+    StopReplicationToReplicaRequestRequestTypeDef,
+    StopReplicationToReplicaResponseTypeDef,
+    TagResourceRequestRequestTypeDef,
+    UntagResourceRequestRequestTypeDef,
+    UpdateSecretRequestRequestTypeDef,
+    UpdateSecretResponseTypeDef,
+    UpdateSecretVersionStageRequestRequestTypeDef,
+    UpdateSecretVersionStageResponseTypeDef,
+    ValidateResourcePolicyRequestRequestTypeDef,
+    ValidateResourcePolicyResponseTypeDef,
+)
+
+if sys.version_info >= (3, 9):
+    from builtins import type as Type
+    from collections.abc import Mapping
+else:
+    from typing import Mapping, Type
+if sys.version_info >= (3, 12):
+    from typing import Literal, Unpack
+else:
+    from typing_extensions import Literal, Unpack
+
+
+__all__ = ("SecretsManagerClient",)
+
+
+class Exceptions(BaseClientExceptions):
+    ClientError: Type[BotocoreClientError]
+    DecryptionFailure: Type[BotocoreClientError]
+    EncryptionFailure: Type[BotocoreClientError]
+    InternalServiceError: Type[BotocoreClientError]
+    InvalidNextTokenException: Type[BotocoreClientError]
+    InvalidParameterException: Type[BotocoreClientError]
+    InvalidRequestException: Type[BotocoreClientError]
+    LimitExceededException: Type[BotocoreClientError]
+    MalformedPolicyDocumentException: Type[BotocoreClientError]
+    PreconditionNotMetException: Type[BotocoreClientError]
+    PublicPolicyException: Type[BotocoreClientError]
+    ResourceExistsException: Type[BotocoreClientError]
+    ResourceNotFoundException: Type[BotocoreClientError]
+
+
+class SecretsManagerClient(BaseClient):
+    """
+    [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager.html#SecretsManager.Client)
+    [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/)
+    """
+
+    meta: ClientMeta
+
+    @property
+    def exceptions(self) -> Exceptions:
+        """
+        SecretsManagerClient exceptions.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager.html#SecretsManager.Client)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#exceptions)
+        """
+
+    def can_paginate(self, operation_name: str) -> bool:
+        """
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/can_paginate.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#can_paginate)
+        """
+
+    def generate_presigned_url(
+        self,
+        ClientMethod: str,
+        Params: Mapping[str, Any] = ...,
+        ExpiresIn: int = 3600,
+        HttpMethod: str = ...,
+    ) -> str:
+        """
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/generate_presigned_url.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#generate_presigned_url)
+        """
+
+    def batch_get_secret_value(
+        self, **kwargs: Unpack[BatchGetSecretValueRequestRequestTypeDef]
+    ) -> BatchGetSecretValueResponseTypeDef:
+        """
+        Retrieves the contents of the encrypted fields <code>SecretString</code> or
+        <code>SecretBinary</code> for up to 20 secrets.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/batch_get_secret_value.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#batch_get_secret_value)
+        """
+
+    def cancel_rotate_secret(
+        self, **kwargs: Unpack[CancelRotateSecretRequestRequestTypeDef]
+    ) -> CancelRotateSecretResponseTypeDef:
+        """
+        Turns off automatic rotation, and if a rotation is currently in progress,
+        cancels the rotation.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/cancel_rotate_secret.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#cancel_rotate_secret)
+        """
+
+    def create_secret(
+        self, **kwargs: Unpack[CreateSecretRequestRequestTypeDef]
+    ) -> CreateSecretResponseTypeDef:
+        """
+        Creates a new secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/create_secret.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#create_secret)
+        """
+
+    def delete_resource_policy(
+        self, **kwargs: Unpack[DeleteResourcePolicyRequestRequestTypeDef]
+    ) -> DeleteResourcePolicyResponseTypeDef:
+        """
+        Deletes the resource-based permission policy attached to the secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/delete_resource_policy.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#delete_resource_policy)
+        """
+
+    def delete_secret(
+        self, **kwargs: Unpack[DeleteSecretRequestRequestTypeDef]
+    ) -> DeleteSecretResponseTypeDef:
+        """
+        Deletes a secret and all of its versions.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/delete_secret.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#delete_secret)
+        """
+
+    def describe_secret(
+        self, **kwargs: Unpack[DescribeSecretRequestRequestTypeDef]
+    ) -> DescribeSecretResponseTypeDef:
+        """
+        Retrieves the details of a secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/describe_secret.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#describe_secret)
+        """
+
+    def get_random_password(
+        self, **kwargs: Unpack[GetRandomPasswordRequestRequestTypeDef]
+    ) -> GetRandomPasswordResponseTypeDef:
+        """
+        Generates a random password.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/get_random_password.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#get_random_password)
+        """
+
+    def get_resource_policy(
+        self, **kwargs: Unpack[GetResourcePolicyRequestRequestTypeDef]
+    ) -> GetResourcePolicyResponseTypeDef:
+        """
+        Retrieves the JSON text of the resource-based policy document attached to the
+        secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/get_resource_policy.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#get_resource_policy)
+        """
+
+    def get_secret_value(
+        self, **kwargs: Unpack[GetSecretValueRequestRequestTypeDef]
+    ) -> GetSecretValueResponseTypeDef:
+        """
+        Retrieves the contents of the encrypted fields <code>SecretString</code> or
+        <code>SecretBinary</code> from the specified version of a secret, whichever
+        contains content.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/get_secret_value.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#get_secret_value)
+        """
+
+    def list_secret_version_ids(
+        self, **kwargs: Unpack[ListSecretVersionIdsRequestRequestTypeDef]
+    ) -> ListSecretVersionIdsResponseTypeDef:
+        """
+        Lists the versions of a secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/list_secret_version_ids.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#list_secret_version_ids)
+        """
+
+    def list_secrets(
+        self, **kwargs: Unpack[ListSecretsRequestRequestTypeDef]
+    ) -> ListSecretsResponseTypeDef:
+        """
+        Lists the secrets that are stored by Secrets Manager in the Amazon Web Services
+        account, not including secrets that are marked for deletion.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/list_secrets.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#list_secrets)
+        """
+
+    def put_resource_policy(
+        self, **kwargs: Unpack[PutResourcePolicyRequestRequestTypeDef]
+    ) -> PutResourcePolicyResponseTypeDef:
+        """
+        Attaches a resource-based permission policy to a secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/put_resource_policy.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#put_resource_policy)
+        """
+
+    def put_secret_value(
+        self, **kwargs: Unpack[PutSecretValueRequestRequestTypeDef]
+    ) -> PutSecretValueResponseTypeDef:
+        """
+        Creates a new version with a new encrypted secret value and attaches it to the
+        secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/put_secret_value.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#put_secret_value)
+        """
+
+    def remove_regions_from_replication(
+        self, **kwargs: Unpack[RemoveRegionsFromReplicationRequestRequestTypeDef]
+    ) -> RemoveRegionsFromReplicationResponseTypeDef:
+        """
+        For a secret that is replicated to other Regions, deletes the secret replicas
+        from the Regions you specify.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/remove_regions_from_replication.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#remove_regions_from_replication)
+        """
+
+    def replicate_secret_to_regions(
+        self, **kwargs: Unpack[ReplicateSecretToRegionsRequestRequestTypeDef]
+    ) -> ReplicateSecretToRegionsResponseTypeDef:
+        """
+        Replicates the secret to a new Regions.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/replicate_secret_to_regions.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#replicate_secret_to_regions)
+        """
+
+    def restore_secret(
+        self, **kwargs: Unpack[RestoreSecretRequestRequestTypeDef]
+    ) -> RestoreSecretResponseTypeDef:
+        """
+        Cancels the scheduled deletion of a secret by removing the
+        <code>DeletedDate</code> time stamp.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/restore_secret.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#restore_secret)
+        """
+
+    def rotate_secret(
+        self, **kwargs: Unpack[RotateSecretRequestRequestTypeDef]
+    ) -> RotateSecretResponseTypeDef:
+        """
+        Configures and starts the asynchronous process of rotating the secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/rotate_secret.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#rotate_secret)
+        """
+
+    def stop_replication_to_replica(
+        self, **kwargs: Unpack[StopReplicationToReplicaRequestRequestTypeDef]
+    ) -> StopReplicationToReplicaResponseTypeDef:
+        """
+        Removes the link between the replica secret and the primary secret and promotes
+        the replica to a primary secret in the replica Region.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/stop_replication_to_replica.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#stop_replication_to_replica)
+        """
+
+    def tag_resource(
+        self, **kwargs: Unpack[TagResourceRequestRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Attaches tags to a secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/tag_resource.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#tag_resource)
+        """
+
+    def untag_resource(
+        self, **kwargs: Unpack[UntagResourceRequestRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Removes specific tags from a secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/untag_resource.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#untag_resource)
+        """
+
+    def update_secret(
+        self, **kwargs: Unpack[UpdateSecretRequestRequestTypeDef]
+    ) -> UpdateSecretResponseTypeDef:
+        """
+        Modifies the details of a secret, including metadata and the secret value.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/update_secret.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#update_secret)
+        """
+
+    def update_secret_version_stage(
+        self, **kwargs: Unpack[UpdateSecretVersionStageRequestRequestTypeDef]
+    ) -> UpdateSecretVersionStageResponseTypeDef:
+        """
+        Modifies the staging labels attached to a version of a secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/update_secret_version_stage.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#update_secret_version_stage)
+        """
+
+    def validate_resource_policy(
+        self, **kwargs: Unpack[ValidateResourcePolicyRequestRequestTypeDef]
+    ) -> ValidateResourcePolicyResponseTypeDef:
+        """
+        Validates that a resource policy does not grant a wide range of principals
+        access to your secret.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/validate_resource_policy.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#validate_resource_policy)
+        """
+
+    def get_paginator(  # type: ignore[override]
+        self, operation_name: Literal["list_secrets"]
+    ) -> ListSecretsPaginator:
+        """
+        Create a paginator for an operation.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/secretsmanager/client/get_paginator.html)
+        [Show types-boto3 documentation](https://youtype.github.io/types_boto3_docs/types_boto3_secretsmanager/client/#get_paginator)
+        """