DBスナップショットからのデータベース仮想サーバ復旧(POST /v1.0/{tenantId}/instances)

DBスナップショット(API(DBスナップショットの作成(POST /v1.0/{tenantId}/snapshots)))を用いて手動で作成したDBスナップショットから、データベース仮想サーバを復旧する。

注意:
  • DBスナップショットからのデータベース仮想サーバ復旧では、DBスナップショット取得元のデータベース仮想サーバとは別の新規データベース仮想サーバが作成されます。新規データベース仮想サーバとなるため、FQDN/IPは新規に設定され、DBスナップショット取得元のデータベース仮想サーバとは別に課金が発生します。
  • 自動バックアップ(データベース仮想サーバ作成時の設定条件でシステムが自動で取得したバックアップ)を使用してデータベース仮想サーバを作成する場合は、ポイントイン・タイムリカバリーによるデータベース仮想サーバの復旧(POST /v1.0/{tenantId}/instances/{instanceId})に記載のPOST /v1.0/{tenantId}/instances/{instanceId}を使用してください。

Request URI

{tenantID}

インスタンスのオーナーとなるプロジェクトID

Data Type Cardinality
String 1..1

{instanceId}

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

リストア元のDBインスタンスが存在している場合、同一のIDを指定することはできません。

Data Type Cardinality
String 1..1

Request Parameter

action

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

restoresnapshot

このパラメーターが定義されていた場合、スナップショットからデータベース仮想サーバを復元する。

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

snapshot

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

id

バックアップ元となるスナップショットID

Existing snapshot ID

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

instance

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

volume

id

name

description

availabilityZone

subnetGroupId

multi

multiAZ

port

preferredBackupWindow

preferredMaintenanceWindow

preferredRecoveryTime

autoMaintenance

publiclyAccessible

securityGroupIds

parameterGroupId

backupRetentionPeriod

autoMinorVersionUpgrade

masterUserName

masterUserPassword

downloadLogExtension

flavorRef

型決めされたハードウェアリソースのリストの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

Default : random value

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

name

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

Default value:Random value

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

description

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

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

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

Default: default subnet group

異なるアベイラビリティゾーン上にあるサブネットを複数含むサブネットグループ。少なくとも2つの異なるアベイラビリティゾーンにサブネットが存在する必要があります。

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

multi

マルチDBオプション

true | false

Default values: 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 ~ 32767

Default value:26500

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

preferredBackupWindow

バックアップ時間帯

形式 : hh24:mi-hh24:mi

Default:

リストア元のpreferredBackupWindow

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

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

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

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

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

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

preferredMaintenanceWindow

メンテナンス時間帯

形式 :

ddd:hh24:mi-ddd:hh24:mi

Default:

リストア元のpreferredMaintenanceWindow

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

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

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

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セキュリティグループの名前

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

Default value : security group of the subnet group

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

parameterGroupId

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

Default value: default parameter group

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

backupRetentionPeriod

バックアップ保持期間

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

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

masterUserName

  • 英数字またはアンダースコアのみ使用可
  • 最初の文字はアルファベットかアンダースコアである必要がある
  • 最大63文字
  • リストア元のmasterUserNameと同じ値を指定してください

Default value: postgres

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

masterUserPassword

管理者パスワード

  • 英数字または'(シングルクォート)以外の記号が使用可能
  • 最大1024文字

スナップショットIDに指定するスナップショットの作成日時でのmasterUserPasswordと同じ値を指定してください。

Data Type Cardinality Parent Element Child Element(s)
String 1..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

Content-Type

POST/PUTの場合

application/json を指定

Data Type Cardinality
String 1..1

ステータス

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

以下の値を返却する。
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

multiAZ

parameterGroupId

pendingModifiedValues

preferredBackupWindow

preferredMaintenanceWindow

autoMaintenance

publiclyAccessible

readReplicaDBInstanceIdentifiers

readReplicaSrcDBInstanceIdentifier

secondaryAvailabilityZone

replicaStatus

subnetGroupId

securityGroupIds

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

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

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

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


{
  "action":{"restoresnapshot":""}
  "snapshot":{"id":"snap1"},
  "instance": {
    "flavorRef":"1",
    "volume":{
      "size":100
    },
    "name":"json-rack-instance",
    "availabilityZone":"jp-east-1a",
    "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",
  }
}	
     

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",
    "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
  }
}