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

# UpdateLedgerPermissionsMode
<a name="API_UpdateLedgerPermissionsMode"></a>

更新分类账的权限模式。

**重要**  
在切换至 `STANDARD` 权限模式前，必须先创建所有必需的 IAM 策略和表标签，以避免对用户造成干扰。要了解更多信息，请参阅 *Amazon QLDB 开发人员指南*中的[迁移到标准权限模式](https://docs.aws.amazon.com/qldb/latest/developerguide/ledger-management.basics.html#ledger-mgmt.basics.update-permissions.migrating)。

## 请求语法
<a name="API_UpdateLedgerPermissionsMode_RequestSyntax"></a>

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

{
   "PermissionsMode": "string"
}
```

## URI 请求参数
<a name="API_UpdateLedgerPermissionsMode_RequestParameters"></a>

请求使用以下 URI 参数。

 ** [name](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-uri-Name"></a>
分类账的名称。  
长度限制：长度下限为 1。最大长度为 32。  
模式：`(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`  
必需：是

## 请求体
<a name="API_UpdateLedgerPermissionsMode_RequestBody"></a>

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

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-PermissionsMode"></a>
为您的分类账分配权限的模式。此参数可能具有下列值之一：  
+  `ALLOW_ALL`：一种旧式权限模式，支持对分类账进行 API 级别粒度的访问控制。

  此模式允许拥有此分类账的 `SendCommand` API 权限的用户在指定分类账中的任何表上运行所有 PartiQL 命令（因此，`ALLOW_ALL`）。此模式忽略您为分类账创建的任何表级或命令级 IAM 权限策略。
+  `STANDARD`：（*推荐*）一种权限模式，可以对分类账、表格和 PartiQL 命令进行更精细粒度的访问控制。

  默认情况下，此模式拒绝所有用户请求在此分类账中的任何表上运行任何 PartiQL 命令。要允许 PartiQL 命令运行，除了分类账的 `SendCommand` API 权限外，您还必须为特定表资源和 PartiQL 操作创建 IAM 权限策略。有关信息，请参阅《Amazon QLDB 开发人员指南》中的[标准权限模式入门](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html)。
我们强烈建议使用 `STANDARD` 权限模式来最大限度地提高分类账数据的安全性。
类型：字符串  
有效值：`ALLOW_ALL | STANDARD`  
必需：是

## 响应语法
<a name="API_UpdateLedgerPermissionsMode_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "Name": "string",
   "PermissionsMode": "string"
}
```

## 响应元素
<a name="API_UpdateLedgerPermissionsMode_ResponseElements"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

 ** [Arn](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Arn"></a>
分类账的 Amazon 资源名称（ARN）。  
类型：字符串  
长度约束：最小长度为 20。长度上限为 1600。

 ** [Name](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Name"></a>
分类账的名称。  
类型：字符串  
长度限制：长度下限为 1。最大长度为 32。  
模式：`(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-PermissionsMode"></a>
分类账的当前权限模式。  
类型：字符串  
有效值：`ALLOW_ALL | STANDARD`

## 错误
<a name="API_UpdateLedgerPermissionsMode_Errors"></a>

有关所有操作返回的常见错误的信息，请参阅[常见错误](CommonErrors.md)。

 ** InvalidParameterException **   
请求中的一项或多项参数无效。  
HTTP 状态代码：400

 ** ResourceNotFoundException **   
指定的资源不存在。  
HTTP 状态代码：404

## 另请参阅
<a name="API_UpdateLedgerPermissionsMode_SeeAlso"></a>

有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+  [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS 适用于 .NET 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedgerPermissionsMode)