ドライブを一覧表示します。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST /v2/drive/list HTTP/1.1
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| domain_id |
string |
必須 |
||
| body |
object |
任意 |
リクエストボディです。 |
|
| limit |
integer |
任意 |
返されるドライブの最大数。有効値:1~100。デフォルト値:100。 |
100 |
| marker |
string |
任意 |
ページネーションマーカー。指定した場合、クエリはマーカーの次のドライブからアルファベット順に始まります。省略した場合、クエリはリストの先頭から始まります。 |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
| owner |
string |
任意 |
所有者の ID です。省略した場合、すべての所有者のドライブが返されます。 |
c9b7a5aa04d14ae3867fdc886fa01da4 |
| owner_type |
string |
任意 |
所有者タイプです。有効値: user:個人ユーザー 省略した場合、すべての所有者タイプのドライブが返されます。 |
user |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスボディです。 |
||
| items |
array |
ドライブのリストです。 |
|
| Drive |
ドライブ情報です。 |
||
| next_marker |
string |
次のページの結果を取得するためのマーカーです。これ以上結果がない場合、このパラメーターは空になります。 |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
例
成功レスポンス
JSONJSON
{
"items": [
{
"domain_id": "bj1",
"drive_id": "1",
"drive_name": "drv1",
"description": "vipdrive",
"owner": "c9b7a5aa04d14ae3867fdc886fa01da4",
"owner_type": "user",
"drive_type": "normal",
"status": "enabled",
"used_size": 20480,
"total_size": 204800,
"created_at": "2019-08-20T06:51:27.292Z",
"creator": "c9b7a5aa04d14ae3867fdc886fa01da4"
}
],
"next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。