データベース仮想サーバの作成 (POST /v1.0/{tenantId}/instances)

新しいデータベース仮想サーバを作成する。

Request URI

{tenantID}

データベース仮想サーバのオーナーとなるプロジェクトID

Data Type Cardinality
String 1..1

Request Parameter

instance

Data Type Cardinality Parent Element Child Element(s)
  1..1 None flavorRef

volume

id

name

description

availabilityZone

subnetGroupId

multi

multiAZ

port

preferredBackupWindow

preferredMaintenanceWindow

preferredRecoveryTime

autoMaintenance

publiclyAccessible

securityGroupIds.

parameterGroupId

backupRetentionPeriod

autoMinorVersionUpgrade

engine

engineVersion

masterUserName

masterUserPassword

characterSet

collate

downloadLogExtension

databases

users

flavorRef

型決めされたハードウェアリソースのリストのID。

存在するフレーバーIDを指定する。

Data Type Cardinality Parent Element Child Element(s)
String 1..1 instance None

volume

Data Type Cardinality Parent Element Child Element(s)
Volume structures 1..1 instance size

type

size

データディスクのサイズ

10 ~ 10240(GB)の間で指定する。

Data Type Cardinality Parent Element Child Element(s)
Integer 1..1 volume None

type

ディスクタイプ

M1

Data Type Cardinality Parent Element Child Element(s)
String 0..1 volume None

id

データベース仮想サーバのID
  • 英数字またはハイフンのみ使用可
  • 文字列の先頭は英字で始めること
  • 文字列の末尾にハイフンは使用不可
  • 連続した2つ以上のハイフンは使用不可
  • 最大63文字

Default: random value

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

name

データベース仮想サーバの名前
  • 英数字またはハイフンのみ使用可
  • 文字列の先頭は英字で始めること
  • 文字列の末尾にハイフンは使用不可
  • 連続した2つ以上のハイフンは使用不可
  • 最大255文字

Default : Random value

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

description

データベース仮想サーバの説明

最大1024文字

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

availabilityZone

インスタンスが作成されるアベイラビリティゾーン

Data Type Cardinality Parent Element Child Element(s)
String 1..1 instance None

subnetGroupId

データベース仮想サーバが配備されるサブネットグループ

少なくとも2つ以上のアベイラビリティゾーンを含むサブネットの集合でなければならない

Default: default subnet group

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

multi

マルチDBオプション

true | false
  • multiAZ = falseでmulti = trueの場合、同一のアベイラビリティゾーン内にデータベース仮想サーバが2重化されます。

Default value : false

Data Type Cardinality Parent Element Child Element(s)
Boolean 0..1 instance None

multiAZ

マルチアベイラビリティゾーンオプション

true | false

Default value: false

Data Type Cardinality Parent Element Child Element(s)
Boolean 0..1 instance None

port

ポート番号

1024 to 32767

Default value:26500

Data Type Cardinality Parent Element Child Element(s)
Integer 0..1 instance None

preferredBackupWindow

バックアップ時間帯

形式: hh24:mi-hh24:mi

自動バックアップが有効の場合に日次のバックアップが行われる時間帯を指定します。

30分以上の時間帯を指定する必要があります。

時刻の指定はUTCで行ってください。

PreferredMaintenanceWIndowと重複した時間帯を設定することはできません。

バックアップは条件により30分を超えて行われることがあります。

Default:24時間の中からのランダムな30分間

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

preferredMaintenanceWindow

週次のメンテナンスが行われる時間帯を指定します。

30分以上23時間30分以内の時間帯を指定する必要があります。

24時間の中からランダムに30分間が決定されます(曜日もランダムで決定されます)。

形式:

ddd:hh24:mi-ddd:hh24:mi

例. Sun:05:00-Sun:06:00

曜日部分の値: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Default: リージョンごとに定められた10時間の中からのランダムな30分間(曜日もランダムで決定)

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

preferredRecoveryTime

自動復旧を開始する時刻

本パラメーターはデータベース仮想サーバが冗長化構成の場合のみ指定可能です(multi = trueの場合のみ指定可能)

