参照レプリカデータベース仮想サーバの作成 (POST /v1.0/{tenantId}/instances/{instanceId})

参照レプリカデータベース仮想サーバを作る

Request URI

{tenantID}

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

Data Type Cardinality
String 1..1

{instanceId}

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

Data Type Cardinality
String 1..1

Request Parameter

action

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

readreplica

このパラメーターが定義されていた場合、リードレプリカインスタンスが立上る。

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

instance

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

volume

id

name

availabilityZone

autoMinorVersionUpgrade

port

publiclyAccessible

subnetGroupId

securityGroupIds.

subnetGroupId

parameterGroupId

downloadLogExtension

flavorRef

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

存在する flavor 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 to 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
  • 英数字またはハイフンのみ使用可
  • 文字列の先頭は英字で始めること
  • 文字列の末尾にハイフンは使用不可
  • 連続した２つ以上のハイフンは使用不可
  • 最大63文字

Default : random value

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

name

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

Default value: Random value

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

autoMinorVersionUpgrade

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

true | false

Default value: true

注意:

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

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

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

subnetGroupId

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

Default: default subnet group

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

port

ポート番号

1024 to 32767

Default value: 26500

Data Type Cardinality Parent Element Child Element(s)
Integer 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セキュリティグループの名前

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

Default value: default security group

※VPCセキュリティグループを指定する。

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

parameterGroupId

パラメーターグループ

Default value: default parameter group

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

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

port

characterSet

collate

autoMinorVersionUpgrade

availabilityZone

backupRetentionPeriod

engine

engineVersion

engineMinorVersion

masterUserName

parameterGroupId

pendingModifiedValues

preferredBackupWindow

preferredMaintenanceWindow

publiclyAccessible

readReplicaDBInstanceIdentifiers

readReplicaSrcDBInstanceIdentifier

replicaStatus

subnetGroupId

securityGroupIds

downloadLogExtension

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アドレス

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

publicIp

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

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

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

publiclyAccessible

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

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

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

readReplicaDBInstanceIdentifiers

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

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

readReplicaSrcDBInstanceIdentifier

このデータベース仮想サーバがリードレプリカインスタンスだった場合：レプリカ元のデータベース仮想サーバID

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

replicaStatus

リードレプリカの状態

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

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

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

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

Example of Request


{
	"action":{"readreplica":""},
	"instance": {
		"flavorRef": "1",
		"volume":{
"size": 20,
"type": "M1"
}
		"name": "json_rack_instance",
		"availabilityZone" : "jp-east-1a",
		"subnetGroupId":"subnetGroup1",
		"port":1234,
		"preferredBackupWindow":"17:00-18:00",
		"preferredMaintenanceWindow":"Sun:19:00-Sun:20:00",
		"publiclyAccessible" : true,
		"securityGroupIds" : [
			{"securityGroupId" : "secid1"},
			{"securityGroupId" : "secid2"}
		],
		"parameterGroupId" : "paramid1",
	}
}

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":"jp-east-1a",
		"backupRetentionPeriod":10,
		"engine": "enterprisepostgres",
		"engineVersion": "9.6",
		"engineMinorVersion": "0",
		"multiAZ" : true,
		"parameterGroupId":"paramid1",
		"preferredBackupWindow":"17:00-18:00",
		"preferredMaintenanceWindow":"Sun:19:00-Sun:20:00",
		"downloadLogExtension": false,
		"publiclyAccessible" : true,
		"readReplicaSrcDBInstanceIdentifier " : "qawsertb-39be-492-be31-3d6fewab43d7",
		"subnetGroupId":"subnetGroup1",
		"securityGroupIds":[
			{"securityGroupId" : "secid1"},
			{"securityGroupId" : "secid2"}
		],
		
	}
}