다음을 통해 공유

API Management 정책 참조

  • 아티클

적용 대상: 모든 API Management 계층

이 섹션에서는 모든 API Management 정책에 대한 간략한 설명과 참조 문서 링크를 제공합니다. 각 정책을 지원하는 API Management 게이트웨이가 표시되어 있습니다. 자세한 정책 설정 및 예는 링크로 제공되는 참조 문서에서 확인하세요.

정책에 대한 자세한 정보:

Important

구독별 통화 속도 제한 및 구독별 사용 할당량 설정은 구독 키에 종속됩니다. 다른 정책이 적용될 때는 구독 키가 필요하지 않습니다.

속도 제한 및 할당량

정책 설명 클래식 V2 소비 자체 호스팅
구독으로 호출 속도 제한 구독을 기준으로 호출 속도를 제한하여 API 사용량 급증을 방지합니다. 예 예 예 예
키로 호출 속도 제한 키를 기준으로 호출 속도를 제한하여 API 사용량 급증을 방지합니다. 예 예 아니요 예
구독으로 사용 할당량 설정 구독을 기준으로 갱신 가능 또는 수명 호출 볼륨 및/또는 대역폭 할당량을 적용할 수 있습니다. 예 예 예 예
키로 사용 할당량 설정 키를 기준으로 갱신 가능 또는 수명 호출 볼륨 및/또는 대역폭 할당량을 적용할 수 있습니다. 예 아니요 아니요 예
동시성 제한 포함된 정책이 한 번에 지정된 요청 수를 초과해서 실행하지 못하게 합니다. 예 예 예 예
Azure OpenAI Service 토큰 사용 제한 계산된 키당 대규모 언어 모델 토큰을 제한하여 Azure OpenAI API 사용량 급증을 방지합니다. 예 예 아니요 아니요
대규모 언어 모델 API 토큰 사용 제한 계산된 키당 LLM 토큰을 제한하여 LLM(대규모 언어 모델) API 사용량 급증을 방지합니다. 예 예 아니요 아니요

인증 및 권한 부여

정책 설명 클래식 V2 소비 자체 호스팅
HTTP 헤더 확인 HTTP 헤더의 유무 및/또는 값을 적용합니다. 예 예 예 예
권한 부여 컨텍스트 가져오기 API Management 인스턴스에 구성된 자격 증명 공급자에 대한 지정된 연결의 권한 부여 컨텍스트를 가져옵니다. 예 예 예 아니요
호출자 IP 제한 특정 IP 주소 및/또는 주소 범위의 호출을 필터링(허용/거부)합니다. 예 예 예 예
Microsoft Entra 토큰 유효성 검사 지정된 HTTP 헤더, 쿼리 매개 변수 또는 토큰 값에서 추출된 Microsoft Entra(이전 Azure Active Directory) JWT의 유무 및 유효성을 적용합니다. 예 예 예 예
JWT 유효성 검사 지정된 HTTP 헤더, 쿼리 매개 변수 또는 토큰 값에서 추출된 JWT의 유무 및 유효성을 적용합니다. 예 예 예 예
클라이언트 인증서 유효성 검사 클라이언트가 API Management 인스턴스에 제공하는 인증서가 지정된 유효성 검사 규칙 및 클레임과 일치하도록 적용합니다. 예 예 예 예
기본 사용 인증 기본 인증을 사용하여 백 엔드 서비스에 인증합니다. 예 예 예 예
클라이언트 인증서 사용 인증 클라이언트 인증서를 사용하여 백 엔드 서비스에 인증합니다. 예 예 예 예
관리 ID를 사용하여 인증 관리 ID를 사용하여 백 엔드 서비스에 인증합니다. 예 예 예 예

내용 유효성 검사

정책 설명 클래식 V2 소비 자체 호스팅
콘텐츠 유효성 검사 하나 이상의 API 스키마에 대한 요청 또는 응답 본문의 크기 또는 콘텐츠의 유효성을 검사합니다. 지원되는 스키마 형식은 JSON 및 XML입니다. 예 예 예 예
GraphQL 요청 유효성 검사 GraphQL API에 대한 요청의 유효성을 검사하고 권한을 부여합니다. 예 예 예 예
OData 요청 유효성 검사 OData 사양을 준수하는지 확인하기 위해 OData API에 대한 요청의 유효성을 검사합니다. 예 예 예 예
매개 변수 유효성 검사 API 스키마에 대한 요청 헤더, 쿼리 또는 경로 매개 변수의 유효성을 검사합니다. 예 예 예 예
헤더 유효성 검사 API 스키마에 대한 응답 헤더의 유효성을 검사합니다. 예 예 예 예
상태 코드 유효성 검사 API 스키마에 대한 응답에서 HTTP 상태 코드의 유효성을 검사합니다. 예 예 예 예

