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

# UpdateLedger
<a name="API_UpdateLedger"></a>

원장의 속성을 업데이트합니다.

## Request Syntax
<a name="API_UpdateLedger_RequestSyntax"></a>

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

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

## URI 요청 파라미터
<a name="API_UpdateLedger_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [name](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-uri-Name"></a>
원장의 명칭입니다.  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
필수 여부: 예

## 요청 본문
<a name="API_UpdateLedger_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DeletionProtection](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-DeletionProtection"></a>
사용자에 의해 삭제되지 않도록 원장을 보호할지 여부를 지정합니다. 원장 생성 중 정의하지 않을 경우 이 기능이 기본적으로 활성화됩니다(`true`).  
삭제 방지가 활성화된 경우 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다. `UpdateLedger` 작업을 호출하여 이 파라미터를 `false`로 설정하면 비활성화할 수 있습니다.  
유형: 부울  
필수 항목 여부: 아니요

 ** [KmsKey](#API_UpdateLedger_RequestSyntax) **   <a name="qldb-UpdateLedger-request-KmsKey"></a>
원장의 저장 데이터 암호화에 사용할 in AWS Key Management Service (AWS KMS) 키입니다. 자세한 내용을 알아보려면 *Amazon QLDB 개발자 안내서*의 [저장된 암호화](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html)를 참조하세요.  
다음 옵션 중 하나를 사용하여 이 파라미터를 지정합니다.  
+  `AWS_OWNED_KMS_KEY`: 사용자를 대신하여에서 소유하고 관리하는 AWS KMS AWS 키를 사용합니다.
+  **정의되지 않음**: 원장의 KMS 키를 변경하지 않습니다.
+  **유효한 대칭 고객 관리형 KMS 키**: 사용자가 생성, 소유 및 관리하는 계정의 지정된 대칭 암호화 KMS 키를 사용합니다.

  Amazon QLDB에서는 비대칭 키가 지원되지 않습니다. 자세한 내용은 * AWS Key Management Service 개발자 안내서*의 [대칭 및 비대칭 키 사용을](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) 참조하세요.
고객 관리형 KMS 키를 지정하려면 해당 키 ID, Amazon 리소스 이름(ARN), 별칭 이름 또는 별칭 ARN을 사용할 수 있습니다. 별칭 이름을 사용할 때 `"alias/"`를 접두사를 사용합니다. 다른에서 키를 지정하려면 키 ARN 또는 별칭 ARN을 사용해야 AWS 계정합니다.  
예시:  
+ 키 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)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id)를 참조하세요.  
유형: 문자열  
길이 제약 조건: 최대 길이는 1,600입니다.  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_UpdateLedger_ResponseSyntax"></a>

```
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"
}
```

## 응답 요소
<a name="API_UpdateLedger_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Arn](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-Arn"></a>
원장의 Amazon 리소스 이름(ARN)입니다.  
타입: 문자열  
길이 제약 조건: 최소 길이는 20입니다. 최대 길이는 1,600입니다.

 ** [CreationDateTime](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-CreationDateTime"></a>
원장이 생성된 날짜와 시간(epoch 시간 형식)입니다. (epoch 시간 형식은 UTC 기준으로 1970년 1월 1일 자정 12:00:00부터 경과된 초 단위의 시간입니다.)  
유형: 타임스탬프

 ** [DeletionProtection](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-DeletionProtection"></a>
사용자에 의해 삭제되지 않도록 원장을 보호할지 여부를 지정합니다. 원장 생성 중 정의하지 않을 경우 이 기능이 기본적으로 활성화됩니다(`true`).  
삭제 방지가 활성화된 경우 원장을 삭제하려면 먼저 이 기능을 비활성화해야 합니다. `UpdateLedger` 작업을 호출하여 이 파라미터를 `false`로 설정하면 비활성화할 수 있습니다.  
유형: 부울

 ** [EncryptionDescription](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-EncryptionDescription"></a>
원장의 저장 데이터 암호화에 대한 정보. 여기에는 현재 상태, AWS KMS 키, 키에 액세스할 수 없게 된 시간(오류 발생 시)이 포함됩니다.  
유형: [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md)객체

 ** [Name](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-Name"></a>
원장의 명칭입니다.  
타입: 문자열  
길이 제약: 최소 길이 1. 최대 길이 32.  
패턴: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [State](#API_UpdateLedger_ResponseSyntax) **   <a name="qldb-UpdateLedger-response-State"></a>
원장의 현재 상태입니다.  
타입: 문자열  
유효 값: `CREATING | ACTIVE | DELETING | DELETED` 

## 오류
<a name="API_UpdateLedger_Errors"></a>

모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 [일반적인 오류](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterException **   
요청에서 하나 이상의 파라미터가 유효하지 않습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
지정된 리소스가 존재하지 않습니다.  
HTTP 상태 코드: 404

## 참고
<a name="API_UpdateLedger_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedger) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedger) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedger) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedger) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedger) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedger)