# AWS Secrets Manager limits and quotas

AWS limits and quotas · Updated 17 November 2026

**Short answer:** A Secrets Manager secret value can be up to 65,536 bytes (64 KB). Reads are generous: 10,000 GetSecretValue and 40,000 DescribeSecret requests per second per Region, but BatchGetSecretValue and ListSecrets are limited to 100 per second, and writes (PutSecretValue, UpdateSecret and similar) share 50 per second. Each secret keeps at most 100 versions, and an account can hold 500,000 secrets per Region. None of these quotas are adjustable.

## Quotas

| Quota | Value | Adjustable |
|---|---|---|
| Secret value size | 65,536 bytes | No |
| Secrets per Region | 500,000 | No |
| Versions per secret | 100 | No |
| Staging labels across all versions of a secret | 20 | No |
| Resource-based policy length | 20,480 characters | No |
| GetSecretValue | 10,000 per second | No |
| DescribeSecret | 40,000 per second | No |
| BatchGetSecretValue | 100 per second | No |
| ListSecrets | 100 per second | No |
| CreateSecret, DeleteSecret, GetRandomPassword, ListSecretVersionIds | 50 per second each | No |
| PutSecretValue, UpdateSecret, UpdateSecretVersionStage and replication calls (combined) | 50 per second | No |
| RotateSecret and CancelRotateSecret (combined) | 50 per second | No |
| Resource policy calls (combined) | 50 per second | No |

Quotas apply per Region. For cross-account access, throttling counts against the account of the caller, not the account that owns the secret.

## The version limit catches frequent writers

Every `PutSecretValue` or `UpdateSecret` that changes the value creates a new version. Secrets Manager removes unlabelled versions once there are more than 100, but never versions less than 24 hours old. So if you write a secret more often than about every 10 minutes, versions pile up faster than they are cleaned and you hit the 100-version quota; AWS recommends not updating a value more than once every 10 minutes on a sustained basis. Secrets Manager is the wrong store for values that change every few seconds (counters, session state); use DynamoDB or Parameter Store for those.

## Throttling and how to avoid it

When you exceed a rate you get `ThrottlingException` (or `Throttling`). The common causes:

- **Fetching the secret on every request** instead of once at start-up. A Lambda function that calls `GetSecretValue` per invocation at 5,000 requests per second uses half the Regional budget by itself, plus a KMS Decrypt each time if the secret uses a customer managed key.
- **Mass scale-out:** thousands of containers starting together, each reading several secrets. ECS injects secrets at task start, so a big deployment can spike the call rate.
- **Polling ListSecrets** from inventory or compliance tools, at 100 per second.

Fixes, in order of effect:

1. Cache secrets in the application with a refresh interval (the AWS-provided caching clients do this), or use the Parameters and Secrets Lambda extension.
2. Fetch several secrets with `BatchGetSecretValue` only where it reduces calls; it has a lower rate limit than single gets.
3. Retry with exponential backoff and jitter; the SDK default retry mode handles occasional throttles.
4. Stagger large deployments with ECS `maximumPercent` and Auto Scaling step sizes.

```
# Size of a secret value in bytes (keep well under 65,536)
aws secretsmanager get-secret-value --secret-id prod/orders/db --query SecretString --output text | wc -c

# Versions currently kept for a secret
aws secretsmanager list-secret-version-ids --secret-id prod/orders/db --include-deprecated \
  --query 'length(Versions)'
```

## Storing things that don't fit in 64 KB

Large certificates bundles, keystores or configuration files belong in S3 with SSE-KMS and a tight bucket policy, with the object key (or a pointer) in Secrets Manager. If you only need encrypted configuration with no rotation, Parameter Store advanced parameters hold up to 8 KB and standard ones 4 KB.

## Questions

### What is the maximum size of a secret in AWS Secrets Manager?

65,536 bytes (64 KB) for the secret value. The quota can't be increased.

### What is the GetSecretValue rate limit?

10,000 requests per second per account per Region. BatchGetSecretValue is limited to 100 per second.

### Why does Secrets Manager say I've reached the maximum number of versions?

A secret can keep 100 versions, and versions younger than 24 hours are never cleaned up, so writing the value more often than about every 10 minutes fills the quota.

## When this happens away from your desk

Secret-fetch throttling during a big scale-out can stop new tasks from starting. CloudConsole, a phone app for AWS, is being built to show the failing service's alarms and logs on your phone so you can see the cause.

[About the CloudConsole app](https://cloudconsole.dev/aws-console-app) · [Download on the App Store](https://apps.apple.com/app/cloudconsole-for-aws/id6835419710)

## Sources

- [AWS Secrets Manager quotas](https://docs.aws.amazon.com/secretsmanager/latest/userguide/reference_limits.html)

## Related

- [ResourceNotFoundException: Secrets Manager can't find the specified secret](https://cloudconsole.dev/errors/secretsmanager-cant-find-secret)
- [aws secretsmanager get-secret-value](https://cloudconsole.dev/cli/secretsmanager-get-secret-value)
- [aws secretsmanager put-secret-value](https://cloudconsole.dev/cli/secretsmanager-put-secret-value)
- [aws secretsmanager create-secret](https://cloudconsole.dev/cli/secretsmanager-create-secret)
- [AWS KMS request quotas (throttling)](https://cloudconsole.dev/limits/kms-request-quotas)
- [aws ssm get-parameter](https://cloudconsole.dev/cli/ssm-get-parameter)

---

Source: https://cloudconsole.dev/limits/secrets-manager-limits

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
