请求配额 - AWS Key Management Service
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

请求配额

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 控制台RequestServiceQuotaIncrease 操作。有关详细信息,请参阅 Service Quotas 用户指南 中的请求提高配额。如果适用于 AWS KMS 的 Service Quotas 在该 AWS 区域中不可用,请访问 AWS Support 中心并创建一个案例。

有关请求增加 AWS KMS 配额的帮助,请参阅请求增加 AWS KMS 配额

如果超出 请求配额 操作的 ,请考虑使用 GenerateDataKey 的数据密钥缓存功能。AWS 加密 SDK重复使用数据密钥可减少向 AWS KMS 提出请求的频率。

除请求配额之外,AWS KMS 还使用资源配额来确保所有用户的容量。有关详细信息,请参阅 资源配额

应用 请求配额

在查看请求配额时,请记住以下信息。

  • 请求配额 适用于客户托管CMKsAWS 托管CMKs。使用 拥有的 AWSCMKs 不会计入 请求配额 账户的 AWS,即使它们用于保护账户中的资源。

  • 限制基于区域中所有类型 CMKs 上的所有请求。此总数包括来自 AWS 账户中所有委托人的请求,包括来自代表您的 AWS 服务的请求。

  • 每个请求配额都是单独计算的。例如,CreateKey 操作请求对 请求配额CreateAlias 操作的 没有任何影响。如果 CreateAlias 请求受到限制,CreateKey 请求仍可成功完成。

  • 虽然加密操作共享一个配额,但共享配额是独立于其他操作的配额计算的。例如,对 EncryptDecrypt 操作的调用共享一个 请求配额,但该配额独立于管理操作(如 EnableKey)的配额。 例如,在 欧洲(伦敦)区域 中,您可以每秒对对称的 CMKs 加上 5 个 EnableKey 操作执行 10000 个加密操作,而不受限制。

加密操作的共享配额

AWS KMS 加密操作共享请求配额。您可以请求 CMK 支持的加密操作的任意组合,只要加密操作的总数不超过该类型 请求配额 的 CMK。例外情况是 GenerateDataKeyPairGenerateDataKeyPairWithoutPlaintext,它们共享一个单独的配额。

不同类型的 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 次操作。但是,并非所有操作都同等地使用配额。GenerateDataKeyGenerateDataKeyWithoutPlaintextGenerateRandom 操作使用的每秒配额约为 EncryptDecryptReEncrypt 操作使用的每秒配额的 3 倍。

例如,如果您仅请求 EncryptDecrypt 操作,则每秒可执行约 1800 次操作。相反,如果您请求重复的 GenerateDataKey 操作,则性能可能更接近每秒 600 次操作。对于由大致相同数量的 GenerateDataKeyDecrypt 操作组成的应用程序模式,您可以预期每秒大约 1200 次操作。

与其他 AWS KMS 配额不同,自定义密钥存储配额不可调整。您不能使用 Service Quotas 或通过在 AWS Support 中创建案例来增加它。

注意

如果与自定义密钥存储关联的 AWS CloudHSM 正在处理大量命令(包括与自定义密钥存储不相关的命令),则您可能以低于预期速率的速率获得 AWS KMS ThrottlingException。如果发生此情况,请降低向 AWS KMS 发出请求的速率,减少不相关的负载或对自定义密钥存储使用专用 AWS CloudHSM 集群。

每个 AWS KMS API 操作的请求配额

此表列出了服务配额的配额代码和每个 AWS KMS 请求配额的默认值。

配额名称 默认值(每秒)

Cryptographic operations (symmetric) request rate

适用对象:

  • Decrypt

  • Encrypt

  • GenerateDataKey

  • GenerateDataKeyWithoutPlaintext

  • GenerateRandom

  • ReEncrypt

这些共享配额因请求中使用的 AWS 区域和 CMK 类型而异。每个配额都单独计算。

  • 5500(共享)

  • 在以下区域中为 10000(共享):

    • 美国东部(俄亥俄州),us-east-2

    • 亚太区域(新加坡),ap-southeast-1

    • 亚太区域(悉尼),ap-southeast-2

    • 亚太区域(东京),ap-northeast-1

    • 欧洲(法兰克福),eu-central-1

    • 欧洲(伦敦),eu-west-2

  • 在以下区域中为 50000(共享):

    • 美国东部(弗吉尼亚北部),us-east-1

    • 美国西部(俄勒冈),us-west-2

    • 欧洲(爱尔兰),eu-west-1

自定义密钥存储配额(对称 CMKs):

Cryptographic operations (RSA) request rate

适用对象:

  • Decrypt

  • Encrypt

  • ReEncrypt

  • Sign

  • Verify

500(共享),对于 RSA CMKs

Cryptographic operations (ECC) request rate

适用对象:

  • Sign

  • Verify

300(共享),对于椭圆曲线 (ECC) CMKs

CancelKeyDeletion request rate

5

ConnectCustomKeyStore request rate

5

CreateAlias request rate

5

CreateCustomKeyStore request rate

5

CreateGrant request rate

50

CreateKey request rate

5

DeleteAlias request rate

5

DeleteCustomKeyStore request rate

5

DeleteImportedKeyMaterial request rate

5

DescribeCustomKeyStores request rate

5

DescribeKey request rate

1000

DisableKey request rate

5

DisableKeyRotation request rate

5

DisconnectCustomKeyStore request rate

5

EnableKey request rate

5

EnableKeyRotation request rate

5

GenerateDataKeyPair (ECC_NIST_P256) request rate

适用对象:

  • GenerateDataKeyPair

  • GenerateDataKeyPairWithoutPlaintext

25

GenerateDataKeyPair (ECC_NIST_P384) request rate

适用对象:

  • GenerateDataKeyPair

  • GenerateDataKeyPairWithoutPlaintext

10

GenerateDataKeyPair (ECC_NIST_P521) request rate

适用对象:

  • GenerateDataKeyPair

  • GenerateDataKeyPairWithoutPlaintext

5

GenerateDataKeyPair (ECC_SECG_P256K1) request rate

适用对象:

  • GenerateDataKeyPair

  • GenerateDataKeyPairWithoutPlaintext

25

GenerateDataKeyPair (RSA_2048) request rate

适用对象:

  • GenerateDataKeyPair

  • GenerateDataKeyPairWithoutPlaintext

1

GenerateDataKeyPair (RSA_3072) request rate

适用对象:

  • GenerateDataKeyPair

  • GenerateDataKeyPairWithoutPlaintext

0.5(每 2 秒间隔为 1)

GenerateDataKeyPair (RSA_4096) request rate

适用对象:

  • GenerateDataKeyPair

  • GenerateDataKeyPairWithoutPlaintext

0.1(每 10 秒间隔为 1)

GetKeyPolicy request rate

1000

GetKeyRotationStatus request rate

1000

GetParametersForImport request rate

0.25(每 4 秒间隔为 1)

GetPublicKey request rate

5

ImportKeyMaterial request rate

5

ListAliases request rate

500

ListGrants request rate

100 -

ListKeyPolicies request rate

100 -

ListKeys request rate

500

ListResourceTags request rate

100 -

ListRetirableGrants request rate

100

PutKeyPolicy request rate

5

RetireGrant request rate

15

RevokeGrant request rate

15

ScheduleKeyDeletion request rate

5

TagResource request rate

5

UntagResource request rate

5

UpdateAlias request rate

5

UpdateCustomKeyStore request rate

5

UpdateKeyDescription request rate

5