ConoHa API Documantation

アカウント一覧取得 - Database API v1

Description
サービスのアカウント一覧を取得します。

Request URL

Database API v1.0

GET /v1/users

Request Paramters

Parameter Value Style Type Description
X-Auth-Token - header string Userトークン
service_id(Optional) - query UUID サービスID 未指定の場合はテナントに紐づくすべてのユーザーを返却
offset(Optional) - query int 取得開始位置 Default:0
limit(Optional) - query int 取得数 Default:1000
sort_key(Optional) user_name/hostname/status/create_date/memo query string ソートキー Default:create_date
sort_type(Optional) asc/desc query string ソート順 Default:asc

Response Paramters

Parameter Value Style Type Description
users - - list -
databases - plain list 権限付与したデータベース情報
database_id - plain UUID データベースID
db_name - plain string データベース名
service_id - plain UUID サービスID
hostname - plain string 接続許可ホスト名
memo - plain string メモ
user_id - plain UUID ユーザーID
user_name - plain string ユーザー名
status active/pending/creating/deleting/error plain string ステータス
total_count - plain int 総件数
current_count - plain int 現在の取得件数

Request Json

This operation does not accept a request body.

Normal response codes

200 - Success

Error response codes

400 - Bad Request
401 - Access Denied

Repeatable

Yes

Example
※エンドポイントURLにつきましては、お客様環境によって異なりますので、コントロールパネルにてご確認の上ご利用ください。

  • REQ
curl -i -X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: 39be9f8d53044388b7f2e867eba8b140" \
https://database-hosting.tyo1.conoha.io/v1/users?service_id=9d6441f6-c5a0-4dcf-a1a9-1a4d724e51fd
  • RES
HTTP/1.1 200 Success
Date: Tue, 09 Dec 2014 01:46:58 GMT
Server: Apache
Content-Length: 1003
Content-Type: application/json

{
    "users": [
        {
            "databases": [
                {
                    "database_id": "148147ba-8999-4901-9cd6-634db82f80ea",
                    "db_name": "02p8y_db0001"
                },
                {
                    "database_id": "f2d55856-ee66-4efb-9663-a501f3f29edb",
                    "db_name": "02p8y_db0003"
                }
            ],
            "service_id": "9d6441f6-c5a0-4dcf-a1a9-1a4d724e51fd",
            "hostname": "host01.example.jp",
            "memo": "memo",
            "user_id": "5f02c821-977f-4160-812d-397a5e3c7caa",
            "user_name": "02p8y_dbuser001",
            "status": "active"
        },
        {
            "databases": [
                {
                    "database_id": "148147ba-8999-4901-9cd6-634db82f80ea",
                    "db_name": "02p8y_db0001"
                },
                {
                    "database_id": "f2d55856-ee66-4efb-9663-a501f3f29edb",
                    "db_name": "02p8y_db0003"
                }
            ],
            "service_id": "9d6441f6-c5a0-4dcf-a1a9-1a4d724e51fd",
            "hostname": "host02.example.jp",
            "memo": "memo2",
            "user_id": "c5f4ce2d-8b17-4387-a06c-9ea9c8d71406",
            "user_name": "02p8y_dbuser002",
            "status": "active"
        }
    ],
    "total_count":100,
    "current_count":10
}