키 값 저장소 생성

비어 있는 키 값 저장소를 만든 다음 나중에 키 값 페어를 추가할 수 있습니다. 또는 키 값 저장소와 키 값 페어를 동시에 생성할 수도 있습니다.

참고

Amazon S3 버킷에서 데이터 소스를 지정하는 경우 해당 버킷에 대한 s3:GetObject 및 s3:GetBucketLocation 권한이 있어야 합니다. 이러한 권한이 없는 경우 CloudFront는 키 값 저장소를 성공적으로 생성할 수 없습니다.

Console

키 값 저장소(콘솔)를 생성하려는 경우

1. 키 값 저장소를 생성하면서 키 값 페어를 동시에 추가할지 여부를 결정하세요. 이 가져오기 기능은 CloudFront 콘솔과 CloudFront API 및 AWS SDK에서 지원됩니다. 그러나 키 값 저장소를 처음 생성할 때만 지원됩니다.

   파일을 사용하려면 지금 생성하세요.

2. AWS Management Console에 로그인하고 https://console.aws.amazon.com/cloudfront/v4/home#/functions에 있는 CloudFront 콘솔에서 함수 페이지를 엽니다.

3. KeyValueStore 탭을 선택합니다. KeyValueStore 생성 버튼을 선택합니다.

4. 키 값 저장소 이름을 입력하고 필요한 경우 설명을 입력합니다.

5. S3 URI 작성:

   • 키 값 페어로 구성된 파일을 준비한 경우 파일을 저장한 Amazon S3 버킷의 경로를 입력합니다.

   • 키 값 페어를 수동으로 입력하려는 경우 이 필드를 비워 두세요.

6. 생성을 선택합니다. 키 값 저장소가 생겼습니다.

   새로운 키 값 저장소의 세부 정보 페이지가 나타납니다. 페이지의 정보에는 키 값 저장소의 ID 및 ARN이 포함됩니다.

   • ID는 AWS 계정에서 고유한 임의의 문자열입니다.

   • ARN의 구문은 다음과 같습니다.

     AWS 계정:key-value-store/키 값 저장소 ID

7. 키 값 페어 섹션을 살펴보세요. 파일을 가져온 경우 이 섹션에 일부 페어가 표시됩니다. 그렇지 않은 경우 비어 있습니다. 다음을 수행할 수 있습니다.

   • Amazon S3 버킷에서 파일을 가져오지 않았고 지금 키 값 페어를 추가하려는 경우 이 섹션을 완료하면 됩니다.

   • 파일을 가져온 경우 직접 값을 더 추가할 수도 있습니다.

   • 이 섹션을 비워 두고 나중에 키 값 저장소를 편집하여 페어를 추가할 수 있습니다.

   지금 페어를 추가하려면 다음 단계를 따르세요.

   • 키 값 페어 추가 버튼을 선택합니다.

   • 페어 추가를 선택하고 이름과 값을 입력합니다.

   • 페어를 더 추가하려면 페어 추가 버튼을 다시 선택합니다.

     작업을 마쳤으면 변경 사항 저장을 선택하여 모든 페어를 키 값 저장소에 저장합니다. 표시되는 확인 대화 상자에서 완료를 선택합니다.

8. 지금 키 값 저장소를 함수와 연결하려면 연결된 함수 섹션을 완료하세요. 나중에 이 키 값 저장소 세부 정보 페이지 또는 함수 세부 정보 페이지에서 이 연결을 생성할 수도 있습니다.

   지금 연결을 생성하려면 함수로 이동 버튼을 선택하세요. 자세한 내용은 함수 생성 또는 함수 업데이트을 참조하세요.

Programmatically

키 값 저장소를 생성하려면

1. 키 값 저장소를 생성하면서 키 값 페어를 동시에 추가할지 여부를 결정하세요. (나중에 키 값 페어를 추가할 수도 있습니다.) 이 가져오기 기능은 CloudFront 콘솔과 CloudFront API 및 SDK 모두에서 지원됩니다. 그러나 키 값 저장소를 처음 만들 때만 지원됩니다.

   파일을 사용하려면 지금 생성하세요.

2. CloudFront API 또는 선호하는 AWS SDK의 생성 작업을 사용하세요. 예를 들어, REST API의 경우 CloudFront.CreateKeyValueStore를 사용합니다. 이 작업에는 다음과 같은 몇 가지 파라미터가 사용됩니다.

   • 이름.

   • 설명이 포함된 configuration 파라미터

   • Amazon S3 버킷에 저장된 파일에서 키 값 페어를 가져올 수 있는 import-source 파라미터. 단, 키 값 저장소를 처음 생성할 때만 파일에서 키 값 페어를 가져올 수 있습니다. 레이블 지정 파일의 형식에 대한 자세한 내용은 키-값 페어로 구성된 파일 생성 섹션을 참조하세요.

작업 응답에는 다음 정보가 포함됩니다.

• 지정한 이름을 포함하여 요청에 전달된 값

• 생성 시간 등의 데이터

• ETag(예: ETVABCEXAMPLE2), 키 값 저장소의 이름을 포함하는 ARN(예:arn:aws:cloudfront::111122223333:key-value-store/MaxAge).

  ETag, ARN 및 이름을 조합하여 키 값 저장소를 프로그래밍 방식으로 사용할 수 있습니다.

키 값 저장소 상태

키 값 저장소를 생성할 때 데이터 저장소는 다음과 같은 상태 값을 가질 수 있습니다.

값	설명
프로비저닝	키 값 저장소가 생성되었으며 CloudFront는 지정된 데이터 소스를 처리하고 있습니다.
준비됨	키 값 저장소가 생성되고 CloudFront가 지정한 데이터 소스를 성공적으로 처리했습니다.
가져오기에 실패했습니다.	CloudFront는 지정한 데이터 소스를 처리하지 못했습니다. 파일 형식이 유효하지 않거나 크기 제한을 초과하는 경우 이 상태가 나타날 수 있습니다. 자세한 내용은 키-값 페어로 구성된 파일 생성 단원을 참조하십시오.