GetAccount

印刷する
共有
PDF

GetAccount

印刷する
共有
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

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の概要を参照

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

パラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`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"
   }
]

<?xml version="1.0" encoding="UTF-8"?>
<account name="AUTH_5942771066a0482bb6aaf7f5bc792b00">
   <container>
      <name>"string"</name>
      <count>"number"</count>
      <bytes>"number"</bytes>
      <last_modified>"string"</last_modified>
   </container>
</account>

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`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

<?xml version="1.0" encoding="UTF-8"?>
<account name="AUTH_5942771066a0482bb6aaf7f5bc792b00">
   <container>
      <name>ncloud-container-0</name>
      <count>0</count>
      <bytes>0</bytes>
      <last_modified>2018-09-11T02:11:35.010250</last_modified>
   </container>
   <container>
      <name>ncloud-container-1</name>
      <count>0</count>
      <bytes>0</bytes>
      <last_modified>2018-09-11T02:11:41.481410</last_modified>
   </container>
</account>

この記事は役に立ちましたか?

What's Next

PostAccount

リクエスト
レスポンス

タグ

Archive Storage