값을 캐시에 저장
적용 대상: 모든 API Management 계층
cache-store-value
는 키로 캐시 스토리지을 수행합니다. 키는 임의의 문자열 값을 포함할 수 있으며 일반적으로 정책 식을 사용하여 제공됩니다.
참고 항목
이 정책에 따라 수행된, 캐시에 값을 저장하는 작업은 동기화됩니다. 저장된 값은 캐시에서 값 가져오기 정책을 사용하여 검색할 수 있습니다. 그러나 캐시에 값을 저장하는 비동기 작업이 여전히 진행 중일 수 있으므로 저장된 값이 즉시 검색되지 않을 수 있습니다.
Important
기본 제공 캐시는 휘발성이며 동일한 API Management 서비스의 동일한 지역에 있는 모든 유닛에서 공유됩니다.
참고 항목
정책 문에 제공된 순서대로 정책의 요소 및 자식 요소를 설정합니다. API Management 정책을 설정하거나 편집하는 방법에 대해 자세히 알아봅니다.
정책 문
<cache-store-value key="cache key value" value="value to cache" duration="seconds" caching-type="prefer-external | external | internal" />
특성
특성 | 설명 | 필수 항목 | 기본값 |
---|---|---|---|
caching-type | 다음 특성 값 중에서 선택합니다. - internal 기본 제공 API Management 캐시를 사용합니다.- external Azure API Management에서 외부 Azure Cache for Redis 사용에 설명된 대로 외부 캐시를 사용합니다.- prefer-external 구성된 경우 외부 캐시를 사용하고 그렇지 않으면 내부 캐시를 사용합니다.정책 식은 허용되지 않습니다. |
아니요 | prefer-external |
duration | 제공된 기간 값 동안 값(초 단위로 지정)이 캐시됩니다. 정책 식이 허용됩니다. | 예 | 해당 없음 |
key | 값을 저장할 캐시 키입니다. 정책 식이 허용됩니다. | 예 | 해당 없음 |
value | 캐시될 값입니다. 정책 식이 허용됩니다. | 예 | 해당 없음 |
사용
- 정책 섹션: inbound, outbound, backend, on-error
- 정책 범위: 전역, 작업 영역, 제품, API, 작업
- 게이트웨이: 클래식, v2, 사용량, 자체 호스팅, 작업 영역
예시
<cache-store-value
key="@("userprofile-" + context.Variables["enduserid"])"
value="@((string)context.Variables["userprofile"])" duration="100000" />
이 정책에 대한 자세한 내용과 예제는 Azure API Management의 사용자 지정 캐싱을 참조하세요.
관련 정책
관련 콘텐츠
정책 작업에 대한 자세한 내용은 다음을 참조하세요.
- 자습서: API 변환 및 보호
- 정책 문 및 해당 설정에 대한 전체 목록에 대한 정책 참조
- 정책 식
- 정책 설정 또는 편집
- 정책 구성 재사용
- 정책 코드 조각 리포지토리
- Azure API Management 정책 도구 키트
- Azure의 Microsoft Copilot을 사용하는 작성자 정책