本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
请求配额
AWS KMS 对每秒请求的 API 操作数量设置了配额。有关列出每个 API 操作的每秒请求配额的表,请参阅 每个 AWS KMS API 操作的请求配额。
当您超过 API 请求配额后,AWS KMS 会限制 请求,即拒绝本应有效请求,并返回类似以下的 ThrottlingException
错误。要响应,请使用退避和重试策略
You have exceeded the rate at which you may call KMS. Reduce the frequency of your calls. (Service: AWSKMS; Status Code: 400; Error Code: ThrottlingException; Request ID:
<ID>
因 API 操作、请求配额 区域及其他因素(如 AWS 类型)而异。CMK
如果您需要超过配额,可以在 Service Quotas 中请求增加配额。使用 Service Quotas 控制台
有关请求增加 AWS KMS 配额的帮助,请参阅请求增加 AWS KMS 配额。
如果超出 请求配额 操作的 ,请考虑使用 GenerateDataKey 的数据密钥缓存功能。AWS 加密 SDK重复使用数据密钥可减少向 AWS KMS 提出请求的频率。
除请求配额之外,AWS KMS 还使用资源配额来确保所有用户的容量。有关详细信息,请参阅 资源配额。
应用 请求配额
在查看请求配额时,请记住以下信息。
-
请求配额 适用于客户托管CMKs和 AWS 托管CMKs。使用 拥有的 AWSCMKs 不会计入 请求配额 账户的 AWS,即使它们用于保护账户中的资源。
-
限制基于区域中所有类型 CMKs 上的所有请求。此总数包括来自 AWS 账户中所有委托人的请求,包括来自代表您的 AWS 服务的请求。
-
每个请求配额都是单独计算的。例如,CreateKey 操作请求对 请求配额CreateAlias 操作的 没有任何影响。如果
CreateAlias
请求受到限制,CreateKey
请求仍可成功完成。 -
虽然加密操作共享一个配额,但共享配额是独立于其他操作的配额计算的。例如,对 Encrypt 和 Decrypt 操作的调用共享一个 请求配额,但该配额独立于管理操作(如 EnableKey)的配额。 例如,在 欧洲(伦敦)区域 中,您可以每秒对对称的 CMKs 加上 5 个
EnableKey
操作执行 10000 个加密操作,而不受限制。
加密操作的共享配额
AWS KMS 加密操作共享请求配额。您可以请求 CMK 支持的加密操作的任意组合,只要加密操作的总数不超过该类型 请求配额 的 CMK。例外情况是 GenerateDataKeyPair 和 GenerateDataKeyPairWithoutPlaintext,它们共享一个单独的配额。
不同类型的 CMKs 的配额是单独计算的。每个配额适用于在每个 1 秒间隔内,在具有给定密钥类型的 AWS 账户和区域中,针对这些操作的所有请求。
-
加密操作(对称)请求速率 是账户和区域中使用对称 CMKs 的加密操作的共享请求配额。
例如,您可能在 区域中使用CMKs对称 AWS,其共享配额为每秒 10000 个请求。当您每秒发出 7000 个 GenerateDataKey 请求和 2000 个 DecryptAWS KMS 请求时, 不会限制您的请求。但是,如果您每秒发出 9500 个
GenerateDataKey
请求和 1000 个加密请求,AWS KMS 会限制您的请求,因为请求数量超出了共享配额。 -
加密操作 (RSA) 请求速率 是使用 RSA 非对称 CMKs 的加密操作的共享请求配额。
例如,如果请求配额为每秒 500 个操作,您可以使用 RSA 发出 200 个 Encrypt 请求和 100 个 DecryptCMKs 请求,可以加密和解密;另外,还有 50 个 Sign 请求和 150 个 Verify 请求,这些请求可以使用 RSA CMKs 进行签名和验证。
-
加密操作 (ECC) 请求速率 是使用椭圆曲线 (ECC) 非对称 CMKs 的加密操作的共享请求配额。
例如,如果请求配额为每秒 300 个操作,您可以使用可以签名和验证的 RSA CMKs 发出 100 个签名请求和 200 个验证请求。
不同密钥类型的配额也是单独计算的。例如,在 亚太区域(新加坡) 中,如果您同时使用对称和非对称 CMKs,则使用对称 CMKs 加上,每秒最多可发出 10000 次调用;另外CMKs加上 使用 RSA 非对称 ,CMKs加上 使用基于 ECC 的 每秒最多可发出 300 个请求。
代表您发出的 API 请求
您可以直接发出 API 请求,也可以使用集成的 AWS 服务代表您向 AWS KMS 发出 API 请求。该配额对两种类型的请求都适用。
例如,您可以使用借助 AWS KMS 的服务器端加密 (SSE-KMS),将数据存储在 Amazon S3 中。每次上传或下载使用 SSE-KMS 进行加密的 S3
对象时,Amazon S3 都会代表您向 AWS KMS 发出 GenerateDataKey
(用于上传)或 Decrypt
(用于下载)请求。这些请求将计入配额,因此,如果使用 SSE-KMS 加密的 S3 对象的上传或下载总数超过每秒 5500(也可能是 10000 或 30000,具体取决于
AWS 区域),AWS KMS 将限制请求。
跨账户请求
当一个 AWS 账户中的应用程序使用其他账户拥有的 CMK 时,它称为跨账户请求。对于跨账户请求,AWS KMS 将限制发出请求的账户,而不是拥有 CMK 的账户。例如,如果账户 A 中的应用程序使用账户 B 中的 CMK,则 CMK 使用仅适用于账户 A 中的配额。
自定义密钥存储配额
AWS KMS 自定义密钥存储仅支持对称 CMKs。在CMKs自定义密钥存储中使用 的加密操作共享一个请求配额,每个自定义密钥存储每秒 1800 次操作。但是,并非所有操作都同等地使用配额。GenerateDataKey
、GenerateDataKeyWithoutPlaintext
和 GenerateRandom
操作使用的每秒配额约为 Encrypt
、Decrypt
和 ReEncrypt
操作使用的每秒配额的 3 倍。
例如,如果您仅请求 Encrypt
和 Decrypt
操作,则每秒可执行约 1800 次操作。相反,如果您请求重复的 GenerateDataKey
操作,则性能可能更接近每秒 600 次操作。对于由大致相同数量的 GenerateDataKey
和 Decrypt
操作组成的应用程序模式,您可以预期每秒大约 1200 次操作。
与其他 AWS KMS 配额不同,自定义密钥存储配额不可调整。您不能使用 Service Quotas 或通过在 AWS Support 中创建案例来增加它。
如果与自定义密钥存储关联的 AWS CloudHSM 正在处理大量命令(包括与自定义密钥存储不相关的命令),则您可能以低于预期速率的速率获得 AWS KMS ThrottlingException
。如果发生此情况,请降低向 AWS KMS 发出请求的速率,减少不相关的负载或对自定义密钥存储使用专用 AWS CloudHSM 集群。
每个 AWS KMS API 操作的请求配额
此表列出了服务配额的配额代码和每个 AWS KMS 请求配额的默认值。
配额名称 | 默认值(每秒) |
---|---|
适用对象:
|
这些共享配额因请求中使用的 AWS 区域和 CMK 类型而异。每个配额都单独计算。
自定义密钥存储配额(对称 CMKs):
|
适用对象:
|
500(共享),对于 RSA CMKs |
适用对象:
|
300(共享),对于椭圆曲线 (ECC) CMKs |
|
5 |
|
5 |
|
5 |
|
5 |
|
50 |
|
5 |
|
5 |
|
5 |
|
5 |
|
5 |
|
1000 |
|
5 |
|
5 |
|
5 |
|
5 |
|
5 |
适用对象:
|
25 |
适用对象:
|
10 |
适用对象:
|
5 |
适用对象:
|
25 |
适用对象:
|
1 |
适用对象:
|
0.5(每 2 秒间隔为 1) |
适用对象:
|
0.1(每 10 秒间隔为 1) |
|
1000 |
|
1000 |
|
0.25(每 4 秒间隔为 1) |
|
5 |
|
5 |
|
500 |
|
100 - |
|
100 - |
|
500 |
|
100 - |
|
100 |
|
5 |
|
15 |
|
15 |
|
5 |
|
5 |
|
5 |
|
5 |
|
5 |
|
5 |