UpdateLedger

更新分类账上的属性。

请求语法


PATCH /ledgers/name HTTP/1.1
Content-type: application/json

{
   "DeletionProtection": boolean,
   "KmsKey": "string"
}

URI 请求参数

请求使用以下 URI 参数。

name

分类账的名称。

长度限制：长度下限为 1。最大长度为 32。

模式：(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$

必需：是

请求体

请求接受采用 JSON 格式的以下数据。

DeletionProtection

指定是否保护分类账不被任何用户删除。如果创建分类账期间未定义，则默认情况下启用该功能（true）。

如果启用了删除保护，您必须先禁用它，然后才能删除分类账。您可以通过调用 UpdateLedger 操作将此参数设置为 false 来禁用该功能。

类型：布尔值

必需：否

KmsKey

AWS Key Management Service (AWS KMS) 中的密钥，用于加密账本中的静态数据。有关更多信息，请参阅《Amazon QLDB 开发人员指南》中的静态加密。

使用以下选项之一指定此参数：

AWS_OWNED_KMS_KEY：使用由您代表自己拥有和管理 AWS 的 AWS KMS 密钥。
未定义：不对分类账的 KMS 密钥进行任何更改。
A valid symmetric customer managed KMS key（有效的对称客户托管 KMS 密钥）：在您创建、拥有和管理的账户中使用指定的对称加密 KMS 密钥。

Amazon QLDB 不支持非对称密钥。有关更多信息，请参阅《 AWS Key Management Service 开发人员指南》中的使用对称和非对称密钥。

要指定客户托管的 KMS 密钥，您可以使用其密钥 ID、Amazon 资源名称（ARN）、别名或别名 ARN。使用别名时，应加上 "alias/" 前缀。要在不同的密钥中指定密钥 AWS 账户，必须使用密钥 ARN 或别名 ARN。

例如：

密钥 ID：1234abcd-12ab-34cd-56ef-1234567890ab
密钥 ARN：arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
别名：alias/ExampleAlias
别名 ARN：arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias

有关更多信息，请参阅《 AWS Key Management Service 开发者指南》中的密钥标识符 (KeyId)。

类型：字符串

长度限制：最大长度为 1600。

必需：否

响应语法


HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "CreationDateTime": number,
   "DeletionProtection": boolean,
   "EncryptionDescription": { 
      "EncryptionStatus": "string",
      "InaccessibleKmsKeyDateTime": number,
      "KmsKeyArn": "string"
   },
   "Name": "string",
   "State": "string"
}