ログイン

オブジェクト一覧取得

Description

指定したコンテナに保存されているオブジェクトの一覧を取得します。

Request URL

Object Storage API

GET /v1/AUTH_{tenantid}/{container}

Request Json

This operation does not accept a request body.

Request Parameters

Parameter Value Style Description
X-Auth-Token トークン header トークンの情報を指定します。
トークンの発行方法は、トークン発行 にてご確認ください。
container コンテナ名 path コンテナ名を指定します。
コンテナ名の確認方法は、コンテナ一覧取得 を実行の上、レスポンス結果から対象コンテナのコンテナ名をご確認ください。
reverse
(Optional)		 true query レスポンスされる並び順を降順にしたい場合に指定します。デフォルトはオブジェクト名の昇順になります。
limit
(Optional)		 表示件数 query 取得する情報の表示件数を指定します。
marker
(Optional)		 任意の文字列 query オブジェクト名の開始文字列を指定します。
指定した文字列から始まるオブジェクト名のデータを確認したい場合に使用します。
end_marker
(Optional)		 任意の文字列 query 開始させたいオブジェクト名の開始文字列の後に来る文字列を指定します。
指定した文字列以前の文字列から始まるオブジェクト名のデータを確認したい場合に使用します。
format
(Optional)		 json
xml
plain		 query レスポンスされる情報の形式を指定します。リクエスト時の「Accept」ヘッダーも指定する形式に揃える必要があります。
prefix
(Optional)		 接頭辞の文字列 query オブジェクトの命名規則で接頭辞を設けている場合や疑似ディレクトリとしてオブジェクト名を設定している場合、その文字列を指定します。
特定の文字列から始まるオブジェクトでフィルターをしたい場合に使用します。
delimiter
(Optional)		 区切り文字列 query 区切り文字列を指定します。
疑似ディレクトリとしてオブジェクト名を設定している場合、「prefix」と併せて使用することで疑似的な階層としてデータを取得できます。

Response Code

Success 

200

Example

Request 

curl -X GET \
-H "Accept: application/json" \
-H "X-Auth-Token: トークン" \
https://object-storage.c3j1.conoha.io/v1/AUTH_テナントID/コンテナ名

Response 

[
	{
		"name": "オブジェクト名",
		"hash": "5604afd60713315c4b1eccfb2c120bc4",
		"bytes": 34,
		"content_type": "application/x-www-form-urlencoded",
		"last_modified": "2023-12-03T04:00:57.327Z"
	}
]

ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。