적용 대상: 모든 API Management 계층
cache-remove-value 키로 식별된 캐시 항목을 삭제합니다. 키는 임의의 문자열 값을 포함할 수 있으며 일반적으로 정책 식을 사용하여 제공됩니다.
참고 항목
정책 문에 제공된 순서대로 정책의 요소 및 자식 요소를 설정합니다. API Management 정책을 설정하거나 편집하는 방법에 대해 자세히 알아봅니다.
정책 문
<cache-remove-value key="cache key value" caching-type="prefer-external | external | internal" fail-on-cache-removal-error="true | false" />
특성
| 특성 | 설명 | 필수 항목 | 기본값 |
|---|---|---|---|
| caching-type | 다음 특성 값 중에서 선택합니다. - internal
기본 제공 API Management 캐시를 사용합니다.- external
Azure API Management에서 외부 Redis 호환 캐시 사용에서 설명한 대로 외부 캐시를 사용하려면- prefer-external 구성된 경우 외부 캐시를 사용하고 그렇지 않으면 내부 캐시를 사용합니다. 정책 식은 허용되지 않습니다. |
아니요 | prefer-external |
| 열쇠 | 캐시에서 제거할 이전에 캐시된 값의 키입니다. 정책 식이 허용됩니다. | 예 | 해당 없음 |
| 캐시 제거 실패 오류 | 캐시 제거 작업이 실패하면 요청이 실패하도록 설정 true 하세요. 캐시 제거 오류를 무시하도록 설정 false 하세요. 정책 식이 허용됩니다. |
아니요 | false |
사용
- 정책 섹션: inbound, outbound, backend, on-error
- 정책 범위: 전역, 작업 영역, 제품, API, 작업
- 게이트웨이: 클래식, v2, 사용량, 자체 호스팅, 작업 영역
예시
다음 예제에서는 정책을 사용하여 cache-remove-value 캐시에서 사용자 프로필을 제거하는 방법을 보여줍니다. 캐시 제거의 키는 문자열을 컨텍스트 변수의 enduserid 값과 결합하는 정책 식을 사용하여 생성됩니다.
<cache-remove-value
key="@("userprofile-" + context.Variables["enduserid"])" />
이 정책에 대한 자세한 내용과 예제는 Azure API Management의 사용자 지정 캐싱을 참조하세요.
관련 정책
관련 콘텐츠
정책 작업에 대한 자세한 내용은 다음을 참조하세요.
- 자습서: API 변환 및 보호
- 정책 문 및 해당 설정에 대한 전체 목록에 대한 정책 참조
- 정책 식
- 정책 설정 또는 편집
- 정책 구성 재사용
- 정책 코드 조각 리포지토리
- 폴리시 샘플 리포지토리
- Azure API Management 정책 도구 키트
- Copilot 지원을 받아 정책을 만들고, 설명하며, 문제를 해결하세요.