기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# KMS 키 \$1 업데이트(검토 필요)
KMS 키 업데이트를 요청합니다.
**전체 분류:** 관리 \$1 고급 스택 구성 요소 \$1 KMS 키 \$1 업데이트(검토 필요)
## 변경 유형 세부 정보
****
| | |
| --- |--- |
| 유형 ID 변경 | ct-3ovo7px2vsa6n |
| 현재 버전 | 3.0 |
| 예상 실행 기간 | 240분 |
| AWS 승인 | 필수 |
| 고객 승인 | 제출자인 경우 필요하지 않음 |
| 실행 모드 | 수동 |
## 추가 정보
### KMS 키 업데이트(검토 필요)
#### 콘솔을 사용하여 AWS KMS 키 업데이트(검토 필요)
AMS 콘솔에서이 변경 유형의 스크린샷:
![\[Update KMS Key interface showing ID, execution mode, version, and classification details.\]](http://docs.aws.amazon.com/ko_kr/managedservices/latest/ctref/images/guiKmsKeyUpdateRrCT.png)
작동 방식:
1. **RFC 생성** 페이지로 이동합니다. AMS 콘솔의 왼쪽 탐색 창에서 **RFCs** 클릭하여 RFCs 목록 페이지를 연 다음 **RFC 생성을** 클릭합니다.
1. 기본 변경 유형 **찾아보기 보기에서 인기 있는 변경 유형**(CT)을 선택하거나 **범주별 선택** 보기에서 CT를 선택합니다.
+ **변경 유형별 찾아보**기: **빠른 생성** 영역에서 인기 있는 CT를 클릭하여 **RFC 실행** 페이지를 즉시 열 수 있습니다. 빠른 생성으로 이전 CT 버전을 선택할 수 없습니다.
CTs 정렬하려면 **카드** 또는 **테이블** 보기에서 **모든 변경 유형** 영역을 사용합니다. 어느 보기에서든 CT를 선택한 다음 **RFC 생성을** 클릭하여 **RFC 실행** 페이지를 엽니다. 해당하는 경우 RFC **생성 버튼 옆에 이전 버전으로** 생성 옵션이 나타납니다. ****
+ **범주별 선택**: 범주, 하위 범주, 항목 및 작업을 선택하면 해당하는 경우 **이전 버전으로 생성** 옵션이 있는 CT 세부 정보 상자가 열립니다. **RFC 생성을** 클릭하여 **RFC 실행** 페이지를 엽니다.
1. **RFC 실행** 페이지에서 CT 이름 영역을 열어 CT 세부 정보 상자를 확인합니다. **제목**은 필수입니다(**변경 유형 찾아보**기 보기에서 CT를 선택하면 입력됨). **추가 구성** 영역을 열어 RFC에 대한 정보를 추가합니다.
**실행 구성** 영역에서 사용 가능한 드롭다운 목록을 사용하거나 필요한 파라미터의 값을 입력합니다. 선택적 실행 파라미터를 구성하려면 **추가 구성** 영역을 엽니다.
1. 완료되면 **실행**을 클릭합니다. 오류가 없는 경우 **성공적으로 생성된 RFC** 페이지에 제출된 RFC 세부 정보와 초기 **실행 출력**이 표시됩니다.
1. **실행 파라미터** 영역을 열어 제출한 구성을 확인합니다. 페이지를 새로 고쳐 RFC 실행 상태를 업데이트합니다. 선택적으로 RFC를 취소하거나 페이지 상단의 옵션을 사용하여 RFC 사본을 생성합니다.
#### CLI를 사용하여 AWS KMS 키 업데이트(검토 필요)
작동 방식:
1. 인라인 생성(모든 RFC 및 실행 파라미터가 포함된 `create-rfc` 명령을 실행) 또는 템플릿 생성(2개의 JSON 파일을 생성, 하나는 RFC 파라미터용이고 다른 하나는 실행 파라미터용)을 사용하고 두 파일을 입력으로 사용하여 `create-rfc` 명령을 실행합니다. 두 방법 모두 여기에 설명되어 있습니다.
1. 반환된 RFC ID로 RFC: `aws amscm submit-rfc --rfc-id ID` 명령을 제출합니다.
RFC: `aws amscm get-rfc --rfc-id ID` 명령을 모니터링합니다.
변경 유형 버전을 확인하려면 다음 명령을 사용합니다.
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**참고**
`CreateRfc` 변경 유형에 대한 스키마의 일부인지 여부에 관계없이 모든 파라미터를 RFC와 함께 사용할 수 있습니다. 예를 들어 RFC 상태가 변경될 때 알림을 받으려면 요청의 `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` RFC 파라미터 부분(실행 파라미터 아님)에이 줄을 추가합니다. 모든 CreateRfc 파라미터 목록은 [AMS Change Management API 참조](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html)를 참조하세요.
*인라인 생성*:
인라인으로 제공된 실행 파라미터(실행 파라미터를 인라인으로 제공할 때 따옴표 이스케이프)로 RFC 생성 명령을 실행한 다음 반환된 RFC ID를 제출합니다. 예를 들어 콘텐츠를 다음과 같은 내용으로 바꿀 수 있습니다.
```
aws amscm create-rfc --change-type-id "ct-3ovo7px2vsa6n" --change-type-version "3.0" --title "TITLE" --execution-parameters "{\"KeyDescription\": \"Example description\", \"KeyPermissions\": \"key permissions\", \"PolicyAction\": \"Replace\", \"Operation\": \"Update\"}"
```
*템플릿 생성*:
1. 이 변경 유형에 대한 실행 파라미터 JSON 스키마를 파일로 출력합니다.이 예제에서는 UpdateKmsKeyParams.json:이라는 이름을 지정합니다.
```
aws amscm get-change-type-version --change-type-id "ct-3ovo7px2vsa6n" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > UpdateKmsKeyParams.json
```
1. UpdateKmsKeyParams 파일을 수정하고 저장합니다. 예를 들어 콘텐츠를 다음과 같은 내용으로 바꿀 수 있습니다.
```
{
"KeyDescription": "KMS key request",
"PolicyAction": "Replace",
"KeyPermissions": {"Id":"key-consolepolicy-3","Version": "2012-10-17", "Statement":[{"Sid":"Allow use of the key","Effect":"Allow","Principal":{"AWS":["arn:aws:iam::111122223333:role/KMSRole"]},"Action":["kms:Encrypt","kms:Decrypt","kms:ReEncrypt*","kms:GenerateDataKey*","kms:DescribeKey"],"Resource":"*"}]},
"Operation": "Update"
}
```
1. RFC 템플릿 JSON 파일을 파일로 출력합니다.이 예제에서는 파일 이름을 UpdateKmsKeyRfc.json:으로 지정합니다.
```
aws amscm create-rfc --generate-cli-skeleton > UpdateKmsKeyRfc.json
```
1. UpdateKmsKeyRfc.json 파일을 수정하고 저장합니다. 예를 들어 콘텐츠를 다음과 같은 내용으로 바꿀 수 있습니다.
```
{
"ChangeTypeVersion": "3.0",
"ChangeTypeId": "ct-3ovo7px2vsa6n",
"Title": "KmsKey-Update-RFC"
}
```
1. UpdateKmsKey Rfc 파일과 UpdateKmsKeyParams 파일을 지정하여 RFC를 생성합니다.
```
aws amscm create-rfc --cli-input-json file://UpdateKmsKeyRfc.json --execution-parameters file://UpdateKmsKeyParams.json
```
응답에서 새 RFC의 ID를 수신하고 이를 사용하여 RFC를 제출하고 모니터링할 수 있습니다. 제출하기 전까지는 RFC가 편집 상태로 유지되고 시작되지 않습니다.
#### 팁
**참고**
이 변경 유형은 KeyStatus 파라미터에 대한 새 파라미터 옵션을 추가하여 v2.0으로 이동했습니다. 이제 KMS 키 삭제 작업을 취소하고 키를 활성화 또는 비활성화하도록 선택할 수 있습니다.
이는 '검토 필요' 변경 유형입니다(AMS 운영자는 CT를 검토하고 실행해야 함). 즉, RFC를 실행하는 데 시간이 더 오래 걸릴 수 있으며 RFC 세부 정보 페이지 대응 옵션을 통해 AMS와 통신해야 할 수 있습니다. 또한 "검토 필요" 변경 유형 RFC를 예약하는 경우 최소 24시간을 허용해야 합니다. 예정된 시작 시간 전에 승인이 이루어지지 않으면 RFC가 자동으로 거부됩니다.
AWS KMS 키에 대한 자세한 내용은 [AWS Key Management Service (KMS)](https://aws.amazon.com/kms/), [AWS Key Management Service FAQs](https://aws.amazon.com/kms/faqs/) 및 [AWS Key Management Service 개념을 참조하세요](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html).
## 실행 입력 파라미터
실행 입력 파라미터에 대한 자세한 내용은 섹션을 참조하세요[변경 유형 ct-3ovo7px2vsa6n 스키마](schemas.md#ct-3ovo7px2vsa6n-schema-section).
## 예: 필수 파라미터
```
{
"TargetKeyARN": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"Operation": "Update"
}
```
## 예: 모든 파라미터
```
{
"KeyDescription": "Exmample description of the key to be created.",
"TargetKeyARN": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"AliasName": "kms_key_name",
"KeyStatus": "Enabled",
"KeyRotation": true,
"KeyPermissions": "KMS Key permissions to add: kms:Get",
"Tags": [
{
"Key": "foo",
"Value": "bar"
},
{
"Key": "testkey",
"Value": "testvalue"
}
],
"Operation": "Update",
"Priority": "Medium"
}
```