---
title: "PostAccount"
slug: "storage-archivestorage-postaccount"
tags: ["Archive Storage"]
updated: 2026-11-04T01:52:40Z
published: 2026-11-04T09:00:11Z
canonical: "api.ncloud-docs.com/storage-archivestorage-postaccount"
---

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

# PostAccount

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

어카운트에 메타데이터를 설정하거나 변경합니다.

## 요청

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

| 메서드 | URI |
| --- | --- |
| POST | /v1/AUTH_{project_id} |

### 요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Required | 발급한 토큰(Token) 값 |
| `X-Account-Meta-Temp-URL-Key` | String | Optional | temporary URL을 위한 Secret Key 값 |
| `X-Account-Meta-Temp-URL-Key-2` | String | Optional | temporary URL을 위한 두 번째 Secret Key 값 |
| `X-Account-Meta-name` | String | Optional | 어카운트의 메타데이터 설정 - 헤더명의 `name` 부분이 메타데이터의 키 역할을 함 |
| `X-Remove-Account-name` | String | Optional | 어카운트의 메타데이터 삭제 - 헤더명의 `name` 부분이 메타데이터의 키 역할을 함 |

참고

- `X-Account-Meta-name` 헤더에 빈 값을 입력하면 해당 메타데이터를 삭제합니다.
- 빈 값 헤더를 보내지 못하는 도구에서는 `X-Remove-Account-Meta-name` 헤더로 삭제해 주십시오.

요청 헤더 설정 값에 따른 요청 결과는 다음과 같습니다.

| 요청 헤더 | 결과 |
| --- | --- |
| 요청 헤더에 어카운트 메타데이터의 값이 없고 키만 존재하며, 어카운트에 키는 이미 존재하는 경우 | API는 해당 메타데이터 아이템 삭제 |
| 요청 헤더에 어카운트 메타데이터의 값이 없고 키만 존재하며, 어카운트에 키가 존재하지 않는 경우 | API는 해당 메타데이터 키 무시 |
| 요청 헤더에 어카운트 메타데이터의 키와 값이 모두 존재하며, 어카운트에 키가 이미 존재하는 경우 | API는 해당 메타데이터 업데이트 |
| 요청 헤더에 어카운트 메타데이터의 키와 값이 모두 존재하며, 어카운트에 키가 존재하지 않는 경우 | API는 해당 메타데이터 추가 |
| 요청 헤더에 어카운트 메타데이터들이 생략되어 있고, 어카운트에는 이미 메타데이터들이 존재하는 경우 | API는 이미 존재하는 메타데이터 변경하지 않음 |

참고

- 메타데이터 키는 대소문자를 구분하지 않으며, ASCII 7비트 문자로 구성합니다. ASCII 0~31 문자와 DEL 문자는 쓸 수 없습니다.
  - 밑줄(_)은 하이픈(-)으로 바뀝니다.
  - 자세한 내용은 [HTTP/1.1](https://www.w3.org/Protocols/rfc2616/rfc2616.html)을 참조해 주십시오.
- 메타데이터 값은 UTF-8로 인코딩한 뒤 URL 인코딩해서 입력합니다. 이는 HTTP/1.1 기본 룰입니다.

### 요청 경로 파라미터

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `project_id` | String | Required | 프로젝트 ID - 프로젝트 ID 확인 방법은 [Archive Storage 개요](/docs/storage-archivestorage#%EC%9D%B8%EC%A6%9D) 참조 |
| `bulk-delete` | String | Optional | 여러 오브젝트 및 빈 컨테이너를 한 번에 삭제 - 최대 10,000개까지 요청 가능 - 삭제 대상은 요청 바디에 입력 |

### 요청 예시

요청 예시는 다음과 같습니다.

#### 메타데이터 생성 요청

메타데이터를 생성하는 요청 예시는 다음과 같습니다.

```
curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" 
-H "X-Auth-Token: $token"
-H "X-Account-Meta-{name}: $account-metadata-string"
```

#### 메타데이터 수정 요청

메타데이터를 수정하는 요청 예시는 다음과 같습니다.

```
curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" 
-H "X-Auth-Token: $token"
-H "X-Account-Meta-{name}: $account-metadata-string"
```

#### 메타데이터 삭제 요청

메타데이터를 삭제하는 요청 예시는 다음과 같습니다.

```
curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" 
-H "X-Auth-Token: $token"
-H "X-Remove-Account-Meta-{name}: $account-metadata-string"
```

## 응답

응답 형식을 설명합니다.

### 응답 헤더

Archive Storage API에서 공통으로 사용하는 응답 헤더에 대한 자세한 내용은 [Archive Storage 공통 응답 헤더](/docs/storage-archivestorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 응답 예시

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

#### 메타데이터 생성을 요청한 경우의 응답

메타데이터 생성을 요청했을 때의 응답 예시는 다음과 같습니다.

```
HTTP/1.1 204 No Content
Content-Type: text/html; charset=UTF-8
Content-Length: 0
X-Trans-Id: txad3702ae436640d1a9897-005b975c51
X-Openstack-Request-Id: txad3702ae436640d1a9897-005b975c51
Date: Tue, 11 Sep 2018 06:10:25 GMT
```

#### 메타데이터 수정을 요청한 경우의 응답

메타데이터 수정을 요청했을 때의 응답 예시는 다음과 같습니다.

```
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txc5a65e1d20074023912c6-005b975c97
X-Openstack-Request-Id: txc5a65e1d20074023912c6-005b975c97
Date: Tue, 11 Sep 2018 06:11:35 GMT
```

#### 메타데이터 삭제를 요청한 경우의 응답

메타데이터 삭제를 요청했을 때의 응답 예시는 다음과 같습니다.

```
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txf2874df785bd470eaf3b8-005b975d40
X-Openstack-Request-Id: txf2874df785bd470eaf3b8-005b975d40
Date: Tue, 11 Sep 2018 06:14:24 GMT
```