Data Type Cardinality Parent Element Child Element(s)
preferredRecoveryTime

Structure

0..1 instance applyImmediately

time

applyImmediately

このパラメーターが定義されていた場合、データベース仮想サーバが片系運用になった時、即時自動復旧が実施されます。

preferredRecoveryTime構造体の中のapplyImmediatelyとtimeは、どちらか片方だけ指定可能です。

default value: true

Data Type Cardinality Parent Element Child Element(s)
Boolean 0..1 preferredRecoveryTime None

time

このパラメーターが定義されていた場合、パラメーター値で指定された時間に自動復旧が実施されます。

preferredRecoveryTime構造体の中のapplyImmediatelyとtimeは、どちらか片方だけ指定可能です。

Data Type Cardinality Parent Element Child Element(s)
String 0..1 preferredRecoveryTime None

autoMaintenance

自動メンテナンスの実施有無

true | false

Default value : true

True : 自動メンテナンスが実施されます。

False: 自動メンテナンスが実施されません。

Data Type Cardinality Parent Element Child Element(s)
Boolean 0..1 instance None

publiclyAccessible

データベース仮想サーバ配備時のインターネットからの接続可否

true | false

Default value: false

true:外部からのインターネット経由での接続が許可される

false:VPC内からのアクセスのみ

Data Type Cardinality Parent Element Child Element(s)
Boolean 0..1 instance None

securityGroupIds.

VPCセキュリティグループのIDリスト

Default:default security group

Data Type Cardinality Parent Element Child Element(s)
String list 0..1 instance None

parameterGroupId

DBパラメーターグループID

Default: default DB parameter group

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

backupRetentionPeriod

バックアップ保持期間(日)

※0の場合は自動バックアップを行わない。

0 to 10

Default value: 1

Data Type Cardinality Parent Element Child Element(s)
Integer 0..1 instance None

autoMinorVersionUpgrade

自動的なマイナーバージョンアップ

true | false

Default value: true

注意:

このパラメータは、効果がありません。

マイナーバージョンアップを実施する際は、applyPatchをtrueに設定してデータベース仮想サーバの起動・再起動APIを実施してください。

Data Type Cardinality Parent Element Child Element(s)
Boolean 0..1 instance None

engine

DBエンジン名

enterprisepostgresまたはsymfoware

Default value: enterprisepostgres

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

engineVersion

DBのバージョン

Default value: Latest version

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

masterUserName

管理者ユーザー名
  • 長さ:1~63文字
  • 使用可能な文字種:英字(小文字)、数字、_(アンダースコア)
  • そのほか制約事項

    先頭は英字(小文字)または _(アンダースコア)だけ使用可能

Default value: postgres

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

masterUserPassword

管理者パスワード

  • 英数字または'(シングルクォート)以外の記号が使用可能
  • 最大1024文字
Data Type Cardinality Parent Element Child Element(s)
String 1..1 instance None

characterSet

文字コード

Default: UTF8

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

collate

照合順序

Default: C

Data Type Cardinality Parent Element Child Element(s)
String 0..1 instance None

downloadLogExtension

ログ拡張機能

true | false

Default value: false

true:ログ拡張機能を有効化する。本機能を有効化した場合、DBログ容量の10%ほど、ログ情報の管理用としてディスク使用量が増加する。

false:ログ拡張機能を無効化する。

Data Type Cardinality Parent Element Child Element(s)
Boolean 0..1 instance None

database

作成するDB構造体のリスト

省略した場合は、デフォルトDBのpostgresのみが作成される。

Data Type Cardinality Parent Element Child Element(s)
Database structures list 0..1 instance name

name

データベース名
  • 英数字またはアンダースコアのみ使用可
  • 最初の文字はアルファベットかアンダースコアである必要があります
  • 最大63文字
  • 大文字を指定した場合も小文字で作成されます。

    大文字で作成したい場合は、データベース仮想サーバ作成後にCREATE DATABASE文を実行して作成を実施してください。

