키 값 저장소 생성 - Amazon CloudFront

키 값 저장소 생성

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

참고

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

키 값 저장소를 생성하면서 키 값 페어를 동시에 추가할지 여부를 결정하세요. CloudFront 콘솔, CloudFront API 또는 AWS SDK를 사용하여 키 값 페어를 가져올 수 있습니다. 그러나 키 값 저장소를 처음 만들 때만 키 값 페어 파일을 가져올 수 있습니다.

키 값 페어로 구성된 파일을 생성하려면 키 값 페어의 파일 형식 섹션을 참조하세요.

Console
키 값 저장소를 생성하려면
  1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/cloudfront/v4/home#/functions에 있는 CloudFront 콘솔에서 함수 페이지를 엽니다.

  2. KeyValueStores 탭을 선택한 다음 KeyValueStore 생성을 선택합니다.

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

  4. S3 URI 작성:

    • 키 값 페어 파일이 있는 경우 파일을 저장한 Amazon S3 버킷의 경로를 입력합니다.

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

  5. 생성(Create)을 선택합니다. 키 값 저장소가 생겼습니다.

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

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

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

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

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

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

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

    • 이 단계를 건너뛰고 나중에 키 값 페어를 추가할 수 있습니다.

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

    1. 키 값 페어 추가를 선택합니다.

    2. 페어 추가를 선택하고 이름과 값을 입력합니다. 태그를 더 추가하려면 이 단계를 반복합니다.

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

  8. 지금 키 값 저장소를 함수와 연결하려면 연결된 함수 섹션을 완료하세요. 자세한 내용은 함수 생성 또는 함수 업데이트을 참조하세요.

    나중에 이 키 값 저장소 세부 정보 페이지 또는 함수 세부 정보 페이지에서 함수를 연결할 수도 있습니다.

AWS CLI
키 값 저장소를 생성하려면
  • 다음 명령을 실행하여 키 값 저장소를 생성하고 Amazon S3 버킷에서 키 값 페어를 가져옵니다.

    aws cloudfront create-key-value-store \ --name=keyvaluestore1 \ --comment="This is my key value store file" \ --import-source=SourceType=S3,SourceARN=arn:aws:s3:::amzn-s3-demo-bucket1/kvs-input.json

    응답

    { "ETag": "ETVABCEXAMPLE", "Location": "https://cloudfront.amazonaws.com/2020-05-31/key-value-store/arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example", "KeyValueStore": { "Name": "keyvaluestore1", "Id": "8aa76c93-3198-462c-aaf6-example", "Comment": "This is my key value store file", "ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example", "Status": "PROVISIONING", "LastModifiedTime": "2024-08-06T22:19:10.813000+00:00" } }
API
키 값 저장소를 생성하려면
  1. CloudFront CreateKeyValueStore 작업을 사용합니다. 이 작업에는 다음과 같은 몇 가지 파라미터가 사용됩니다.

    • 키 값 저장소의 name

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

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

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

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

  • 생성 시간 등의 데이터

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

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

키 값 저장소 상태

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

설명

프로비저닝

키 값 저장소가 생성되었으며 CloudFront는 지정된 데이터 소스를 처리하고 있습니다.

준비됨

키 값 저장소가 생성되고 CloudFront가 지정한 데이터 소스를 성공적으로 처리했습니다.

가져오기에 실패했습니다.

CloudFront는 지정한 데이터 소스를 처리하지 못했습니다. 파일 형식이 유효하지 않거나 크기 제한을 초과하는 경우 이 상태가 나타날 수 있습니다. 자세한 내용은 키 값 페어의 파일 형식 단원을 참조하십시오.