Resource quotas - Amazon Key Management Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Resource quotas

Amazon KMS establishes resource quotas to ensure that it can provide fast and resilient service to all of our customers. Some resource quotas apply only to resources that you create, but not to resources that Amazon services create for you. Resources that you use, but that aren't in your Amazon Web Services account, such as Amazon owned keys, do not count against these quotas.

If you have exceeded a resource limit, requests to create an additional resource of that type generate an LimitExceededException error message.

All Amazon KMS resource quotas are fully adjustable, except for the key policy document size quota and the custom key store resource quota. To request a quota increase, see Requesting a quota increase in the Service Quotas User Guide. To request a quota decrease, to change a quota that is not listed in Service Quotas, or to change a quota in an Amazon Web Services Region where Service Quotas for Amazon KMS is not available, please visit Amazon Web Services Support Center and create a case.

The following table lists and describes the Amazon KMS resource quotas in each Amazon Web Services account and Region.

Quota name Default value Applies to Adjustable
Amazon KMS keys 100,000 Customer managed keys Yes
Aliases per KMS key 50 Customer created aliases Yes
Grants per KMS key 50,000 Customer managed keys Yes
Key policy document size 32 KB (32,768 bytes)

Customer managed keys

Amazon managed keys

No
Custom key store resource quota 10 Amazon Web Services account and Region No

In addition to resource quotas, Amazon KMS uses request quotas to ensure the responsiveness of the service. For details, see Request quotas.

Amazon KMS keys: 100,000

You can have up to 100,000 customer managed keys in each Region of your Amazon Web Services account. This quota applies to all customer managed keys in all Amazon Web Services Regions regardless of their key spec or key state. Each KMS key is considered to be one resource. Amazon managed keys and Amazon owned keys do not count against this quota.

Aliases per KMS key: 50

You can associate up to 50 aliases with each customer managed key. Aliases that Amazon associates with Amazon managed keys do not count against this quota. You might encounter this quota when you create or update an alias.

Note

The kms:ResourceAliases condition is effective only when the KMS key conforms to this quota. If a KMS key exceeds this quota, principals who are authorized to use the KMS key by the kms:ResourceAliases condition are denied access to the KMS key. For details, see Access denied due to alias quota.

The Aliases per KMS key quota replaces the Aliases per Region quota that limited the total number of aliases in each Region of an Amazon Web Services account. Amazon KMS has eliminated the Aliases per Region quota.

Grants per KMS key: 50,000

Each customer managed key can have up to 50,000 grants, including the grants created by Amazon services that are integrated with Amazon KMS. This quota does not apply to Amazon managed keys or Amazon owned keys.

One effect of this quota is that you cannot perform more than 50,000 grant-authorized operations that use the same KMS key at the same time. After you reach the quota, you can create new grants on the KMS key only when an active grant is retired or revoked.

For example, when you attach an Amazon Elastic Block Store (Amazon EBS) volume to an Amazon Elastic Compute Cloud (Amazon EC2) instance, the volume is decrypted so you can read it. To get permission to decrypt the data, Amazon EBS creates a grant for each volume. Therefore, if all of your Amazon EBS volumes use the same KMS key, you cannot attach more than 50,000 volumes at one time.

Key policy document size: 32 KB

The maximum length of each key policy document is 32 KB (32,768 bytes). If you use a larger policy document to create or update the key policy for a KMS key, the operation fails.

This quota is not adjustable. You cannot increase it by using Service Quotas or by creating a case in Amazon Web Services Support. If your key policy is approaching the limit, consider using grants instead of policy statements. Grants are particularly well suited to temporary or very specific permissions.

You use a key policy document whenever you create or change a key policy by using the default view or policy view in the Amazon Web Services Management Console, or the PutKeyPolicy operation. This quota applies to your key policy document, even if you use the default view in the Amazon KMS console, where you don't edit the JSON statements directly.

Custom key stores resource quota: 10

You can create up to 10 custom key stores in each Amazon Web Services account and Region. If you try to create more, the CreateCustomKeyStore operation fails.

This quota applies to the total number of custom key stores in each account and region, including all Amazon CloudHSM key stores and external key stores, regardless of their connection state.

This quota is not adjustable. You cannot increase it by using Service Quotas or by creating a case in Amazon Web Services Support. If you are not using all of your custom key stores, consider deleting an unused, long-disconnected custom key store. Before you do, verify that you do not need any of the KMS keys in the custom key store to decrypt ciphertext.