# AWS Secrets Manager API Reference

> AWS Secrets Manager provides a service to enable you to store, manage, and retrieve, secrets.

- [Welcome](https://docs.aws.amazon.com/secretsmanager/latest/apireference/Welcome.md)
- [Common Parameters](https://docs.aws.amazon.com/secretsmanager/latest/apireference/CommonParameters.md)
- [Common Errors](https://docs.aws.amazon.com/secretsmanager/latest/apireference/CommonErrors.md)

## [Actions](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_Operations.md)

- [BatchGetSecretValue](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_BatchGetSecretValue.md): Retrieves the contents of the encrypted fields SecretString or SecretBinary for up to 20 secrets.
- [CancelRotateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CancelRotateSecret.md): Turns off automatic rotation, and if a rotation is currently in progress, cancels the rotation.
- [CreateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.md): Creates a new secret.
- [DeleteResourcePolicy](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteResourcePolicy.md): Deletes the resource-based permission policy attached to the secret.
- [DeleteSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DeleteSecret.md): Deletes a secret and all of its versions.
- [DescribeSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.md): Retrieves the details of a secret.
- [GetRandomPassword](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetRandomPassword.md): Generates a random password.
- [GetResourcePolicy](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetResourcePolicy.md): Retrieves the JSON text of the resource-based policy document attached to the secret.
- [GetSecretValue](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.md): Retrieves the contents of the encrypted fields SecretString or SecretBinary from the specified version of a secret, whichever contains content.
- [ListSecrets](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ListSecrets.md): Lists the secrets that are stored by Secrets Manager in the AWS account, not including secrets that are marked for deletion.
- [ListSecretVersionIds](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ListSecretVersionIds.md): Lists the versions of a secret.
- [PutResourcePolicy](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutResourcePolicy.md): Attaches a resource-based permission policy to a secret.
- [PutSecretValue](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.md): Creates a new version of your secret by creating a new encrypted value and attaching it to the secret. version can contain a new SecretString value or a new SecretBinary value.
- [RemoveRegionsFromReplication](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_RemoveRegionsFromReplication.md): For a secret that is replicated to other Regions, deletes the secret replicas from the Regions you specify.
- [ReplicateSecretToRegions](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ReplicateSecretToRegions.md): Replicates the secret to a new Regions.
- [RestoreSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_RestoreSecret.md): Cancels the scheduled deletion of a secret by removing the DeletedDate time stamp.
- [RotateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_RotateSecret.md): Configures and starts the asynchronous process of rotating the secret.
- [StopReplicationToReplica](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_StopReplicationToReplica.md): Removes the link between the replica secret and the primary secret and promotes the replica to a primary secret in the replica Region.
- [TagResource](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_TagResource.md): Attaches tags to a secret.
- [UntagResource](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_UntagResource.md): Removes specific tags from a secret.
- [UpdateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_UpdateSecret.md): Modifies the details of a secret, including metadata and the secret value.
- [UpdateSecretVersionStage](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_UpdateSecretVersionStage.md): Modifies the staging labels attached to a version of a secret.
- [ValidateResourcePolicy](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ValidateResourcePolicy.md): Validates that a resource policy does not grant a wide range of principals access to your secret.


## [Data Types](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_Types.md)

- [APIErrorType](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_APIErrorType.md): The error Secrets Manager encountered while retrieving an individual secret as part of .
- [ExternalSecretRotationMetadataItem](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ExternalSecretRotationMetadataItem.md): The metadata needed to successfully rotate a managed external secret.
- [Filter](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_Filter.md): Allows you to add filters when you use the search function in Secrets Manager.
- [ReplicaRegionType](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ReplicaRegionType.md): A custom type that specifies a Region and the KmsKeyId for a replica secret.
- [ReplicationStatusType](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ReplicationStatusType.md): A replication object consisting of a RegionReplicationStatus object and includes a Region, KMSKeyId, status, and status message.
- [RotationRulesType](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_RotationRulesType.md): A structure that defines the rotation configuration for the secret.
- [SecretListEntry](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_SecretListEntry.md): A structure that contains the details about a secret.
- [SecretValueEntry](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_SecretValueEntry.md): A structure that contains the secret value and other details for a secret.
- [SecretVersionsListEntry](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_SecretVersionsListEntry.md): A structure that contains information about one version of a secret.
- [Tag](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_Tag.md): A structure that contains information about a tag.
- [ValidationErrorsEntry](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ValidationErrorsEntry.md): Displays errors that occurred during validation of the resource policy.