라우팅

정책 설명 클래식 V2 소비 자체 호스팅
요청 전달 백 엔드 서비스에 요청을 전달합니다. 예 예 예 예
백엔드 서비스 설정 들어오는 요청의 백 엔드 서비스 기준 URL을 URL 또는 백 엔드로 변경합니다. 백 엔드 리소스를 참조하면 백 엔드 서비스 기준 URL 및 기타 설정을 한 곳에서 관리할 수 있습니다. 또한 백 엔드 서비스 풀 전체의 트래픽 부하 분산과 회로 차단기 규칙을 구현하여 너무 많은 요청으로부터 백 엔드를 보호합니다. 예 예 예 예
HTTP 프록시 설정 HTTP 프록시를 통해 전달되는 요청을 라우팅할수 있습니다. 예 예 예 예

캐싱

정책 설명 클래식 V2 소비 자체 호스팅
캐시에서 가져오기 캐시 조회를 수행하고 가능한 경우 유효한 캐시된 응답을 반환합니다. 예 예 예 예
캐시에 저장 지정된 캐시 제어 구성에 따라 응답을 캐시합니다. 예 예 예 예
캐시에서 값 가져오기 키별로 캐시된 항목을 검색합니다. 예 예 예 예
값을 캐시에 저장 키별로 캐시에 항목을 저장합니다. 예 예 예 예
캐시에서 값 제거 키별로 캐시의 항목을 제거합니다. 예 예 예 예
Azure OpenAI API 요청의 캐시된 응답 가져오기 의미 체계 검색을 사용하여 Azure OpenAI API 캐시에서 조회를 수행하고, 사용 가능한 경우 유효한 캐시된 응답을 반환합니다. 예 예 예 예
캐시에 Azure OpenAI API 요청의 응답 저장 Azure OpenAI API 캐시 구성에 따라 응답을 캐시합니다. 예 예 예 예
대규모 언어 모델 API 요청의 캐시된 응답 가져오기 의미 체계 검색을 사용하여 대규모 언어 모델 API 캐시에서 조회를 수행하고, 가능한 경우 유효한 캐시된 응답을 반환합니다. 예 예 예 예
대규모 언어 모델 API 요청의 응답을 캐시에 저장 대규모 언어 모델 API 캐시 구성에 따라 응답을 캐시합니다. 예 예 예 예

변환

정책 설명 클래식 V2 소비 자체 호스팅
요청 메서드 설정 요청에 대한 HTTP 메서드를 변경할 수 있습니다. 예 예 예 예
상태 코드 설정 지정된 값으로 HTTP 상태 코드를 변경합니다. 예 예 예 예
변수 설정 나중에 액세스할 수 있도록 명명된 컨텍스트 변수의 값을 유지합니다. 예 예 예 예
본문 설정 요청 또는 응답의 메시지 본문을 설정합니다. 예 예 예 예
HTTP 헤더 설정 기존 응답 및/또는 요청 헤더에 값을 할당하거나 새 응답 및/또는 요청 헤더를 추가합니다. 예 예 예 예
쿼리 문자열 매개 변수 설정 요청 쿼리 문자열 매개 변수를 추가 또는 삭제하거나 해당 값을 바꿉니다. 예 예 예 예
URL 다시 작성 요청 URL을 공용 양식에서 웹 서비스에 필요한 양식으로 변환합니다. 예 예 예 예
JSON을 XML로 변환 요청 또는 응답 본문을 JSON에서 XML로 변환합니다. 예 예 예 예
XML을 JSON으로 변환 요청 또는 응답 본문을 XML에서 JSON으로 변환합니다. 예 예 예 예
본문 문자열 찾기 및 바꾸기 요청 또는 응답 하위 문자열을 찾고 다른 하위 문자열로 바꿉니다. 예 예 예 예
콘텐츠의 URL 마스킹 응답 본문에 링크를 다시 작성(마스킹)하여 게이트웨이를 통해 동등한 링크를 가리키도록 합니다. 예 예 예 예
XSLT를 사용하여 XML 변환 요청 또는 응답 본문의 XML에 XSL 변환을 적용합니다. 예 예 예 예
응답 반환 파이프라인 실행을 중단하고 호출자에 직접 지정된 응답을 반환합니다. 예 예 예 예
모의 응답 파이프라인 실행을 중단하고 호출자에게 직접 모의 응답을 반환합니다. 예 예 예 예

도메인 간

