--- title: "리소스 이용 한도 조회" slug: "organization-get-policy-allotment" tags: ["Organization"] updated: 2026-09-17T09:16:35Z published: 2026-09-17T09:16:35Z canonical: "api.ncloud-docs.com/organization-get-policy-allotment" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 리소스 이용 한도 조회 Classic/VPC 환경에서 이용 가능합니다. 계정에 적용된 리소스별 이용 한도를 조회합니다. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET | /open-api/v1/policy/allotment/{memberNo}/{regionNo} | ### 요청 헤더 Organization API에서 공통으로 사용하는 헤더에 대한 정보는 [Organization 요청 헤더](/docs/organization-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 요청 경로 파라미터 요청 경로 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `memberNo` | Integer | Required | 계정 회원 번호 - [계정 목록 조회](/docs/organization-get-account-group) 참조 | | `regionNo` | String | Required | 리전 번호 - [리전 목록 조회](/docs/organization-get-policy-region) 참조 | ### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://organization.apigw.ntruss.com/open-api/v1/policy/allotment/260****/1' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \ --header 'Accept: application/json' ``` ## 응답 응답 형식을 설명합니다. ### 응답 바디 응답 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `resourceTypeCode` | String | - | 리소스 코드 | | `resourceName` | String | - | 리소스 이름 | | `customResourceName` | String | - | 리소스 이름 - 일반적으로 `resourceName` 값과 동일 - 일부 리소스의 경우, `resourceName`과 달리 계층 정보를 포함 | | `lowerResourceName` | String | - | 하위 리소스 이름 | | `resourceCategoryTypeCode` | String | - | 리소스 카테고리 코드 | | `resourceQuotaDetailConfigYn` | String | - | 리소스 상세 설정 필요 여부 - `Y` \| `N` - `Y`: 필요 - `N`: 필요 없음 | | `sortOrder` | Integer | - | 목록 정렬 순서 | | `useYn` | String | - | 리소스 사용 여부 - `Y` \| `N` - `Y`: 사용 가능 - `N`: 사용 불가 | | `exposureYn` | String | - | 리소스 노출 여부 - `Y` \| `N` - `Y`: 노출 - `N`: 비노출 | | `restrictionUnitCode` | String | - | 이용 한도 단위 코드 | | `restrictionUnitDescription` | String | - | 이용 한도 단위 코드 설명 | | `resourceQuotaList` | Array | - | 리소스 이용 한도: [resourceQuotaList](/docs/organization-get-policy-allotment#resourceQuotaList) | | `resourceQuotaDetailList` | Array | - | 리소스 유형 이용 한도: [resourceQuotaDetailList](/docs/organization-get-policy-allotment#resourceQuotaDetailList) - `resourceQuotaDetailConfigYn` 값이 `N`인 경우, 빈 값 `[]`으로 표시 | #### `resourceQuotaList` `resourceQuotaList`에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `policyNo` | String | - | 정책 번호 | | `resourceQuotaSequence` | String | - | 이용 한도 일련 번호 | | `regionNo` | String | - | 리전 번호 | | `resourceTypeCode` | String | - | 리소스 코드 | | `restrictionCount` | Integer | - | 이용 한도 | #### `resourceQuotaDetailList` `resourceQuotaDetailList`에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `policyNo` | String | - | 정책 번호 | | `resourceQuotaSequence` | String | - | 이용 한도 일련 번호 | | `regionNo` | String | - | 리전 번호 | | `resourceTypeCode` | String | - | 리소스 코드 | | `infraResourceDetailTypeCode` | String | - | 서비스 유형 코드 | | `infraResourceDetailTypeName` | String | - | 서비스 유형 | | `productTypeDetailCode` | String | - | 리소스 상세 유형 코드 | | `productTypeDetailCodeName` | String | - | 리소스 상세 유형 | | `generationCode` | String | - | 세대 구분 코드 - 서버 외 리소스는 `-` 표시 | | `restrictionCount` | Integer | - | 이용 한도 | | `usedCount` | Integer | - | 사용된 한도 | | `toBeCount` | Integer | - | 잔여 한도 | | `endOfService` | Boolean | - | 이용 한도 | Organization API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Organization 응답 상태 코드](/docs/organization-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. ``` [ { "resourceTypeCode": "SVR", "resourceName": "Server", "customResourceName": "Server", "lowerResourceName": null, "resourceCategoryTypeCode": "COMPUTE", "resourceQuotaDetailConfigYn": "Y", "sortOrder": 1, "useYn": "Y", "exposureYn": "Y", "restrictionUnitCode": "COUNT", "restrictionUnitDescription": "Server 생성 수", "resourceQuotaList": [ { "policyNo": "1", "resourceQuotaSequence": "18", "regionNo": "1", "resourceTypeCode": "SVR", "restrictionCount": 50 } ], "resourceQuotaDetailList": [ { "policyNo": "1", "resourceQuotaSequence": "18", "regionNo": "1", { "policyNo": "1", "resourceQuotaSequence": "18", "resourceQuotaDetailSequence": "1", "resourceTypeCode": "SVR", "regionNo": "1", "infraResourceDetailTypeCode": "BM", "infraResourceDetailTypeName": "BareMetal", "productTypeCode": "CPU", "productTypeCodeName": "CPU Intensive", "generationCode": "G1", "restrictionCount": 5, "endOfService": false }, { "policyNo": "1", "resourceQuotaSequence": "18", "resourceQuotaDetailSequence": "2", "resourceTypeCode": "SVR", "regionNo": "1", "infraResourceDetailTypeCode": "VM", "infraResourceDetailTypeName": "VM", "productTypeCode": "CPU", "productTypeCodeName": "CPU Intensive", "generationCode": "G1", "restrictionCount": 5, "endOfService": false }, "resourceTypeCode": "PBLIP", "resourceName": "Public IP", "customResourceName": "Public IP", "lowerResourceName": null, "resourceCategoryTypeCode": "COMPUTE", "resourceQuotaDetailConfigYn": "N", "sortOrder": 12, "useYn": "Y", "exposureYn": "Y", "restrictionUnitCode": "REL_COUNT", "restrictionUnitDescription": "Public IP 생성 수", "resourceQuotaList": [ { "policyNo": null, "resourceQuotaSequence": null, "regionNo": "1", "resourceTypeCode": "PBLIP", "restrictionCount": 100 } ], "resourceQuotaDetailList": [] }, ... ] ```