Azure API Management v2 계층
적용 대상: 기본 v2 | 표준 v2 | 프리미엄 v2
API Management v2 계층(SKU)은 더 안정적이고 확장 가능한 새로운 플랫폼을 기반으로 하며, API Management를 보다 광범위한 고객 집합에 액세스할 수 있도록 하고 다양한 시나리오에 유연한 옵션을 제공하도록 설계되었습니다. v2 계층은 기존 클래식 계층(개발자, 기본, 표준, 프리미엄) 및 소비 계층에 추가됩니다. API Management 계층에 대한 자세한 비교를 참조하세요.
다음 v2 계층이 일반 공급됩니다.
기본 v2 - 기본 v2 계층은 개발 및 테스트 시나리오를 위해 설계되었으며 SLA에서 지원됩니다.
표준 v2 - 표준 v2는 네트워크 격리 백 엔드를 지원하는 프로덕션 지원 계층입니다.
다음 v2 계층은 미리 보기로 제공됩니다.
프리미엄 v2 - 프리미엄 v2는 전체 가상 네트워크 격리 및 대용량 워크로드에 대한 크기 조정을 비롯한 엔터프라이즈 기능을 제공합니다.
참고 항목
프리미엄 v2 계층은 현재 제한된 미리 보기로 제공됩니다. 등록하려면 이 양식을 입력 합니다.
주요 기능
더 빠른 배포, 구성 및 크기 조정 - 몇 분 안에 프로덕션 준비 API Management 인스턴스를 배포합니다. 인증서 및 호스트 이름 업데이트와 같은 구성을 신속하게 적용합니다. API 관리 워크로드의 요구 사항에 맞게 기본 v2 또는 표준 v2 인스턴스를 최대 10개의 단위까지 빠르게 확장합니다. Premium v2 인스턴스를 최대 30개 단위로 확장합니다.
간소화된 네트워킹 - 표준 v2 및 프리미엄 v2 계층은 API Management의 인바운드 및 아웃바운드 트래픽을 격리하는 네트워킹 옵션을 제공합니다.
프로덕션 워크로드에 대한 추가 옵션 - v2 계층은 모두 SLA에서 지원됩니다.
개발자 포털 옵션 - API 소비자가 API를 검색할 준비가 되면 개발자 포털을 사용하도록 설정합니다.
기능
API 버전
v2 계층의 최신 기능은 API Management API 버전 2024-05-01 이상에서 지원됩니다.
네트워킹 옵션
표준 v2 및 Premium v2는 API Management 인스턴스가 연결된 단일 가상 네트워크에서 격리된 API 백 엔드에 도달할 수 있도록 가상 네트워크 통합을 지원합니다. API Management 게이트웨이, 관리 평면 및 개발자 포털은 여전히 인터넷에서 공개적으로 액세스할 수 있습니다. 가상 네트워크는 API Management 인스턴스와 동일한 지역 및 구독에 있어야 합니다. 자세히 알아보기.
미리 보기 에서 Standard v2 는 API Management 게이트웨이에 대한 인바운드 프라이빗 엔드포인트 연결도 지원합니다 .
또한 Premium v2 는 네트워크 보안 그룹 규칙, 경로 테이블 또는 서비스 엔드포인트 없이 인바운드 및 아웃바운드 게이트웨이 트래픽을 완전히 격리하기 위해 간소화된 가상 네트워크 주입 을 지원합니다. 가상 네트워크는 API Management 인스턴스와 동일한 지역 및 구독에 있어야 합니다. 자세히 알아보기.
지원되는 지역
v2 계층을 사용할 수 있는 지역의 현재 목록은 v2 계층 및 작업 영역 게이트웨이의 가용성을 참조 하세요.
클래식 기능 가용성
클래식 API Management 계층 대부분의 기능은 v2 계층에서 지원됩니다. 그러나 v2 계층에서는 다음 기능이 지원되지 않습니다.
- Git을 사용한 API Management 서비스 구성
- API Management 인스턴스 백업 및 복원
- Azure DDoS Protection 사용
- 직접 관리 API 액세스
제한 사항
다음 API Management 기능은 현재 v2 계층에서 사용할 수 없습니다.
인프라 및 네트워킹
- 다중 지역 배포
- 가용성 영역 지원
- 복수의 사용자 지정 도메인 이름
- 용량 메트릭 - 게이트웨이의 CPU 백분율 및 게이트웨이 메트릭의 메모리 백분율로 대체됨
- 기본 제공 분석 - Azure Monitor 기반 대시보드로 대체
- 자동 확장
- 클래식 계층에서 v2 계층으로 업그레이드
- CA Certificates
- Event Grid에 이벤트 보내기
개발자 포털
- 보고서
- 사용자 지정 HTML 코드 위젯 및 사용자 지정 위젯
- 자체 호스팅 개발자 포털
게이트웨이
- 자체 호스팅 게이트웨이
- 주요 정책별 할당량
- 암호화 구성
- 클라이언트 인증서 재협상
- 무료 관리 TLS 인증서
- localhost를 통한 게이트웨이에 대한 요청
리소스 한계
다음 리소스 제한은 v2 계층에서 적용됩니다.
한도 증가를 요청하려면 Azure Portal에서 지원 요청을 만듭니다. 자세한 내용은 Azure 지원 계획을 참조하세요.
| 리소스 | 기본 v2 | 표준 v2 | 프리미엄 v2 |
|---|---|---|---|
| 최대 배율 단위 수 | 10 | 10 | 30 |
| 서비스 인스턴스당 최대 캐시 크기 | 250MB | 1GB | 5GB |
| 서비스 인스턴스당 최대 API 수 | 150 | 500 | 2,500 |
| 서비스 인스턴스당 최대 API 작업 수 | 3,000 | 10,000 | 20,000 |
| 서비스 인스턴스당 최대 구독 수 | 500 | 2,000 | 4,000 |
| 서비스 인스턴스당 최대 제품 수 | 50 | 200 | 400 |
| 서비스 인스턴스당 최대 사용자 수 | 300 | 2,000 | 4,000 |
| 서비스 인스턴스당 최대 그룹 수 | 20 | 100 | 200 |
| 서비스 인스턴스당 최대 권한 부여 서버 수 | 10 | 500 | 500 |
| 서비스 인스턴스당 최대 정책 조각 수 | 50 | 50 | 100 |
| 서비스 인스턴스당 최대 OpenID Connect 공급자 수 | 10 | 10 | 20 |
| 서비스 인스턴스당 최대 인증서 수 | 100 | 100 | 100 |
| 서비스 인스턴스당 최대 백 엔드 수 | 100 | 100 | 100 |
| 서비스 인스턴스당 최대 캐시 수 | 100 | 100 | 100 |
| 서비스 인스턴스당 명명된 값의 최대 수 | 100 | 100 | 100 |
| 서비스 인스턴스당 최대 로거 수 | 100 | 100 | 100 |
| 서비스 인스턴스당 최대 스키마 수 | 100 | 100 | 100 |
| API당 최대 스키마 수 | 100 | 100 | 100 |
| 서비스 인스턴스당 최대 태그 수 | 100 | 100 | 100 |
| API당 최대 태그 수 | 100 | 100 | 100 |
| 서비스 인스턴스당 최대 버전 집합 수 | 100 | 100 | 100 |
| API당 최대 릴리스 수 | 100 | 100 | 100 |
| API당 최대 작업 수 | 100 | 100 | 100 |
| 서비스 인스턴스당 최대 GraphQL 해결 프로그램 수 | 100 | 100 | 100 |
| API당 최대 GraphQL 해결 프로그램 수 | 100 | 100 | 100 |
| 제품당 최대 API 수 | 100 | 100 | 100 |
| 구독당 최대 API 수 | 100 | 100 | 100 |
| 구독당 최대 제품 수 | 100 | 100 | 100 |
| 제품당 최대 그룹 수 | 100 | 100 | 100 |
| 제품당 최대 태그 수 | 100 | 100 | 100 |
| HTTP 권한당 동시 백 엔드 연결1 | 2,048 | 2,048 | 2,048 |
| 캐시된 최대 응답 크기 | 2MiB | 2MiB | 2MiB |
| 최대 정책 문서 크기 | 256KiB | 256KiB | 256KiB |
| 최대 요청 페이로드 크기 | 1GiB | 1GiB | 1GiB |
| 최대 버퍼링된 페이로드 크기 | 2MiB | 2MiB | 2MiB |
| 진단 로그의 최대 요청/응답 페이로드 크기 | 8,192바이트 | 8,192바이트 | 8,192바이트 |
| 최대 요청 URL 크기2 | 16,384바이트 | 16,384바이트 | 16,384바이트 |
| URL 패스 세그먼트의 최대 길이 | 1,024자 | 1,024자 | 1,024자 |
| 명명된 값의 최대 문자 길이 | 4,096자 | 4,096자 | 4,096자 |
| 콘텐츠 유효성 검사 정책에서 요청 또는 응답 본문의 최대 크기 | 100KiB | 100KiB | 100KiB |
| 유효성 검사 정책에서 사용하는 API 스키마의 최대 크기 | 4MB | 4MB | 4MB |
| 장치당 최대 활성 WebSocket 연결 수3 | 5,000 | 5,000 | 5,000 |
1 백 엔드에서 명시적으로 닫지 않으면 연결이 풀링되고 다시 사용됩니다.
2 최대 2,048바이트 길이의 쿼리 문자열을 포함합니다.
3 서비스 인스턴스당 최대 60,000개까지 연결합니다.
개발자 포털 제한
다음 제한은 v2 계층의 개발자 포털에 적용됩니다.
| Item | 기본 v2 | 표준 v2 | 프리미엄 v2 |
|---|---|---|---|
| 업로드할 최대 미디어 파일 수 | 15 | 15 | 15 |
| 미디어 파일의 최대 크기 | 500KB | 500KB | 500KB |
| 최대 페이지 수 | 30 | 50 | 50 |
| 최대 위젯 수1 | 30 | 50 | 50 |
| 페이지당 메타데이터의 최대 크기 | 350KB | 350KB | 350KB |
| 위젯당 최대 메타데이터 크기1 | 350KB | 350KB | 350KB |
| 분당 최대 클라이언트 요청 수 | 200 | 200 | 200 |
1 텍스트, 이미지, API 목록 등 기본 제공 위젯에 대한 제한입니다. 현재 사용자 지정 위젯 및 사용자 지정 HTML 코드 위젯은 v2 계층에서 지원되지 않습니다.
배포
Azure Portal을 사용하거나 Azure REST API, Azure Resource Manager, Bicep 템플릿 또는 Terraform과 같은 도구를 사용하여 v2 계층 인스턴스를 배포합니다.
자주 묻는 질문
Q: 기존 API Management 인스턴스에서 새 v2 계층 인스턴스로 마이그레이션할 수 있나요?
A: 아니요. 현재는 기존 API Management 인스턴스(사용량, 개발자, 기본, 표준 또는 프리미엄 계층)를 새 v2 계층 인스턴스로 마이그레이션할 수 없습니다. 현재 v2 계층은 새로 만든 서비스 인스턴스에만 사용할 수 있습니다.
Q: stv2 컴퓨팅 플랫폼과 v2 계층 간의 관계는 무엇인가요?
A: 이 둘은 관련이 없습니다. stv2는 개발자, 기본, 표준 및 프리미엄 계층 서비스 인스턴스의 컴퓨팅 플랫폼 버전입니다. stv2는 2024년에 사용 중지된 stv1 컴퓨팅 플랫폼의 후속 작업입니다.
Q: 개발자, 기본, 표준 또는 프리미엄 계층 서비스를 계속 프로비전할 수 있나요?
A: 예, 클래식 개발자, 기본, 표준 또는 프리미엄 계층은 변경되지 않습니다.
Q: 표준 v2 계층의 가상 네트워크 통합과 프리미엄 및 프리미엄 v2 계층의 가상 네트워크 주입 간의 차이점은 무엇인가요?
A: 표준 v2 서비스 인스턴스를 가상 네트워크와 통합하여 상주하는 백 엔드에 대한 보안 액세스를 제공할 수 있습니다. 가상 네트워크와 통합된 표준 v2 서비스 인스턴스에는 인바운드 액세스를 위한 공용 IP 주소가 있습니다.
프리미엄 계층 및 프리미엄 v2 계층은 공용 IP 주소를 노출하지 않고 가상 네트워크에 배포(삽입)하여 전체 네트워크 격리를 지원합니다. API Management의 네트워킹 옵션에 대해 자세히 알아봅니다.
Q: 기본 v2 또는 표준 v2 계층의 인스턴스를 가상 네트워크에 완전히 배포할 수 있나요?
A: 아니요, 이러한 배포는 프리미엄 및 프리미엄 v2 계층에서만 지원됩니다.
관련 콘텐츠
- API Management 계층을 비교합니다.
- API Management 게이트웨이에 대해 자세히 알아보기
- API Management 가격 책정에 대해 자세히 알아봅니다.