키 값 데이터로 작업 - Amazon CloudFront
CloudFront 콘솔을 사용하여 키 값 페어로 작업하기프로그래밍 방식으로 키 값 페어 작업

키 값 데이터로 작업

다음과 같은 방법으로 기존 키 값 저장소의 키 값 페어를 사용할 수 있습니다.

  • Amazon CloudFront 콘솔을 사용합니다.

  • CloudFront KeyValueStore API 또는 선호하는 AWS SDK를 사용합니다.

이 섹션에서는 기존 키 값 저장소에 키 값 페어를 추가하는 방법을 설명합니다. 키 값 저장소를 처음 생성할 때 키 값 페어를 포함하려면 키 값 저장소 생성 섹션을 참조하세요.

CloudFront 콘솔을 사용하여 키 값 페어로 작업하기

CloudFront 콘솔을 사용하여 키 값 페어로 작업할 수 있습니다.

키-값 페어로 작업하려면

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

  2. KeyValueStore 탭을 선택합니다. 변경할 키 값 저장소를 선택합니다. 세부 정보 페이지가 나타납니다.

  3. 키 값 페어 섹션에서 편집 버튼을 선택합니다.

  4. 키 값 페어를 추가하거나, 키 값 페어를 삭제하거나, 기존 키 값 페어의 값을 변경할 수 있습니다.

  5. 작업을 마쳤으면 변경 사항 저장을 선택합니다.

프로그래밍 방식으로 키 값 페어 작업

참고

CloudFront KeyValueStore API는 CloudFront API와 네임스페이스가 다릅니다.

키 값 저장소에 대한 참조 가져오기

CloudFront KeyValueStore를 사용하여 쓰기 작업을 입력할 때는 키 값 저장소의 ARN과 ETag를 전달해야 합니다. 이 데이터를 가져오려면 다음 작업을 수행합니다.

  1. 선호하는 CloudFront API 또는 SDK의 목록 작업을 사용합니다. 예를 들어, REST API의 경우 CloudFront.ListKeyValueStores를 사용하세요. 응답에는 키 값 저장소 목록이 포함됩니다. 변경할 키 값 저장소의 이름을 찾습니다.

  2. 선호하는 CloudFront KeyValueStore API 또는 SDK의 설명 작업을 사용하세요. 예를 들어, REST API의 경우 CloudFrontKeyValueStore.DescribeKeyValueStore를 사용하세요. 이전 단계에서 가져온 이름을 전달합니다.

    참고

    CloudFront API가 아닌 CloudFront KeyValueStore API의 작업을 사용하세요. 자세한 내용은 CloudFront KeyValueStore 소개 단원을 참조하십시오.

    응답에는 키 값 저장소의 ARN과 ETag가 포함됩니다.

    • ARN에는 AWS 계정 번호, 상수 key-value-store, UUID가 포함됩니다. 예:

      arn:aws:cloudfront::111122223333:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

    • ETag는 ETVABCEXAMPLE2입니다.

키 값 저장소의 키 값 페어 변경

선호하는 CloudFront KeyValueStore API 또는 SDK의 다음 작업을 사용하여 키 값 페어 작업을 수행할 수 있습니다. 이러한 모든 작업은 하나의 지정된 키 값 저장소에서 작동합니다.

  • CloudFrontKeyValueStore.DeleteKey: 키 하나를 삭제합니다. DeleteKey를 참조하세요.

  • CloudFrontKeyValueStore.GetKey: 키 하나를 가져옵니다. GetKey를 참조하세요.

  • CloudFrontKeyValueStore.ListKeys: 키를 나열합니다. ListKeys를 참조하세요.

  • CloudFrontKeyValueStore.PutKey: 다음 두 가지 작업을 수행할 수 있습니다.

    • 하나의 키 값 저장소에 새 키 값 페어를 생성합니다. 이 경우에는 새 키 이름과 값을 전달하세요.

    • 기존 키 값 페어 하나에 다른 값을 설정합니다. 이 경우에는 기존 키 이름과 새 키 값을 전달하세요.

    PutKey를 참조하세요.

  • CloudFrontKeyValueStore.UpdateKeys: 전부 또는 전무 작업 하나로 다음 작업 중 하나 이상을 수행할 수 있습니다.

    • 하나 이상의 키 값 페어를 삭제합니다.

    • 새 키 값 페어를 하나 이상 생성합니다.

    • 하나 이상의 기존 키 값 페어에 다른 값을 설정합니다.

    UpdateKeys를 참조하세요.

CloudFront KeyValueStore 소개

기존 키 값 저장소에서 프로그래밍 방식으로 키 값 페어를 사용하려면 CloudFront KeyValueStore 서비스를 사용합니다.

키 값 저장소를 처음 생성할 때 키 값 저장소에 일부 키 값 페어를 포함하려면 CloudFront 서비스를 사용합니다.

설명 작업

CloudFront API와 CloudFront KeyValueStore API에는 모두 키 값 저장소에 대한 데이터를 반환하는 설명 작업이 있습니다.

  • CloudFront API는 저장소 자체가 마지막으로 수정된 상태 및 날짜와 같은 데이터를 제공합니다.

  • CloudFront KeyValueStore API는 스토리지 리소스의 콘텐츠(저장소의 키 값 페어, 콘텐츠 크기)에 대한 데이터를 제공합니다.

두 API의 설명 작업은 키 값 저장소를 식별하는 약간 다른 데이터를 반환합니다.

  • CloudFront API의 설명 작업은 키 값 저장소의 ETag, UUID, ARN을 반환합니다.

  • CloudFront KeyValueStore API의 설명 작업은 키 값 저장소의 ETag와 ARN을 반환합니다.

참고

각 설명 작업은 서로 다른 ETag를 반환합니다. ETag는 서로 바꿔서 사용할 수 없습니다.

API 중 하나에서 작업을 수행할 때는 적절한 API에서 ETag를 전달해야 합니다. 예를 들어 CloudFront KeyValueStore의 삭제 작업에서는 CloudFront KeyValueStore의 설명 작업에서 가져온 ETag를 전달합니다.

CloudFront 키 값 저장소 예제 코드

예 DescribeKeyValueStore API 작업 호출

다음 샘플 코드는 키 값 스토어에 대한 DescribeKeyValueStore API 작업을 직접 호출하는 방법을 보여줍니다.

const {
  CloudFrontKeyValueStoreClient,
  DescribeKeyValueStoreCommand,
} = require("@aws-sdk/client-cloudfront-keyvaluestore");

require("@aws-sdk/signature-v4-crt");

(async () => {
  try {
    const client = new CloudFrontKeyValueStoreClient({
      region: "us-east-1"
    });
    const input = {
      KvsARN: "arn:aws:cloudfront::123456789012:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    };
    const command = new DescribeKeyValueStoreCommand(input);

    const response = await client.send(command);
  } catch (e) {
    console.log(e);
  }
})();