다음을 통해 공유


캐시에서 값 가져오기

적용 대상: 모든 API Management 계층

cache-lookup-value 정책을 사용하여 키별 캐시 조회를 수행하며 캐시된 값을 반환합니다. 키는 임의의 문자열 값을 포함할 수 있으며 일반적으로 정책 식을 사용하여 제공됩니다.

참고 항목

이 정책에는 해당하는 값을 캐시에 저장 정책이 있어야 합니다.

Important

기본 제공 캐시는 휘발성이며 동일한 API Management 서비스의 동일한 지역에 있는 모든 유닛에서 공유됩니다.

참고 항목

정책 문에 제공된 순서대로 정책의 요소 및 자식 요소를 설정합니다. API Management 정책을 설정하거나 편집하는 방법에 대해 자세히 알아봅니다.

정책 문

<cache-lookup-value key="cache key value"
    default-value="value to use if cache lookup resulted in a miss"
    variable-name="name of a variable looked up value is assigned to"
    caching-type="prefer-external | external | internal" />

특성

특성 설명 필수 항목 기본값
caching-type 다음 특성 값 중에서 선택합니다.
- internal 기본 제공 API Management 캐시를 사용합니다.
- externalAzure API Management에서 외부 Azure Cache for Redis 사용에 설명된 대로 외부 캐시를 사용합니다.
- prefer-external 구성된 경우 외부 캐시를 사용하고 그렇지 않으면 내부 캐시를 사용합니다.

정책 식은 허용되지 않습니다.
아니요 prefer-external
default-value 캐시 키 조회 시 누락 항목이 있는 경우 변수에 할당할 값입니다. 이 특성을 지정하지 않으면 null이 할당됩니다. 정책 식이 허용됩니다. 아니요 null
key 조회에 사용할 캐시 키 값입니다. 정책 식이 허용됩니다. 해당 없음
변수 이름 조회에 성공한 경우 조회된 값이 할당될 컨텍스트 변수의 이름입니다. 조회 결과 누락이 발생하면 변수가 설정되지 않습니다. 정책 식은 허용되지 않습니다. 해당 없음

사용

예시

<cache-lookup-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    variable-name="userprofile" />

이 정책에 대한 자세한 내용과 예제는 Azure API Management의 사용자 지정 캐싱을 참조하세요.

정책 작업에 대한 자세한 내용은 다음을 참조하세요.