키 값 저장소를 위한 도우미 메서드

이 섹션은 생성한 함수에 CloudFront 키 값 저장소를 사용하여 키 값을 포함하는 경우에 적용됩니다. CloudFront Functions에는 키 값 저장소에서 값을 읽을 수 있는 세 가지 도우미 메서드를 제공하는 모듈이 있습니다.

함수 코드에서 이 모듈을 사용하려면 키 값 저장소를 함수와 연결했는지 확인합니다.

그런 다음 함수 코드의 첫 줄에 다음 명령문을 포함시킵니다.

import cf from 'cloudfront';
const kvsId = "key value store ID";
const kvsHandle = cf.kvs(kvsId);

키 값 저장소 ID는 다음과 같을 수 있습니다: a1b2c3d4-5678-90ab-cdef-EXAMPLE1

get() 메서드

이 메서드를 사용하여 지정한 키 이름의 키 값을 반환합니다.

요청

get("key", options);

요청 예제

const value = await kvsHandle.get("myFunctionKey", { format: "string"});

응답

응답은 options를 사용하여 요청한 형식의 값으로 해석되는 promise입니다. 기본적으로 값은 문자열로 반환됩니다.

exists() 메서드

키가 키 값 저장소에 존재하는지 여부를 지정하려면 이 메서드를 사용합니다.

요청

exists("key");

요청 예제

const exist = await kvsHandle.exists("myFunctionkey");

응답

응답은 부울(true 또는 false)을 반환하는 promise입니다. 이 값은 키가 키 값 저장소에 존재하는지 여부를 지정합니다.

오류 처리

요청된 키가 관련 키 값 저장소에 존재하지 않는 경우 get() 메서드는 오류를 반환합니다. 이 사용 사례를 관리하기 위해 코드에 try 및 catch 블록을 추가할 수 있습니다.

meta() 메서드

이 메서드를 사용하여 키 값 저장소에 대한 메타데이터를 반환합니다.

요청

meta();

요청 예제

const meta = await kvsHandle.meta();

응답

응답은 다음과 같은 속성을 가진 객체로 확인되는 promise입니다.

응답 예제

{keyCount:3,creationDateTime:2023-11-30T23:07:55.765Z,lastUpdatedDateTime:2023-12-15T03:57:52.411Z}