Show Container and Account Usage Statistics#

アカウントの詳細とコンテナリストを表示します。

APIエンドポイント#

リージョン	APIエンドポイント
西日本リージョン3の場合	https://objectstorage.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合	https://objectstorage.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI#

GET

/v2/{account}

HTTPステータスコード#

正常時：200,204

エラー時：400,401,403,404,405,409,411,412,416,422,500,501

リクエストパラメータの説明#

名前	In	Type	デフォルト値 /必須指定	Description
X-Auth-Token	header	string	必須	認証トークン
account	path	string	必須	プロジェクト単位でユニークに割り当てられる名前 AUTH_<プロジェクトID>
delimiter	query	string	任意	コンテナ名をネスト表示するためのデリミタ
limit	query	integer	任意	一度に取得できるコンテナの最大数取得したコンテナの数が、limitパラメータで指定した値より少ない場合、リストは最後まで取得されています。取得したコンテナの数が、limitパラメータで指定した値と等しい場合、リストにはまだ未取得のコンテナが残っています。
marker	query	string	任意	指定した文字列より後のコンテナ名一覧を返却します。
end_marker	query	string	任意	指定した文字列より前のコンテナ名一覧を返却します。
format	query	string	任意	レスポンスのフォーマット「json」、「xml」、「plain」から選択できます。デフォルトは「plain」です。 format=xmlまたはformat=jsonをクエリパラメータに追加すると、コンテナ名だけでなく、コンテナの詳細情報を含む結果を取得します。 format=plainをクエリパラメータに指定すると、改行区切りでコンテナ名の一覧を取得します。
prefix	query	string	任意	この文字列から始まるコンテナの一覧を返却します。

レスポンスヘッダーの説明#

名前	Type	Description
Date	string	トランザクションが実行された日時
Content-Type	string	オブジェクトのMIME typeの種類
Content-Length	string	レスポンスボディのバイト数
Connection	string	持続接続の状態を表示します。
X-Trans-Id	string	このリクエストに付与されるID トラブルについて問い合わせる際に利用されます。
Accept-Ranges	string	リクエストの応答サイズの形式
X-Account-Bytes-Used	integer	アカウントがオブジェクトストレージに格納したオブジェクトの合計バイト数
X-Account-Container-Count	integer	コンテナの総数
X-Account-Object-Count	integer	アカウント内オブジェクトの総数
X-Account-Project-Domain-Id	string	ドメインID
X-Timestamp	integer	リクエストを処理した時刻（UNIX Epoch秒表示）
X-Fcx-Endpoint-Request	string	APIエンドポイントとしてリクエストを受け付けたことを示す番号

レスポンスボディ（正常系）の説明#

名前	Type	Description
count	integer	コンテナが保有するオブジェクト数
bytes	integer	コンテナが保有するオブジェクト数の総サイズ
name	string	コンテナ名

リクエスト例#

curl -i $publicURL?format=json -X GET -H "X-Auth-Token: $token"

レスポンス例#

HTTP/1.1 200 OK
Date: Tue, 05 Jun 2018 07:13:32 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 163
Connection: keep-alive
X-Trans-Id: 2485623817
Accept-Ranges: bytes
X-Account-Bytes-Used: 102401
X-Account-Container-Count: 3
X-Account-Object-Count: 2
X-Account-Project-Domain-Id: default
X-Timestamp: 1526602707.000000
X-Fcx-Endpoint-Request: EXECUTED_api2-rmp1.test.local-29229-12209-1_200

[
    {
      "count": 0, 
      "bytes": 0, 
      "name": "test-container"
    },
    {
      "count": 0, 
      "bytes": 0, 
      "name": "test-container2"
    },
    {
      "count": 2, 
      "bytes": 102401, 
      "name": "test-container3"
    }
]