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