Data Type Cardinality Parent Element Child Element(s)
String 1..1 database None
注意:

データベース名を大文字で作成する場合、APIのデータベース名をダブルクオートで囲む必要がありますが、データベースの仕様によりダブルクオートが使用できません。

そのためAPIではデータベース名を大文字で作成することができません。

users

作成するユーザー構造体のリスト

省略した場合は、master userのみが作成される。

Data Type Cardinality Parent Element Child Element(s)
User structures list 0..1 instance name

password

(database)name

name

DBユーザー名
  • 英数字またはアンダースコアのみ使用可
  • 最初の文字はアルファベットかアンダースコアである必要があります
  • 最大63文字
  • 大文字を指定した場合も小文字で作成されます。

    大文字で作成したい場合は、データベース仮想サーバ作成後にCREATE ROLE文を実行して作成を実施してください。

Data Type Cardinality Parent Element Child Element(s)
String 1..1 users None

password

上記ユーザーのパスワード
  • 最大1024文字
Data Type Cardinality Parent Element Child Element(s)
String 1..1 users None

(database)name

上記ユーザーがログイン可能なデータベース名
  • 英数字またはアンダースコアのみ使用可
  • 最初の文字はアルファベットかアンダースコアである必要があります
  • 最大63文字
Data Type Cardinality Parent Element Child Element(s)
String list 1..1 users None

Response Headers

ステータス

リクエストのステータスを返却する。

以下の値を返却する。
400:
badRequest
401:
unauthorized
403:
forbidden
404:
itemNotFound
413:
overLimit
422:
unprocessableEntity
500:
instanceFault
501:
notImplemented
503:
serviceUnavailable
504:
gatewayTimeout
Data Type Cardinality
Int 1..1

Response Elements

instance

Data Type Cardinality Parent Element Child Element(s)
    None created

flavor

id

links

name

status

updated

volume

privateAddress

publicAddress

privateIp

publicIp

subPrivateIp

subPublicIp

port

characterSet

collate

autoMinorVersionUpgrade

availabilityZone

backupRetentionPeriod

engine

engineVersion

engineMinorVersion

masterUserName

multi

multiAZ

parameterGroupId

PendingModifiedValues

preferredBackupWindow

preferredMaintenanceWindow

publiclyAccessible

readReplicaDBInstanceIdentifiers

readReplicaSrcDBInstanceIdentifier

secondaryAvailabilityZone

replicaStatus

subnetGroupId

securityGroupIds

description

downloadLogExtension

readReplicaDBInstances

readReplicaSrcDBInstance

created

作成日時

Data Type Cardinality Parent Element Child Element(s)
Date   instance None

flavor

仮想サーバのスペック

Data Type Cardinality Parent Element Child Element(s)
Flavor structures   instance None

id

データベース仮想サーバのID

Data Type Cardinality Parent Element Child Element(s)
String   instance None

links

データベース仮想サーバへのURI

Data Type Cardinality Parent Element Child Element(s)
String   instance None

name

データベース仮想サーバの名前

Data Type Cardinality Parent Element Child Element(s)
String   instance None

status

データベース仮想サーバの状態

Data Type Cardinality Parent Element Child Element(s)
String   instance None

updated

更新日時

Data Type Cardinality Parent Element Child Element(s)
Date   instance None

volume

データ格納先のディスクタイプとサイズ

Data Type Cardinality Parent Element Child Element(s)
Volume structures   instance None

privateAddress

データベース仮想サーバが立ち上がっている仮想サーバへの内部アドレス (FQDN形式)

Data Type Cardinality Parent Element Child Element(s)
String   instance None

publicAddress

データベース仮想サーバが立ち上がっている仮想サーバへのグローバルアドレス(FQDN形式)

Data Type Cardinality Parent Element Child Element(s)
String   instance None

privateIp

データベース仮想サーバへの内部IPアドレス

指定したサブネットグループのサブネット(CIDR)に従って決定。

Data Type Cardinality Parent Element Child Element(s)
String   instance None

publicIp

