기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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)을 참조하세요.

## Request Syntax
<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입니다. 최대 길이는 1,600입니다.

 ** [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>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for C\$1\$1](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 V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedgerPermissionsMode)