ConoHa API Documantation

サービス作成 - Mail API v1.0

Description
メールサービスを作成します。

Request URL

Mail API v1.0

POST /v1/services

Request Paramters

Parameter Value Style Type Description
X-Auth-Token - header string Userトークン
service_name - plain string サービス名、文字種別:半角英数字、-(ハイフン)、_(アンダースコア)、文字長:1~255文字
default_sub_domain - plain string デフォルトサブドメイン、文字種別:半角英小文字、半角数字、-(ハイフン)(※但し、-(ハイフン)は先頭と末尾は禁止)、文字長:1~63文字
metadata(Optional) - plain dict メタデータのキーと値のペア 文字種:[a-zA-Z0-9./%_:- ] 文字長:255(キーと値共に)

Response Paramters

Parameter Value Style Type Description
service - plain dict -
status active plain string サービスの状態
service_id - plain UUID サービスID
service_name - plain string サービス名
smtp - plain string SMTPホスト名
pop - plain string POPホスト名
imap - plain string IMAPホスト名
mx - plain string MXホスト名
quota - plain int 使用容量上限値(単位GB)
total_usage - plain float 使用容量合算値(単位GB)、小数点第二位まで表示
default_domain - plain string デフォルトドメイン
backup disable plain string バックアップ可否、enable:有効、disable:無効
metadata - plain dict メタデータ キーと値の辞書オブジェクト
create_date - plain string サービス作成日付

Request Json

{
    "service_name": "testservice",
    "default_sub_domain": "default",
    "metadata" : {
            "key" : "value"
     }
}

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_name": "testservice01",
    "default_sub_domain": "default",
    "metadata" : {
            "key" : "value"
     }
}' \
https://mail-hosting.tyo1.conoha.io/v1/services
  • RES
HTTP/1.1 200 Success
Date: Tue, 09 Dec 2014 01:46:58 GMT
Server: Apache
Content-Length: 1003
Content-Type: application/json

{
    "service":{
        "status": "active",
        "service_id": "4998f0beb08e16a",
        "service_name": "testservice",
        "smtp": "14124342342.smtp.conoha.io",
        "pop": "14124342342.pop.conoha.io",
        "imap": "14124342342.imap.conoha.io",
        "mx": "mx.unit01.paasmail.tyo1.conoha.io",
        "quota": 540,
        "total_usage": 100,
        "default_domain": "default.conoha.io",
        "backup": "disable",
        "metadata" : {
            "key" : "value"
        },
        "create_date": "2015-04-07T04:19:05Z"
    }
}