setQuota

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

GeoLocation API 호출 한도 유형 및 월별 최대 호출 건수를 설정합니다. 설정이 반영되기까지 약 1분이 소요됩니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /quota

요청 헤더

GeoLocation API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 GeoLocation 요청 헤더를 참조해 주십시오.

요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
quota String Required 설정하고 싶은 한도 유형 및 월별 최대 호출 건수
  • 한도를 무제한으로 설정하고 싶으면 unlimit 입력
  • 월별 사용 한도를 제한하고 싶으면 최대 호출 건수 입력

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://geolocation.apigw.ntruss.com/geolocation/v2/quota
?quota=100'
--header 'x-ncp-apigw-timestamp: {Timestamp}'
--header 'x-ncp-iam-access-key: {Access Key}'
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

응답

응답 형식을 설명합니다.

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다. 네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Ncloud API 응답 상태 코드를 참조해 주십시오.

HTTP 상태 코드 코드 메시지 설명
204 - OK (No Content) 요청 성공
400 131001 Invalid Quota 한도 설정이 잘못됨
400 131002 Internal Server Error GeoLocation 서버 오류
  • 해결 방법: 잠시 후 다시 시도하거나 문제가 지속될 경우에는 고객 지원으로 문의
400 131004 Subscription Required GeoLocation 서비스 이용 신청 필요
  • 해결 방법: 네이버 클라우드 플랫폼 콘솔의 Services > Application Services > GeoLocation > Subscription 메뉴에서 이용 신청
404 - Not Found 리소스를 찾지 못함
500 - Internal Server Error 내부 서버 오류

응답 예시

응답 예시는 다음과 같습니다.

정상 응답

HTTP Status : 204

오류 응답

{
    "error": {
        "errorCode": 130001,
        "message": "Invalid Quota",
        "details": null
    }
}