setQuota
    • PDF

    setQuota

    • PDF

    기사 요약

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

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

    요청

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

    메서드URI
    POST/quota

    요청 헤더

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

    요청 쿼리 파라미터

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

    필드타입필수 여부설명
    quotaStringRequired설정하고 싶은 한도 유형 및 월별 최대 호출 건수
    • 한도를 무제한으로 설정하고 싶으면 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)요청 성공
    400131001Invalid Quota한도 설정이 잘못됨
    400131002Internal Server ErrorGeoLocation 서버 오류
    • 해결 방법: 잠시 후 다시 시도하거나 문제가 지속될 경우에는 고객 지원으로 문의
    400131004Subscription RequiredGeoLocation 서비스 이용 신청 필요
    • 해결 방법: 네이버 클라우드 플랫폼 콘솔의 Services > Application Services > GeoLocation > Subscription 메뉴에서 이용 신청
    404-Not Found리소스를 찾지 못함
    500-Internal Server Error내부 서버 오류

    응답 예시

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

    정상 응답

    HTTP Status : 204
    

    오류 응답

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

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.