--- title: "GetAccount" slug: "storage-archivestorage-getaccount" updated: 2026-09-17T09:58:32Z published: 2026-09-17T09:58:32Z canonical: "api.ncloud-docs.com/storage-archivestorage-getaccount" --- > ## 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. # GetAccount Classic/VPC環境で利用できます。 アカウントに属するコンテナ(バケット)リストとメタデータを照会します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET | /v1/AUTH_{project_id} | ### リクエストヘッダ ヘッダの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `X-Auth-Token` | String | Required | 発行したトークン(Token)の値 | | `X-Newest` | Boolean | Optional | 最新のコピー情報でレスポンスするかどうかを設定 - `true` \| `false` - `true`: すべてのコピーに対してクエリを行い、最新のコピー情報でレスポンス - ヘッダが省略された場合、レスポンスが最も早い情報でレスポンス | | `Accept` | String | Optional | 呼び出し結果の形式を指定 - `application/json` \|`application/xml` \|`text/xml` | ### リクエストパスパラメータ パラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `project_id` | String | Required | プロジェクト ID - プロジェクト IDの確認方法は、[Archive Storageの概要](/docs/ja/storage-archivestorage#%EC%9D%B8%EC%A6%9D)を参照 | ### リクエストクエリパラメータ パラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `limit` | Integer | Optional | 呼び出し結果の最大数制限 | | `marker` | String | Optional | 特定のコンテナ(バケット)以降のリストを返す | | `end_marker` | String | Optional | 特定のコンテナ(バケット)以前のリストを返す | | `format` | String | Optional | 呼び出しの形式を指定(json、xml、plain) | | `prefix` | String | Optional | この文字列で始まるコンテナ(バケット)リストを返す | | `delimiter` | String | Optional | この文字列を区切り文字として使用し、コンテナ(バケット)リストを階層構造で表現 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 #### formatクエリパラメータなしでリクエスト `format`クエリパラメータなしでリクエストするサンプルコードは次の通りです。 ``` curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}" -H "X-Auth-Token: $token" ``` #### formatクエリパラメータを JSONでリクエスト `format`クエリパラメータを JSONでリクエストするサンプルコードは次の通りです。 ``` curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}?format=json" -H "X-Auth-Token: $token" ``` #### formatクエリパラメータを XMLでリクエスト `format`クエリパラメータを JSONでリクエストするサンプルコードは次の通りです。 ``` curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}?format=xml" -H "X-Auth-Token: $token" ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスヘッダ ヘッダの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `Content-Type` | String | - | レスポンス結果の MIMEタイプ | | `X-Account-Container-Count` | Integer | Optional | アカウントにあるのコンテナ(バケット)の総数 | | `X-Account-Object-Count` | integer | Optional | アカウントのオブジェクトの総数 | | `X-Account-Bytes-Used` | Integer | Optional | アカウントが使用する全容量(Byte) | | `X-Timestamp` | Integer | - | アカウントが作成された時刻(Unix Timestamp) | | `X-Account-Storage-Policy-name-Container-Count` | Integer | - | ヘッダ名の`name`に該当する storage policyのコンテナ(バケット)の総数 | | `X-Account-Storage-Policy-name-Object-Count` | Integer | - | ヘッダ名の`name`に該当する storage policyのオブジェクトの総数 | | `X-Account-Storage-Policy-name-Bytes-Used` | Integer | - | ヘッダ名の`name`に該当する storage policyの全容量(Byte) | | `X-Account-Meta-Quota-Bytes` | String | Optional | アカウントの容量制限(Byte) | | `X-Account-Meta-name` | String | - | アカウントのメタデータ - ヘッダ名の`name`部分がメタデータのキーの役割を果たす | | `X-Account-Meta-Temp-URL-Key` | String | - | temporary URLのための Secret Key値 | | `X-Account-Meta-Temp-URL-Key-2` | String | - | temporary URLのための2番目の Secret Key値 | | `Accept-Ranges` | String | - | アカウントが対応する Rangeタイプ | | `Content-Length` | String | - | レスポンス結果の長さ(Byte) | | `x-account-project-domain-id` | String | - | API利用時に必要な Domain ID | | `X-Trans-Id` | String | - | リクエストのトランザクション ID | | `X-Openstack-Request-Id` | String | - | リクエストのトランザクション ID - X-Trans-Idと同じ | | `Date` | String | - | リクエストのレスポンスタイム(UTC) | ### レスポンス構文 レスポンス構文は次の通りです。 formatクエリパラメータなしでリクエストした場合、コンテナ(バケット)に属するオブジェクトの名前だけ plainテキスト形式で返します。 ``` "string" ``` ``` [ { "count": "number", "last_modified":"string", "bytes": "number", "name":"string" } ] ``` ``` "string" "number" "number" "string" ``` ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `count` | Integer | - | コンテナにあるオブジェクト数 | | `bytes` | Integer | - | コンテナにあるオブジェクトの全容量(Byte) | | `name` | String | - | コンテナの名前 | | `last_modified` | String | - | 最終更新日時 | ### レスポンスステータスコード レスポンスステータスコードを紹介します。 | HTTPステータスコード | コード | メッセージ | 説明 | | --- | --- | --- | --- | | 200 | - | OK | リクエスト成功 | | 204 | - | No Content | Content-Typeが`plain`で、リクエストに該当する内容がない場合に発生 | ### レスポンス例 レスポンスのサンプルコードは次の通りです。 #### formatクエリパラメータなしでリクエストした場合のレスポンス `format`クエリパラメータなしでリクエストした場合、レスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Content-Length: 38 Accept-Ranges: bytes X-Timestamp: 1535685069.28154 X-Account-Bytes-Used: 0 X-Account-Container-Count: 2 Content-Type: text/plain; charset=utf-8 X-Account-Object-Count: 0 x-account-project-domain-id: default X-Trans-Id: tx928992622dd248ee9b3e8-005b972569 X-Openstack-Request-Id: tx928992622dd248ee9b3e8-005b972569 Date: Tue, 11 Sep 2018 02:16:09 GMT ``` ``` ncloud-container-0 ncloud-container-1 ``` #### formatクエリパラメータを JSONでリクエストした場合のレスポンス `format`クエリパラメータを JSONでリクエストした場合、レスポンスのサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Content-Length: 206 Accept-Ranges: bytes X-Timestamp: 1535685069.28154 X-Account-Bytes-Used: 0 X-Account-Container-Count: 2 Content-Type: application/json; charset=utf-8 X-Account-Object-Count: 0 x-account-project-domain-id: default X-Trans-Id: txddbf20f97d1043128d032-005b97260f X-Openstack-Request-Id: txddbf20f97d1043128d032-005b97260f Date: Tue, 11 Sep 2018 02:18:55 GMT ``` ``` [ { "count":0, "last_modified":"2018-09-11T02:11:35.010250", "bytes":0, "name":"ncloud-container-0" }, { "count":0, "last_modified":"2018-09-11T02:11:41.481410", "bytes":0, "name":"ncloud-container-1" } ] ``` #### formatクエリパラメータを XMLでリクエストした場合のレスポンス `format`クエリパラメータを JSONでリクエストするサンプルコードは次の通りです。 ``` HTTP/1.1 200 OK Content-Length: 392 Accept-Ranges: bytes X-Timestamp: 1535685069.28154 X-Account-Bytes-Used: 0 X-Account-Container-Count: 2 Content-Type: application/xml; charset=utf-8 X-Account-Object-Count: 0 x-account-project-domain-id: default X-Trans-Id: tx1a6fca0d191645c186b35-005b9726d3 X-Openstack-Request-Id: tx1a6fca0d191645c186b35-005b9726d3 Date: Tue, 11 Sep 2018 02:22:11 GMT ``` ``` ncloud-container-0 0 0 2018-09-11T02:11:35.010250 ncloud-container-1 0 0 2018-09-11T02:11:41.481410 ```