---
title: "post"
slug: "cli-archivestorage-post"
updated: 2026-10-08T09:45:39Z
published: 2026-10-08T09:45:39Z
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/ja/guide-archivestorage#%EC%98%B5%EC%85%98)をご参照ください。

## 例

`post`コマンドを使用してコンテナを作成したり、メタデータを設定したりする例です。

### コマンド

コンテナを作成するコマンドの例は次の通りです。

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

コンテナにメタデータを設定するコマンドの例は次の通りです。

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

### 出力

リクエストが成功すると、出力される内容はありません。変更後のメタデータは[stat](/docs/ja/cli-archivestorage-stat)で確認できます。