データベース仮想サーバのグローバルIPアドレス

publiclyAccessibleがfalseの場合は表示されません。

Data Type Cardinality Parent Element Child Element(s)
String   instance None

subPrivateIp

待機系データベース仮想サーバの内部IPアドレス

指定したサブネットグループのサブネット(CIDR)に従って決定。

Data Type Cardinality Parent Element Child Element(s)
String   instance None

subPublicIp

待機系データベース仮想サーバのグローバルIPアドレス

publiclyAccessibleがfalseの場合は表示されません。

Data Type Cardinality Parent Element Child Element(s)
String   instance None

port

ポート番号

Data Type Cardinality Parent Element Child Element(s)
Integer   instance None

characterSet

データベースのエンコーディング

Data Type Cardinality Parent Element Child Element(s)
String   instance None

collate

データベースの照合順序

Data Type Cardinality Parent Element Child Element(s)
String   instance None

autoMinorVersionUpgrade

自動的なマイナーバージョンアップを行うかどうかのフラグ

Data Type Cardinality Parent Element Child Element(s)
Boolean   instance None

availabilityZone

データベース仮想サーバが立ち上がっているアベイラビリティゾーン

Data Type Cardinality Parent Element Child Element(s)
String   instance None

backupRetentionPeriod

バックアップ保持期間

Data Type Cardinality Parent Element Child Element(s)
Integer   instance None

engine

データベースの種類

Data Type Cardinality Parent Element Child Element(s)
String   instance None

engineVersion

データベースのバージョン

Data Type Cardinality Parent Element Child Element(s)
String   instance None

engineMinorVersion

データベースのマイナーバージョン

Data Type Cardinality Parent Element Child Element(s)
String   instance None

masterUserName

管理者ユーザー名

Data Type Cardinality Parent Element Child Element(s)
String   instance None

multi

マルチDBオプション

Data Type Cardinality Parent Element Child Element(s)
Boolean   instance None

multiAZ

マルチアベイラビリティゾーンオプション

Data Type Cardinality Parent Element Child Element(s)
Boolean   instance None

parameterGroupId

DBパラメーターグループのID

Data Type Cardinality Parent Element Child Element(s)
String   instance None

pendingModifiedValues

次の再起動時に変更される予定のパラメーターの一覧

Data Type Cardinality Parent Element Child Element(s)
PendingModifiedValues structures   instance None

preferredBackupWindow

バックアップ時間帯

Data Type Cardinality Parent Element Child Element(s)
String   instance None

preferredMaintenanceWindow

メンテナンス時間帯

Data Type Cardinality Parent Element Child Element(s)
String   instance None

autoMaintenance

自動メンテナンスの実施有無

Data Type Cardinality Parent Element Child Element(s)
Boolean   instance None

publiclyAccessible

データベース仮想サーバ配備時のインターネットからの接続可否

trueの場合:パブリックIPが割り当てられる。

Data Type Cardinality Parent Element Child Element(s)
Boolean   instance None

readReplicaDBInstanceIdentifiers

このパラメーターはreadReplicaDBInstancesに統合され廃止されました。常に空のlistが返却されます。

Data Type Cardinality Parent Element Child Element(s)
String list   instance None

readReplicaSrcDBInstanceIdentifier

このパラメーターはreadReplicaSrcDBInstanceに統合され廃止されました。常にnullが返却されます。

Data Type Cardinality Parent Element Child Element(s)
String   instance None

secondaryAvailabilityZone

二重化オプションがtrueだった場合:

副系データベース仮想サーバが立ち上がっているアベイラビリティゾーン

Data Type Cardinality Parent Element Child Element(s)
String   instance None

replicaStatus

リードレプリカの状態

ReplicatingまたはError

Data Type Cardinality Parent Element Child Element(s)
String   instance None

subnetGroupId

DBサブネットグループのID

Data Type Cardinality Parent Element Child Element(s)
String   instance None

securityGroupIds

VPCセキュリティグループIDのリスト

Data Type Cardinality Parent Element Child Element(s)
String list   instance None

