---
title: "attachBlockStorageInstance"
slug: "cli-server-attachblockstorageinstance"
updated: 2026-05-21T09:02:03Z
published: 2026-05-21T09:11:32Z
canonical: "cli-gov.ncloud-docs.com/cli-server-attachblockstorageinstance"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# attachBlockStorageInstance

## 개요<a name="개요"></a>

블록 스토리지 인스턴스 할당

## 설명 <a name="설명"></a>

블록 스토리지 인스턴스를 서버 인스턴스에 할당합니다.

## 요청 파라미터 <a name="요청파라미터"></a>

| 파라미터   명           | 필수   여부 | 타입   | 제약사항             | 설명                                                         |
| ----------------------- | ----------- | ------ | -------------------- | ------------------------------------------------------------ |
| blockStorageInstanceNo | Yes | String |  | - 블록 스토리지 인스턴스 번호<br/>서버 인스턴스에 할당할 블록 스토리지 인스턴스 번호 결정<br/> blockStorageInstanceNo는 getBlockStorageInstanceList 액션을 통해서 획득 가능 |
| serverInstanceNo | Yes | String |  | - 서버 인스턴스 번호<br/>블록 스토리지 인스턴스가 할당될 서버 인스턴스 결정<br/>serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능 |

## 응답 데이터 타입 <a name="응답데이터타입"></a>
- BlockStorageInstanceList 타입

| BlockStorageInstanceList extends CommonResponse |
| ---------------------------------------- |
| private Integer totalRows; |
| private List<BlockStorageInstance> blockStorageInstanceList = new ArrayList<BlockStorageInstance>(); |

| BlockStorageInstance |
| ------------------------------------------------- |
| private String blockStorageInstanceNo; |
| private String serverInstanceNo; |
| private String serverName; |
| private CommonCode blockStorageType; |
| private String blockStorageName; |
| private Long blockStorageSize; |
| private String deviceName; |
| private String blockStorageProductCode; |
| private CommonCode blockStorageInstanceStatus; |
| private CommonCode blockStorageInstanceOperation; |
| private String blockStorageInstanceStatusName; |
| private Date createDate; |
| private String blockStorageInstanceDescription; |
| private CommonCode diskType; |
| private CommonCode diskDetailType; |
| private Integer maxIopsThroughput; |
| private Region region; |
| private Zone zone; |

## 예시 <a name="예시"></a>

### 호출 <a name="호출"></a>

```
ncloud server attachBlockStorageInstance --blockStorageInstanceNo ***1004 --serverInstanceNo ***1003
```

### 응답 <a name="응답"></a>
 
```json
{
  "attachBlockStorageInstanceResponse": {
    "requestId": "c8172d4a-5486-4d34-9331-dfec6a747abf",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "blockStorageInstanceList": [
      {
        "blockStorageInstanceNo": "***1004",
        "serverInstanceNo": "***1003",
        "serverName": "test-***",
        "blockStorageType": {
          "code": "SVRBS",
          "codeName": "Server BS"
        },
        "blockStorageName": "test-***",
        "blockStorageSize": 53687091200,
        "deviceName": "",
        "blockStorageProductCode": "SPBSTBSTAD000006",
        "blockStorageInstanceStatus": {
          "code": "CREAT",
          "codeName": "Block storage CREATED state"
        },
        "blockStorageInstanceOperation": {
          "code": "ATTAC",
          "codeName": "Block Storage  STOP OP"
        },
        "blockStorageInstanceStatusName": "attaching",
        "createDate": "2018-10-22T16:19:51+0900",
        "blockStorageInstanceDescription": "",
        "diskType": {
          "code": "NET",
          "codeName": "Network Storage"
        },
        "diskDetailType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "maxIopsThroughput": 4000,
        "region": {
          "regionNo": "1",
          "regionCode": "KR",
          "regionName": "KOREA"
        },
        "zone": {
          "zoneNo": "2",
          "zoneName": "KR-1",
          "zoneCode": "KR-1",
          "zoneDescription": "KR-1 zone",
          "regionNo": "1"
        }
      }
    ]
  }
}
```
```xml
<?xml version="1.0" encoding="UTF-8" ?>
<attachBlockStorageInstanceResponse>
  <requestId>c8172d4a-5486-4d34-9331-dfec6a747abf</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageInstanceList>
    <blockStorageInstance>
      <blockStorageInstanceNo>***1004</blockStorageInstanceNo>
      <serverInstanceNo>***1003</serverInstanceNo>
      <serverName>test-***</serverName>
      <blockStorageType>
        <code>SVRBS</code>
        <codeName>Server BS</codeName>
      </blockStorageType>
      <blockStorageName>test-***</blockStorageName>
      <blockStorageSize>53687091200</blockStorageSize>
      <deviceName></deviceName>
      <blockStorageProductCode>SPBSTBSTAD000006</blockStorageProductCode>
      <blockStorageInstanceStatus>
        <code>CREAT</code>
        <codeName>Block storage CREATED state</codeName>
      </blockStorageInstanceStatus>
      <blockStorageInstanceOperation>
        <code>ATTAC</code>
        <codeName>Block Storage STOP OP</codeName>
      </blockStorageInstanceOperation>
      <blockStorageInstanceStatusName>attaching</blockStorageInstanceStatusName>
      <createDate>2018-10-22T16:19:51+0900</createDate>
      <blockStorageInstanceDescription></blockStorageInstanceDescription>
      <diskType>
        <code>NET</code>
        <codeName>Network Storage</codeName>
      </diskType>
      <diskDetailType>
        <code>SSD</code>
        <codeName>SSD</codeName>
      </diskDetailType>
      <maxIopsThroughput>4000</maxIopsThroughput>
      <region>
        <regionNo>1</regionNo>
        <regionCode>KR</regionCode>
        <regionName>KOREA</regionName>
      </region>
      <zone>
        <zoneNo>2</zoneNo>
        <zoneName>KR-1</zoneName>
        <zoneCode>KR-1</zoneCode>
        <zoneDescription>KR-1 zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </blockStorageInstance>
  </blockStorageInstanceList>
</attachBlockStorageInstanceResponse>
```