---
title: "post"
slug: "cli-archivestorage-post"
updated: 2026-09-17T09:16:11Z
published: 2026-09-17T09:16:11Z
canonical: "cli.ncloud-docs.com/cli-archivestorage-post"
---

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

# post

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

어카운트, 컨테이너(버킷) 또는 오브젝트의 메타데이터를 변경합니다. 컨테이너가 존재하지 않는 경우, 자동으로 생성됩니다.

## 구문

`post` 구문은 다음과 같습니다.

- 어카운트

```
swift post \
    [--meta <name:value>] \
    [--header <header:value>]
```
- 컨테이너

```
swift post \
    <container> \
    [--read-acl <acl>] \
    [--write-acl <acl>] \
    [--meta <name:value>] \
    [--header <header:value>]
```
- 오브젝트

```
swift post \
    <container> <object> \
    [--meta <name:value>] \
    [--header <header:value>]
```

## 옵션

`post` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`post`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `&lt;container&gt;` | String | Conditional | 컨테이너 이름 - 미입력 시 어카운트의 메타데이터 변경 - 존재하지 않는 컨테이너를 입력하면 자동 생성 - `&lt;object&gt;` 입력 시 필수 입력 |

### 선택 옵션

`post`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `&lt;object&gt;` | String | Optional | 오브젝트 이름 - `&lt;container&gt;`와 함께 입력 |
| `--read-acl` | String | Optional | 컨테이너의 읽기 ACL - 예시: `.r:*`, `.r:-.example.com`, `.r:www.example.com`, `account1:*`, `account2:user2` - `account1` 형식은 v1.0 인증 API에서만 사용 가능 - 전체 ACL 구문은 [OpenStack Swift CLI 문서](https://docs.openstack.org/ocata/cli-reference/swift.html) 참조 |
| `--write-acl` | String | Optional | 컨테이너의 쓰기 ACL - 예시: `account1:*`, `account2:user2` - `account1` 형식은 v1.0 인증 API에서만 사용 가능 - 전체 ACL 구문은 [OpenStack Swift CLI 문서](https://docs.openstack.org/ocata/cli-reference/swift.html) 참조 |
| `--meta` | String | Optional | 메타데이터 항목 - `name:value` 형식으로 입력 - 다중 메타데이터 설정 가능 (예시: `--meta name1:value1 --meta name2:value2`) |
| `--header` | String | Optional | 요청에 사용할 사용자 정의 헤더 - `header:value` 형식으로 입력 |

### 공통 옵션

`swift` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Archive Storage 옵션](/docs/guide-archivestorage#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

`post` 명령으로 컨테이너를 생성하거나 메타데이터를 설정하는 예시입니다.

### 명령

컨테이너를 생성하는 명령 예시는 다음과 같습니다.

```
swift post test-container-01
```

컨테이너에 메타데이터를 설정하는 명령 예시는 다음과 같습니다.

```
swift post test-container-01 --meta Purpose:Documentation
```

### 출력

요청이 성공하면 출력되는 내용이 없습니다. 변경된 메타데이터는 [stat](/docs/cli-archivestorage-stat)으로 확인할 수 있습니다.