다음을 통해 공유

API Management 정책 참조

적용 대상: 모든 API Management 계층

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

정책에 대한 자세한 정보:

중요합니다

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

속도 제한 및 할당량

정책 설명 클래식 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 소비 자체 호스팅 작업 영역
LLM 요청에 콘텐츠 안전 검사 적용 백 엔드 LLM으로 보내기 전에 AZURE AI 콘텐츠 안전 서비스로 전송하여 LLM 요청(프롬프트)에 콘텐츠 안전 검사를 적용합니다. 예 예 예 예 예
콘텐츠 유효성 검사 하나 이상의 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로 요청을 보냅니다. 예 예 예 예 예
이벤트 허브에 로그 로거 엔터티에 의해 정의된 이벤트 허브에 지정된 형식의 메시지를 보냅니다. 예 예 예 예 예
Azure Service Bus에 메시지 보내기 (미리 보기) Azure Service Bus 큐 또는 토픽에 메시지를 보냅니다. 예 아니요 아니요 아니요 아니요
서비스에 요청 보내기(Dapr) Dapr 런타임을 사용하여 Dapr 마이크로 서비스를 찾고 안정적으로 통신합니다. Dapr에서 서비스 호출에 대한 자세한 정보는 추가 정보 파일의 설명을 참조하세요. 아니요 아니요 아니요 예 아니요
Pub/Sub 토픽으로 메시지 보내기(Dapr) Dapr 런타임을 사용하여 게시/구독 토픽에 메시지를 게시합니다. Dapr에서 게시/구독 메시지 보내기에 대한 자세한 정보는 추가 정보 파일의 설명을 참조하세요. 아니요 아니요 아니요 예 아니요
출력 바인딩 트리거(Dapr) Dapr 런타임을 사용하여 출력 바인딩을 통해 외부 시스템을 호출합니다. Dapr의 바인딩에 대한 자세한 정보는 추가 정보 파일의 설명을 참조하세요. 아니요 아니요 아니요 예 아니요

로깅

정책 설명 클래식 V2 소비 자체 호스팅 작업 영역
흔적 테스트 콘솔, 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 해결 프로그램에서 정책을 구성합니다. 예 예 예 아니요 아니요

AI 게이트웨이

정책 설명 클래식 V2 소비 자체 호스팅 작업 영역
Azure OpenAI Service 토큰 사용 제한 계산된 키당 대규모 언어 모델 토큰을 제한하여 Azure OpenAI API 사용량 급증을 방지합니다. 예 예 아니요 예 예
대규모 언어 모델 API 토큰 사용 제한 계산된 키당 LLM 토큰을 제한하여 LLM(대규모 언어 모델) API 사용량 급증을 방지합니다. 예 예 아니요 예 예
Azure OpenAI 토큰 메트릭 내보내기 Azure OpenAI 서비스 API를 통해 대규모 언어 모델 토큰 사용량을 위해 Application Insights에 메트릭을 보냅니다. 예 예 아니요 예 예
대규모 언어 모델 API 토큰 메트릭 내보내기 LLM API를 통해 LLM(대규모 언어 모델) 토큰 사용량에 대한 메트릭을 Application Insights로 전송합니다. 예 예 아니요 예 예
Azure OpenAI API 요청의 캐시된 응답 가져오기 의미 체계 검색을 사용하여 Azure OpenAI API 캐시에서 조회를 수행하고, 사용 가능한 경우 유효한 캐시된 응답을 반환합니다. 예 예 예 예 아니요
대규모 언어 모델 API 요청의 캐시된 응답 가져오기 의미 체계 검색을 사용하여 대규모 언어 모델 API 캐시에서 조회를 수행하고, 가능한 경우 유효한 캐시된 응답을 반환합니다. 예 예 예 예 아니요
캐시에 Azure OpenAI API 요청의 응답 저장 Azure OpenAI API 캐시 구성에 따라 응답을 캐시합니다. 예 예 예 예 아니요
대규모 언어 모델 API 요청의 응답을 캐시에 저장 대규모 언어 모델 API 캐시 구성에 따라 응답을 캐시합니다. 예 예 예 예 아니요
LLM 요청에 콘텐츠 안전 검사 적용 백 엔드 LLM으로 보내기 전에 AZURE AI 콘텐츠 안전 서비스로 전송하여 LLM 요청(프롬프트)에 콘텐츠 안전 검사를 적용합니다. 예 예 예 예 예

정책 제어 및 흐름

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

관련 콘텐츠

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