적용 대상: 모든 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 |
소비 |
자체 호스팅 |
작업 영역 |
요청 메서드 설정 |
요청에 대한 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 |
소비 |
자체 호스팅 |
작업 영역 |
흔적 |
테스트 콘솔, 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 |
소비 |
자체 호스팅 |
작업 영역 |
제어 흐름 |
부울 식 평가 결과에 따라 정책 문을 조건부로 적용합니다. |
예 |
예 |
예 |
예 |
예 |
조각 포함 |
정책 정의에 정책 조각을 삽입합니다. |
예 |
예 |
예 |
예 |
예 |
재시도 |
조건이 충족될 때까지 포함된 정책 문을 실행하도록 다시 시도합니다. 실행은 지정된 시간 간격으로 최대 지정된 재시도 횟수까지 반복됩니다. |
예 |
예 |
예 |
예 |
예 |
기다림 |
계속하기 전에 포함된 요청 전송, 캐시에서 값 가져오기 또는 제어 흐름 정책이 완료될 때까지 기다립니다. |
예 |
예 |
예 |
예 |
예 |
관련 콘텐츠
정책 작업에 대한 자세한 내용은 다음을 참조하세요.