적용 대상: 기본 v2 | 표준 v2 | 프리미엄 v2
API Management v2 계층(SKU)은 더 안정적이고 확장 가능한 새로운 플랫폼을 기반으로 하며, API Management를 보다 광범위한 고객 집합에 액세스할 수 있도록 하고 다양한 시나리오에 유연한 옵션을 제공하도록 설계되었습니다. v2 계층은 기존 클래식 계층(개발자, 기본, 표준, 프리미엄) 및 소비 계층에 추가됩니다. API Management 계층에 대한 자세한 비교를 참조하세요.
다음 v2 계층이 일반 공급됩니다.
기본 v2 - 기본 v2 계층은 개발 및 테스트 시나리오를 위해 설계되었으며 SLA에서 지원됩니다.
표준 v2 - 표준 v2는 네트워크 격리 백 엔드를 지원하는 프로덕션 지원 계층입니다.
다음 v2 계층은 미리 보기로 제공됩니다.
- 프리미엄 v2 - Premium v2는 전체 가상 네트워크 격리, 대용량 워크로드 및 작업 영역에 대한 크기 조정을 포함한 엔터프라이즈 기능을 제공합니다.
주요 기능
더 빠른 배포, 구성 및 크기 조정 - 몇 분 안에 프로덕션 준비 API Management 인스턴스를 배포합니다. 인증서 및 호스트 이름 업데이트와 같은 구성을 신속하게 적용합니다. API 관리 워크로드의 요구 사항에 맞게 기본 v2 또는 표준 v2 인스턴스를 최대 10개의 단위까지 빠르게 확장합니다. Premium v2 인스턴스를 최대 30개 단위로 확장합니다.
간소화된 네트워킹 - 표준 v2 및 프리미엄 v2 계층은 API Management의 인바운드 및 아웃바운드 트래픽을 격리하는 네트워킹 옵션을 제공합니다.
프로덕션 워크로드에 대한 추가 옵션 - v2 계층은 모두 SLA에서 지원됩니다.
개발자 포털 옵션 - API 소비자가 API를 검색할 준비가 되면 개발자 포털을 사용하도록 설정합니다.
Features
API 버전
v2 계층의 최신 기능은 API Management API 버전 2024-05-01 이상에서 지원됩니다.
네트워킹 옵션
표준 v2 및 Premium v2는 API Management 인스턴스가 연결된 단일 가상 네트워크에서 격리된 API 백 엔드에 도달할 수 있도록 가상 네트워크 통합을 지원합니다. API Management 게이트웨이, 관리 평면 및 개발자 포털은 여전히 인터넷에서 공개적으로 액세스할 수 있습니다. 가상 네트워크는 API Management 인스턴스와 동일한 지역 및 구독에 있어야 합니다. 자세히알아보세요.
표준 v2 는 API Management 게이트웨이에 대한 인바운드 프라이빗 엔드포인트 연결 도 지원합니다.
또한 Premium v2 는 네트워크 보안 그룹 규칙, 경로 테이블 또는 서비스 엔드포인트 없이 인바운드 및 아웃바운드 게이트웨이 트래픽을 완전히 격리하기 위해 간소화된 가상 네트워크 주입 을 지원합니다. 가상 네트워크는 API Management 인스턴스와 동일한 지역 및 구독에 있어야 합니다. 자세히알아보세요.
지원되는 지역
v2 계층을 사용할 수 있는 지역의 현재 목록은 v2 계층 및 작업 영역 게이트웨이의 가용성을 참조 하세요.
클래식 기능 가용성
클래식 API Management 계층 대부분의 기능은 v2 계층에서 지원됩니다. 그러나 v2 계층에서는 다음 기능이 지원되지 않습니다.
- Git을 사용한 API Management 서비스 구성
- API Management 인스턴스 백업 및 복원
- Azure DDoS Protection 사용
- 직접 관리 API 액세스
Limitations
다음 API Management 기능은 현재 v2 계층에서 사용할 수 없습니다.
인프라 및 네트워킹
- 다중 지역 배포
- 가용성 영역 지원
- 복수의 사용자 지정 도메인 이름
- 용량 메트릭 - 게이트웨이의 CPU 백분율 및 게이트웨이 메트릭의 메모리 백분율로 대체됨
- 기본 제공 분석 - Azure Monitor 기반 대시보드로 대체
- 클래식 계층에서 v2 계층으로 업그레이드
- CA 인증서
- Event Grid에 이벤트 보내기
- Event Hubs 이벤트 메트릭
개발자 포털
- Reports
- 사용자 지정 HTML 코드 위젯 및 사용자 지정 위젯
- 자체 호스팅 개발자 포털
Gateway
- 자체 호스팅 게이트웨이
- 암호 구성
- 클라이언트 인증서 재협상
- 무료 관리 TLS 인증서
- localhost를 통한 게이트웨이에 대한 요청
리소스 제한
다음 리소스 제한은 v2 계층에서 적용됩니다.
API Management 제한 및 인스턴스에서 관리하기 위한 지침에 대한 배경 정보는 API Management 서비스 제한 이해를 참조하세요.
비고
달리 명시하지 않는 한 서비스 인스턴스당 제한이 있습니다.
API 작업, 백 엔드, 태그 등 API 및 API 관련 리소스의 수를 계산할 때 API Management에는 API 버전 및 수정 버전도 포함됩니다.
| Resource | 기본 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 |
| Products | 50 | 200 | 400 |
| Users | 300 | 2,000 | 4,000 |
| Groups | 20 | 100 | 200 |
| 권한 부여 서버 | 10 | 500 | 500 |
| 정책 조각 | 50 | 50 | 100 |
| OpenID Connect 공급자 | 10 | 10 | 20 |
| 인증서 | 100 | 100 | 100 |
| Backends | 100 | 100 | 100 |
| Caches | 100 | 100 | 100 |
| 명명된 값 | 100 | 100 | 100 |
| 로거 | 100 | 100 | 100 |
| Schemas | 100 | 100 | 100 |
| API당 스키마 | 100 | 100 | 100 |
| 태그들 | 100,000 | 100,000 | 100,000 |
| API당 태그 | 500 | 500 | 500 |
| 버전 집합 | 100 | 100 | 100 |
| API당 릴리스 | 100 | 100 | 100 |
| API당 작업 | 200 | 200 | 200 |
| 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 |
| 3단원당 활성 WebSocket 연결 | 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 계층에서 지원되지 않습니다.
Deployment
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 가격 책정에 대해 자세히 알아봅니다.