---
title: "노드 스토리지 조회"
slug: "ses-getclusternodestorage"
updated: 2026-09-17T09:16:04Z
published: 2026-09-17T09:16:04Z
canonical: "api.ncloud-docs.com/ses-getclusternodestorage"
---

> ## 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.

# 노드 스토리지 조회

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

Search Engine 클러스터 노드의 스토리지 정보를 조회합니다.

## 요청 <a name="요청"></a>
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| :--- | :--- |
| POST | /api/v2/cluster/getBlockStorage/{computeInstanceNo} (한국 리전) |
| POST | /api/sgn-v2/cluster/getBlockStorage/{computeInstanceNo} (싱가포르 리전) |
| POST | /api/jpn-v2/cluster/getBlockStorage/{computeInstanceNo} (일본 리전) |

### 요청 헤더 <a name="요청헤더"></a>
Search Engine Service API에서 공통으로 사용하는 헤더에 대한 정보는 [Search Engine Service 요청 헤더](/docs/analytics-vpcsearchengine#요청헤더)를 참조해 주십시오.

### 요청 경로 파라미터 <a name="요청경로파라미터"></a>
요청 경로 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입   | 필수 여부 | 설명                                                                                                                  |
| :---- |:-------| :---- |:----------------------------------------------------------------------------------------------------------------------|
| `computeInstanceNo` | String | Required | 노드 인스턴스 번호<ul><li>[노드 목록 조회](/docs/analytics-vpcsearchengine-cluster-getclusternodelist) 참조</li></ul> |

### 요청 예시 <a name="요청예시"></a>
요청 예시는 다음과 같습니다.

```shell
curl --location --request GET 'https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getBlockStorage/1037*****\'
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
```

## 응답 <a name="응답"></a>
응답 형식을 설명합니다.

### 응답 바디 <a name="응답바디"></a>
응답 바디에 대한 설명은 다음과 같습니다.

| 필드                                                  | 타입    | 필수 여부 | 설명                                          |
|:------------------------------------------------------|:--------| :---- |:----------------------------------------------|
| `code`                                                | Integer | - | 응답 코드                                     |
| `message`                                             | String  | - | 응답 메시지                                   |
| `result`                                              | Object  | - | 응답 결과                                     |
| `result.blockStorageList`                             | Array   | - | 스토리지 목록                                 |
| `result.blockStorageList.regionCode`                  | Array   | - | 리전 코드                                     |
| `result.blockStorageList.zoneCode`                    | Array   | - | 존 코드                                     |
| `result.blockStorageList.hypervisorType`              | Array   | - | 하이퍼바이저 유형                             |
| `result.blockStorageList.hypervisorType.code`         | Array   | - | 하이퍼바이저 코드                             |
| `result.blockStorageList.blockStorageType`            | Array   | - | 블록스토리지 유형                             |
| `result.blockStorageList.blockStorageType.code`       | Array   | - | 블록스토리지 유형 코드                        |
| `result.blockStorageList.blockStorageVolumeType`      | Array   | - | 블록스토리지 볼륨 유형                        |
| `result.blockStorageList.blockStorageVolumeType.code` | Array   | - | 블록스토리지 볼륨 유형 코드                   |
| `result.blockStorageList.blockStorageSize`            | Array   | - | 블록스토리지 사이즈                           |
| `result.blockStorageList.maxIopsThroughput`           | Integer | - | 최대 IOPS<ul><li>SSD의 경우에만 의미 있는 값이 할당됨</li></ul>                                                     |
| `result.blockStorageList.isEncryptedVolume`           | Boolean | - | 볼륨 암호화 여부<ul><li>`true` \| `false`</li></ul>                                                              |
| `result.blockStorageList.serverInstanceNo`            | String  | - | 블록 스토리지가 할당된 노드 서버 인스턴스 번호                                                                    |
| `result.blockStorageList.blockStorageInstanceNo`      | String  | - | 블록 스토리지 인스턴스 번호                                                                                      |
| `result.blockStorageList.blockStorageName`            | String  | - | 블록 스토리지 이름                                                                                                |
| `result.blockStorageList.createDate`                  | String  | - | 블록 스토리지 생성 일시(YYYY-MM-DDThh:mm:ssZ 형식)                                                                |
| `requestId` | String  | - | 요청에 대한 아이디<ul><li>UUID 형식</li></ul> |

### 응답 상태 코드 <a name="응답상태코드"></a>
Search Engine Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Search Engine Service 응답 상태 코드](/docs/analytics-vpcsearchengine#응답상태코드)를 참조해 주십시오.

### 응답 예시 <a name="응답예시"></a>
응답 예시는 다음과 같습니다.

```json
{
  "code": 0,
  "message": "SUCCESS",
  "result": {
    "blockStorageList": [
      {
        "regionCode": "KR",
        "zoneCode": "KR-1",
        "hypervisorType": {
          "code": "KVM"
        },
        "blockStorageType": {
          "code": "SVRBS"
        },
        "blockStorageVolumeType": {
          "code": "CB1"
        },
        "blockStorageSize": 107374182400,
        "maxIopsThroughput": null,
        "isEncryptedVolume": false,
        "serverInstanceNo": "100******0",
        "blockStorageInstanceNo": "100*****33",
        "blockStorageName": "b19******c09",
        "createDate": "2026-08-11T18:18:44+0900"
      },
      {
        "regionCode": "KR",
        "zoneCode": "KR-1",
        "hypervisorType": {
          "code": "KVM"
        },
        "blockStorageType": {
          "code": "BASIC"
        },
        "blockStorageVolumeType": {
          "code": "CB1"
        },
        "blockStorageSize": 53687091200,
        "maxIopsThroughput": null,
        "isEncryptedVolume": false,
        "serverInstanceNo": "100******0",
        "blockStorageInstanceNo": "100******31",
        "blockStorageName": "*****hf-d-1fyl",
        "createDate": "2026-08-11T18:18:44+0900"
      }
    ]
  },
  "requestId": "b14****0c-60**-4**1-9eb4-55******2758"
}
```