정책 설명 클래식 V2 소비 자체 호스팅
도메인 간 호출 허용 Adobe Flash 및 Microsoft Silverlight 브라우저 기반 클라이언트에서 API에 액세스할 수 있도록 설정합니다. 예 예 예 예
CORS 브라우저 기반 클라이언트의 도메인 간 호출을 허용하기 위해 작업이나 API에 CORS(원본 간 리소스 공유) 지원을 추가합니다. 예 예 예 예
JSONP JavaScript 브라우저 기반 클라이언트의 도메인 간 호출을 허용하기 위해 작업이나 API에 JSONP(JSON with padding) 지원을 추가합니다. 예 예 예 예

통합 및 외부 통신

정책 설명 클래식 V2 소비 자체 호스팅
요청 전송 지정된 URL로 요청을 보냅니다. 예 예 예 예
단방향 요청 전송 응답을 기다리지 않고 지정된 URL로 요청을 보냅니다. 예 예 예 예
이벤트 허브에 로그 로거 엔터티가 정의한 이벤트 허브에 지정된 형식으로 메시지를 보냅니다. 예 예 예 예
서비스에 요청 보내기(Dapr) Dapr 런타임을 사용하여 Dapr 마이크로 서비스를 찾고 안정적으로 통신합니다. Dapr에서 서비스 호출에 대한 자세한 정보는 추가 정보 파일의 설명을 참조하세요. 아니요 아니요 아니요 예
Pub/Sub 토픽으로 메시지 보내기(Dapr) Dapr 런타임을 사용하여 게시/구독 토픽에 메시지를 게시합니다. Dapr에서 게시/구독 메시지 보내기에 대한 자세한 정보는 추가 정보 파일의 설명을 참조하세요. 아니요 아니요 아니요 예
출력 바인딩 트리거(Dapr) Dapr 런타임을 사용하여 출력 바인딩을 통해 외부 시스템을 호출합니다. Dapr의 바인딩에 대한 자세한 정보는 추가 정보 파일의 설명을 참조하세요. 아니요 아니요 아니요 예

로깅

정책 설명 클래식 V2 소비 자체 호스팅
Trace 테스트 콘솔, Application Insights 원격 분석, 리소스 로그의 요청 추적 출력에 사용자 지정 추적을 추가합니다. 예 예1 예 예
메트릭 내보내기 실행 시 사용자 지정 메트릭을 Application Insights로 보냅니다. 예 예 예 예
Azure OpenAI 토큰 메트릭 내보내기 Azure OpenAI 서비스 API를 통해 대규모 언어 모델 토큰 사용량을 위해 Application Insights에 메트릭을 보냅니다. 예 예 아니요 예
대규모 언어 모델 API 토큰 메트릭 내보내기 LLM API를 통해 LLM(대규모 언어 모델) 토큰 사용량에 대한 메트릭을 Application Insights로 전송합니다. 예 예 아니요 예

1 V2 게이트웨이에서 trace 정책은 현재 테스트 콘솔에 추적 출력을 추가하지 않습니다.

GraphQL 해결 프로그램

정책 설명 클래식 V2 소비 자체 호스팅
해결 프로그램용 Azure SQL 데이터 원본 GraphQL 스키마의 개체 형식 및 필드에 대한 데이터를 확인하기 위해 Azure SQL 요청 및 선택적 응답을 구성합니다. 예 예 아니요 아니요
해결 프로그램용 Cosmos DB 데이터 원본 GraphQL 스키마의 개체 형식 및 필드에 대한 데이터를 확인하기 위해 Cosmos DB 요청 및 선택적 응답을 구성합니다. 예 예 아니요 아니요
해결 프로그램용 HTTP 데이터 원본 GraphQL 스키마의 개체 형식 및 필드에 대한 데이터를 확인하기 위해 HTTP 요청과 선택적 HTTP 응답을 구성합니다. 예 예 예 아니요
GraphQL 구독에 이벤트 게시 GraphQL API 스키마에 지정된 하나 이상의 구독에 이벤트를 게시합니다. 변형과 같은 다른 작업 유형에 대한 스키마의 관련 필드에 대해 GraphQL 해결 프로그램에서 정책을 구성합니다. 예 예 예 아니요

정책 제어 및 흐름

정책 설명 클래식 V2 소비 자체 호스팅
제어 흐름 부울 식 평가 결과에 따라 정책 문을 조건부로 적용합니다. 예 예 예 예
조각 포함 정책 정의에 정책 조각을 삽입합니다. 예 예 예 예
재시도 조건이 충족될 때까지 포함된 정책 문을 실행하도록 다시 시도합니다. 실행은 지정된 시간 간격으로 최대 지정된 재시도 횟수까지 반복됩니다. 예 예 예 예
Wait 계속하기 전에 포함된 요청 전송, 캐시에서 값 가져오기 또는 제어 흐름 정책이 완료될 때까지 기다립니다. 예 예 예 예

관련 콘텐츠

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