---
title: "attachBlockStorageInstance"
slug: "attachblockstorageinstance-1"
updated: 2026-10-22T10:47:05Z
published: 2026-10-22T10:47:05Z
canonical: "api-gov.ncloud-docs.com/attachblockstorageinstance-1"
---

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

# attachBlockStorageInstance

## 개요

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

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| blockStorageInstanceNo | Yes | String |  | - 블록 스토리지 인스턴스 번호 서버 인스턴스에 할당할 블록 스토리지 인스턴스 번호를 결정함 blockStorageInstanceNo는 getBlockStorageInstanceList 액션을 통해 획득 가능 |
| serverInstanceNo | Yes | String |  | - 서버 인스턴스 번호 블록 스토리지 인스턴스가 할당될 서버 인스턴스를 결정함 serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능 |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

- [BlockStorageInstanceList](/docs/common-apidatatype-blockstorageinstancelist)

## 예시

### 요청 예시

```
GET {SERVER_API_URL}/attachBlockStorageInstance
?blockStorageInstanceNo=***1004
&serverInstanceNo=***1003
```

### 응답 예시

```
<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>
```