ConoHa API Documantation

データベース作成 - Database API v1

Description
データベースを追加します。

Request URL

Database API v1.0

POST /v1/databases

Request Paramters

Parameter Value Style Type Description
X-Auth-Token - header string Userトークン
service_id - plain UUID サービスID
db_name - plain string データベース名 文字種:[a-z0-9_] 文字長:1-14文字
type(Optional) mysql plain string DBタイプ。現版ではmysqlのみ。省略時mysql
charset(Optional) utf8 plain string DB文字コード。現版ではutf8のみ。省略時utf8
memo(Optional) - plain string メモ。省略時空白 文字種:印字可能なASCII文字 文字長:255

Response Paramters

Parameter Value Style Type Description
database - - dict -
service_id - plain UUID サービスID
database_id - plain UUID データベースID
internal_hostname - plain string 接続先(プライベート)
external_hostname - plain string 接続先(グローバル)
db_name - plain string データベース名 プリフィックス+“_”+リクエスト時に指定したdb_name
db_size - plain float 使用DB容量(GB単位)、小数点第二位まで表示
memo - plain string メモ
type - plain string DBタイプ
charset - plain string DB文字コード
status creating plain string ステータス

Request Json

{
    "service_id": "9d6441f6-c5a0-4dcf-a1a9-1a4d724e51fd",
    "type": "mysql",
    "charset": "utf8",
    "db_name": "dbname01",
    "memo": "memo"
}

Normal response codes

200 - Success

Error response codes

400 - Bad Request
401 - Access Denied
409 - Conflict

Repeatable

No

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

  • REQ
curl -i -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Auth-Token: 39be9f8d53044388b7f2e867eba8b140" \
-d
'{
    "service_id": "9d6441f6-c5a0-4dcf-a1a9-1a4d724e51fd",
    "type": "mysql",
    "charset": "utf8",
    "db_name": "dbname01",
    "memo": "memo"
}' \
https://database-hosting.tyo1.conoha.io/v1/databases
  • RES
HTTP/1.1 200 Success
Date: Tue, 09 Dec 2014 01:46:58 GMT
Server: Apache
Content-Length: 1003
Content-Type: application/json

{
    "database" : {
        "service_id": "9d6441f6-c5a0-4dcf-a1a9-1a4d724e51fd",
        "database_id": "148147ba-8999-4901-9cd6-634db82f80ea",
        "internal_hostname": "private.02p8y.tyo1.database-hosting.conoha.io",
        "external_hostname": "public.02p8y.tyo1.database-hosting.conoha.io",
        "db_name": "02p8y_dbname01",
        "db_size": 2,
        "memo": "memo",
        "type": "mysql",
        "charset": "utf8",
        "status": "creating"
    }
}