downloadLogExtension

ログ拡張機能

Data Type Cardinality Parent Element Child Element(s)
Boolean   instance None

readReplicaDBInstances

このデータベース仮想サーバに関連付けられている、リードレプリカインスタンス

リードレプリカに対する操作とは非同期で反映されます。

Data Type Cardinality Parent Element Child Element(s)
ReadReplicaDBInstance Structure list   instance

region

tenantId

id

readReplicaSrcDBInstance

元のデータベース仮想サーバ

元のデータベース仮想サーバに対する操作とは非同期で反映されます。

Data Type Cardinality Parent Element Child Element(s)
ReadReplicaSrcDBInstance Structure list   instance

region

tenantId

id

flavor

Data Type Cardinality Parent Element Child Element(s)
    None id

links

id

フレーバーID

Data Type Cardinality Parent Element Child Element(s)
String   flavor None

links

フレーバーのURI

Data Type Cardinality Parent Element Child Element(s)
String   flavor None

pendingModifiedValues

Data Type Cardinality Parent Element Child Element(s)
    None volume

backupRetentionPeriod

flavor

id

name

parameterGroupId

engineVersion

masterUserName

masterUserPassword

multi

multiAZ

port

engineMinorVersion

securityUpdate

volume

データ格納先のディスクタイプとサイズ

Data Type Cardinality Parent Element Child Element(s)
Volume structures   PendingModifiedValues None

backupRetentionPeriod

バックアップ保持期間

Data Type Cardinality Parent Element Child Element(s)
String   PendingModifiedValues None

flavor

仮想サーバのスペック

Data Type Cardinality Parent Element Child Element(s)
Flavor   PendingModifiedValues None

id

データベース仮想サーバのID

Data Type Cardinality Parent Element Child Element(s)
String   PendingModifiedValues None

name

データベース仮想サーバの名前

Data Type Cardinality Parent Element Child Element(s)
String   PendingModifiedValues None

parameterGroupId

DBパラメーターグループのID

Data Type Cardinality Parent Element Child Element(s)
String   PendingModifiedValues None

engineVersion

データベースのバージョン

Data Type Cardinality Parent Element Child Element(s)
String   PendingModifiedValues None

masterUserName

データベース仮想サーバのマスタユーザー名

Data Type Cardinality Parent Element Child Element(s)
String   PendingModifiedValues None

masterUserPassword

データベース仮想サーバのマスタユーザーのパスワード

ただし、セキュリティ保護のため、返り値はすべて"***"で表現される。

Data Type Cardinality Parent Element Child Element(s)
String   PendingModifiedValues None

multi

マルチDBオプション

Data Type Cardinality Parent Element Child Element(s)
Boolean   PendingModifiedValues None

multiAZ

マルチアベイラビリティゾーンオプション

Data Type Cardinality Parent Element Child Element(s)
Boolean   PendingModifiedValues None

port

ポート番号

Data Type Cardinality Parent Element Child Element(s)
Integer   PendingModifiedValues None

engineMinorVersion

データベースのマイナーバージョン

データベースのマイナーバージョンがリリースされた場合に、パッチ適用を実施できます。

Data Type Cardinality Parent Element Child Element(s)
String   PendingModifiedValues None

securityUpdate

セキュリティアップデートの有無

セキュリティアップデートがリリースされた場合に、パッチ適用を実施できます。

Data Type Cardinality Parent Element Child Element(s)
Boolean   PendingModifiedValues None

volume

Data Type Cardinality Parent Element Child Element(s)
    None size

type

size

データストレージのサイズ

Data Type Cardinality Parent Element Child Element(s)
String   volume None

type

データストレージのタイプ

Data Type Cardinality Parent Element Child Element(s)
String   volume None

region

このデータベース仮想サーバに関連付けられている、リードレプリカのリージョン

Data Type Cardinality Parent Element Child Element(s)
String   readReplicaDBInstances None

tenantId

このデータベース仮想サーバに関連付けられている、リードレプリカのプロジェクトID

