Azure Data Manager for Agriculture에 대한 API 제한 지침
제한은 특정 시간 범위의 서비스 요청 수를 제한하여 과도한 리소스 사용을 방지합니다. Azure Data Manager for Agriculture의 REST API 제한을 사용하면 서비스 API를 호출하는 고객이 일정 기간 내에 보다 일관된 성능을 얻을 수 있습니다.
Azure Data Manager for Agriculture는 대량의 요청을 처리할 수 있습니다. 소수의 고객으로부터 엄청난 수의 요청이 발생하는 경우 제한은 모든 고객에게 최적의 성능과 안정성을 유지하는 데 도움이 됩니다.
제한 제한은 선택한 버전 및 고객이 사용 중인 제품의 기능에 따라 달라집니다. Azure Data Manager for Agriculture은 다음과 같은 두 가지 고유한 버전을 지원합니다.
- 표준: 일반적으로 권장되는 버전입니다.
- 기본: 프로토타입 요구 사항에 적합합니다.
이러한 한도는 갑작스러운 트래픽 급증을 방지하기 위해 세 가지 기간(1분당, 5분당, 1개월당) 내에서 작동합니다.
이 문서에서는 한도에 도달하기 전에 남아 있는 요청 수를 추적하는 방법과 한도에 도달했을 때 응답하는 방법을 보여 줍니다. 제한 사항은 이러한 API에 적용됩니다.
API 분류
Azure Data Manager for Agriculture API는 다음 세 가지 주요 범주로 분류됩니다.
- 쓰기 작업: 데이터 변경을 위해
PATCH,POST및DELETE와(과) 같은 REST API 메서드를 사용하는 API입니다. - 읽기 작업: REST API 메소드 유형
GET을(를) 사용하여 메소드 유형POST의 검색 API를 포함한 데이터를 검색하는 API. - 장기 실행 작업: REST API 메서드 유형
PUT을(를) 사용하는 장기 실행 비동기 작업 API.
다음 표에 설명된 대로 사용 가능한 전체 할당량 단위는 이러한 범주 간에 공유됩니다. 예를 들어, 쓰기 작업에 대한 전체 할당량을 사용한다는 것은 다른 작업에 대한 남은 할당량이 없음을 의미합니다. 각 작업은 특정 할당량 단위를 사용하므로 추가 사용을 위해 나머지 할당량을 추적하는 데 도움이 됩니다.
| 연산 | 각 요청의 단위 비용 |
|---|---|
| 쓰기 | 5 |
| 읽음 | 1 1 |
| 장기 실행 작업: 솔루션 유추 | 5 |
| 장기 실행 작업: 농장 작업 | 5 |
| 장기 실행 작업: 이미지 래스터화 | 2 |
| 장기 실행 작업: 엔터티의 연속 삭제 | 2 |
| 장기 실행 작업: 날씨 수집 | 1 |
| 장기 실행 작업: 위성 수집 | 1 |
1두 개 이상의 항목이 검색되는 경우 응답으로 반환된 각 항목에 대해 추가 단위 비용이 고려됩니다.
기본 버전에 대한 API 제한
다음 표에서는 기본 버전의 범주당 사용 가능한 총 단위를 나열합니다.
| 연산 | 제한 기간 | 단위는 각 기간 이후에 다시 설정됩니다. |
|---|---|---|
| 쓰기/읽기 | 1분당 | 25,000 |
| 쓰기/읽기 | 5분당 | 100,000 |
| 쓰기/읽기 | 1개월당 | 5,000,000 |
| 장기 실행 작업 | 5분당 | 1000 |
| 장기 실행 작업 | 1개월당 | 100,000 |
표준 버전에 대한 API 제한
표준 버전은 기본 버전에 비해 매월 API 할당량이 5배 증가합니다. 다른 모든 할당량 한도는 변경되지 않은 상태로 유지됩니다.
다음 표에서는 표준 버전의 범주당 사용 가능한 총 단위를 나열합니다.
| 연산 | 제한 기간 | 단위는 각 기간 이후에 다시 설정됩니다. |
|---|---|---|
| 쓰기/읽기 | 1분당 | 25,000 |
| 쓰기/읽기 | 5분당 | 100,000 |
| 쓰기/읽기 | 1개월당 | 25,000,000 1 |
| 장기 실행 작업 | 5분당 | 1000 |
| 장기 실행 작업 | 1개월당 | 500,000 1 |
1이 제한은 기본 버전 제한의 5배입니다.
오류 코드
한도에 도달하면 HTTP 상태 코드 429 너무 많은 요청이 표시됩니다. 응답에는 Retry-After 값이 포함되며 이는 애플리케이션이 다음 요청을 보낼 때까지 대기(또는 절전)하는 시간(초)을 지정합니다.
다시 시도 값이 경과하기 전에 요청을 보내면 요청이 처리되지 않고 새 다시 시도 값이 반환됩니다. 지정된 시간이 경과한 후 Azure Data Manager for Agriculture에 다시 요청할 수 있습니다. TCP 연결을 설정하려고 시도하거나 다른 사용자 인증 방법을 사용해도 이러한 제한은 각 테넌트에 따라 다르므로 무시할 수 없습니다.
자주 묻는 질문
분당 시간 범위 내에서 쓰기 작업에 대해 할당된 API 할당량을 모두 사용하는 경우 동일한 시간 범위 내에서 읽기 작업을 성공적으로 요청할 수 있나요?
할당량 한도는 나열된 작업 범주 간에 공유됩니다. 쓰기 작업에 전체 할당량을 사용한다는 것은 다른 작업에 남은 할당량이 없음을 의미합니다. 이 문서에서는 각 작업에 사용되는 특정 할당량 단위를 자세히 설명합니다.
특정 기간 동안 허용된 성공한 요청의 총 수를 어떻게 계산할 수 있나요?
허용되는 총 성공한 API 요청 수는 프로비저닝한 버전과 요청을 수행하는 기간에 따라 다릅니다.
예를 들어, 표준 버전을 사용하면 1분 기간 내에 25,000(각 기간 후 다시 설정되는 단위) / 5(각 요청에 대한 단위 비용) = 5,000개의 쓰기 작업 API를 만들 수 있습니다. 또는 4,000개의 쓰기 작업과 5,000개의 읽기 작업을 조합하여 4,000 * 5 + 5,000 * 1 = 25,000의 총 사용 단위를 생성할 수 있습니다.
마찬가지로 기본 버전의 경우 한 달 기간 내에 5,000,000(각 기간 후 다시 설정되는 단위) / 1(각 요청에 대한 단위 비용) = 5,000,000개의 읽기 작업 API를 수행할 수 있습니다.
고객이 수집할 수 있는 센서 이벤트는 최대 몇 개인가요?
시스템에서는 시간당 최대 100,000개의 이벤트 수집을 허용합니다. 새 이벤트는 지속적으로 수락되지만 처리가 지연될 수 있습니다. 지연은 수집과 함께 실시간 송신 시나리오에서 이러한 이벤트를 즉시 사용할 수 없음을 의미할 수 있습니다.