---
title: "PostAccount"
slug: "storage-archivestorage-postaccount"
tags: ["Archive Storage"]
updated: 2026-09-17T09:58:32Z
published: 2026-09-17T09:58:32Z
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のための2番目の 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-bit文字を使用できます。ただし、ASCII 0-31文字、DEL文字などは除きます。
- メタデータの値は UTF-8でエンコードしてから URLエンコードする必要があります。これは HTTP/1.1の基本的なルールです。

### リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `project_id` | String | Required | プロジェクト ID - プロジェクト IDの確認方法は、[Archive Storageの概要](/docs/ja/storage-archivestorage#%EC%9D%B8%EC%A6%9D)を参照 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

#### メタデータの作成リクエスト

メタデータを作成するリクエストのサンプルコードは次の通りです。

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