Data Type Cardinality Parent Element Child Element(s)
String   readReplicaDBInstances None

id

このデータベース仮想サーバに関連付けられている、リードレプリカのID

Data Type Cardinality Parent Element Child Element(s)
String   readReplicaDBInstances None

region

元のデータベース仮想サーバのリージョン

Data Type Cardinality Parent Element Child Element(s)
String   readReplicaSrcDBInstance None

tenantId

元のデータベース仮想サーバのプロジェクトID

Data Type Cardinality Parent Element Child Element(s)
String   readReplicaSrcDBInstance None

id

元のデータベース仮想サーバのID

Data Type Cardinality Parent Element Child Element(s)
String   readReplicaSrcDBInstance None

Example of Request


{
	"instance":{
		"flavorRef":"1",
		"volume":{
			"size":20,
			"type":"M1"
			}
		"name":"json-rack-instance",
		"availabilityZone":"jp-east-1a",
		"multi":true,
		"multiAZ":true,
		"subnetGroupId":"subnetGroup1",
		"port":1234,
		"preferredBackupWindow":"17:00-18:00",
		"preferredMaintenanceWindow":"Sun:19:00-Sun:20:00",
                "preferredRecoveryTime":{
                  "applyImmediately":true
                },
                "autoMaintenance":true,
        	"publiclyAccessible":true,
		"securityGroupIds":[
			{"securityGroupId":"secid1"},
			{"securityGroupId":"secid2"}
		],
		"parameterGroupId":"paramid1",
		"characterSet":"utf8",
		"collate":"C",
		"backupRetentionPeriod":10,
		"autoMinorVersionUpgrade":true,
		"engine":"symfoware",
		"engineVersion":"12.1",
		"masterUserPassword":"***"
		"databases": [
			{
				"name":"sampledb",
			},
			{
				"name":"nextround"
			}
		],
		"users": [
			{
				"databases":[
					{
					"name":"sampledb"
					}
				],
				"name":"demouser",
				"password":"demopassword"
			}
		]
	}
}       
     

Example of Response


{
	"instance":{
		"created":"2013-03-18T19:09:17",
		"flavor":{
			"id":"1",
			"links":[
				{
				"href":"http://database.{region-name}.tps5.fujitsu.com/v1.0/1234/flavors/1",
				"rel":"self"
				}
			]
		},
		"id":"44b277eb-39be-4921-be31-3d61b43651d7",
		"links":[
			{
				"href":"http://database.{region-name}.tps5.fujitsu.com/v1.0/1234/instances/44b277eb-39be-4921-be31-3d61b43651d7",
				"rel":"self"
			},
		],
		"status":"BUILD"
		"volume":{
			"size":20,
			"type":"M1"
		}
		"name":"json_rack_instance",
		"privateAddress":"fujitsu.s5.dbaas.a23w4e5r6tg7yuhjik",
		"privateIp":"10.125.52.214",
		"port":26500,
		"characterSet":"UTF-8",
		"collate":"C",
		"autoMinorVersionUpgrade":true,
		"availabilityZone":"az-1",
		"backupRetentionPeriod":10,
		"engine":"enterprisepostgres",
		"engineVersion":"9.6",
		"engineMinorVersion":"0",
		"multi":true,
		"multiAZ":true,
		"parameterGroupId":"paramid1",
		"preferredBackupWindow":17:00-18:00,
		"preferredMaintenanceWindow":Sun:19:00-Sun:20:00,
		"preferredRecoveryTime":{
			"applyImmediately":true, 
			"time":none, 
		},
		"autoMaintenance":true,
		"downloadLogExtension":false,
		"publiclyAccessible":true,
		"subnetGroupId":"subnetGroup1",
		"securityGroupIds":[
			{"securityGroupId":"secid1"},
			{"securityGroupId":"secid2"}
		],
		"readReplicaDBInstances": [],
		"readReplicaSrcDBInstance": {},
		"replicaStatus": null,
		"readReplicaDBInstanceIdentifiers": [],
		"readReplicaSrcDBInstanceIdentifier": null
	}
}