本文へジャンプします。

【重要なお知らせ】サービス統合に基づくサービス名称の読み替えのお願い(2024年4月1日)

2024年4月1日をもって、「ニフクラ」は、「FJcloud-V」に統合し、名称を変更しました。
当サイトのアドレス(ドメイン名)に含まれる「nifcloud.com」は現時点では変更はございませんが、
各ページに記載の「ニフクラ」「NIFCLOUD」「nifcloud」は、「FJcloud-V」に読み替えていただきますようお願いいたします。

ニフクラ ユーザーガイド

クラウド トップ>RDB> API> RestoreDBInstanceToPointInTime

RestoreDBInstanceToPointInTime

処理概要

既存のDBサーバーのある日時の状態から新しいDBサーバーを作成します。

最新のリストア可能時間からバックアップ保持期間までの状態にリストアすることができます。

元のDBサーバーとほぼ同じ設定でDBサーバーが作成されますが、異なる設定を適用することもできます。

指定するパラメーター

パラメーター 説明 必須
AccountingType string 利用料金タイプ
値:
  • 1 (月額課金)
  • 2 (従量課金)
Default: 2
AutoMinorVersionUpgrade boolean ※指定不可
AvailabilityZone string

指定可能なゾーンについては、ニフクラ ゾーン別機能対応表をご参照ください。


Default: 自動割り当て
○ (プライベートLANを利用している場合)
DBInstanceClass string DBサーバータイプ
値:
  • db.e-small
  • db.small
  • db.e-small2
  • db.small2
  • db.e-small4
  • db.small4
  • db.e-small8
  • db.small8
  • db.e-small16
  • db.small16
  • db.e-medium
  • db.medium
  • db.e-medium4
  • db.medium4
  • db.e-medium8
  • db.medium8
  • db.e-medium16
  • db.medium16
  • db.e-medium24
  • db.medium24
  • db.e-large
  • db.large
  • db.e-large8
  • db.large8
  • db.e-large16
  • db.large16
  • db.e-large24
  • db.large24
  • db.e-large32
  • db.large32
  • db.e-extra-large8
  • db.extra-large8
  • db.e-extra-large16
  • db.extra-large16
  • db.e-extra-large24
  • db.extra-large24
  • db.e-extra-large32
  • db.extra-large32
  • db.e-extra-large48
  • db.extra-large48
  • db.e-double-large16
  • db.double-large16
  • db.e-double-large24
  • db.double-large24
  • db.e-double-large32
  • db.double-large32
  • db.e-double-large48
  • db.double-large48
  • db.e-double-large64
  • db.double-large64
  • db.e-double-large96
  • db.double-large96
  • db.triple-large32
  • db.triple-large48
  • db.triple-large64
  • db.triple-large96
  • db.triple-large128
  • db.quad-large64
  • db.quad-large96
  • db.quad-large128
  • db.septa-large128
Default: 元のDBサーバーの値
DBName string

DB名

  • ※このパラメーターはMySQL、PostgreSQLエンジンでは利用できません

NiftyDBParameterGroupName string

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

  • ※このパラメーターを指定しない場合、デフォルトのDB パラメーターグループが使用されます
  • ※1〜255字のアルファベット(小文字)・数字・ハイフン(‘-’)が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません

Default: DBエンジンのDefaultParameterGroupName
備考: ニフクラ独自仕様
NiftyDBSecurityGroups.member.N string

DBファイアウォールグループのリスト

  • ※このパラメーターを指定しない場合、デフォルトのDBファイアウォールグループが使用されます

Default: DBエンジンのDefaultSecurityGroup
備考: ニフクラ独自仕様
1つのみ指定可能です。複数指定した場合、2つ目以降は無視されます。
DBSubnetGroupName string ※指定不可
DowngradeRestore boolean DBサーバーを基盤ダウングレードしてリストアするかどうか
Default: false
Engine string

データベースエンジン

  • ※元のDBサーバーと同じエンジンである必要があります

Default: 元のDBサーバーの値
Iops integer ※指定不可
LicenseModel string

DBサーバーのライセンスモデル

  • ※元になるDBサーバーと同じである必要があります

値:
MySQL の場合
  • general-public-license
PostgreSQL の場合
  • postgresql-license
Default: 元のDBサーバーの値
MultiAZ boolean 冗長化機能が有効かどうか
Default: false
OptionGroupName string ※指定不可
Port integer

DBが接続を受け付けるポート

  • ※元のDBサーバーと同じである必要があります

Default: 元のDBサーバーの値
使用可能文字: 1150〜65535の数字
PubliclyAccessible boolean グローバルIPアドレスを有効にするかどうか
Default: true
RestoreTime timestamp

リストアする時間

  • 最新のリストア可能時間より前でなければならない

  • ※UseLatestRestorableTimeがfalseの場合、指定しなければエラーとなります

  • ※UseLatestRestorableTimeがtrueの場合、指定できません

  • ※時間は UTC で指定する必要があります
    例:2009-09-07T23:45:00Z


SourceDBInstanceIdentifier string

リストアする元のDBサーバー名

  • ※存在するDBサーバーを指定する必要があります

TargetDBInstanceIdentifier string

新しく作成されるDBサーバー名

  • ※1〜63字のアルファベット(小文字)・数字・ハイフン(‘-’)が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません

UseLatestRestorableTime boolean

最新のバックアップからリストアするかどうか

  • ※RestoreTimeの値が指定されている場合、trueを指定することはできません

Default: false
NiftyStorageType integer ディスクタイプ
値:
  • 0 (高速ディスク)
  • 1 (フラッシュドライブ)
  • 2 (標準フラッシュドライブ)
  • 3 (高速フラッシュドライブ)
Default: 0
備考: ニフクラ独自仕様
NiftyNetworkId string プライベートLANのネットワークユニークID
Default: 0
備考: ニフクラ独自仕様
NiftyVirtualPrivateAddress string 仮想ロードバランサー用のプライベートIPアドレス
備考: ニフクラ独自仕様
○ (プライベートLANを利用している場合)
NiftyMasterPrivateAddress string 主系DBサーバー用のプライベートIPアドレス
備考: ニフクラ独自仕様
○ (プライベートLANを利用している場合)
NiftySlavePrivateAddress string 待機系DBサーバー用のプライベートIPアドレス
備考: ニフクラ独自仕様
○ (プライベートLANを利用している場合、かつ、MultiAZ=trueの場合)

応答フィールド

フィールド (項目) 説明
RestoreDBInstanceToPointInTimeResponse structure ルート
RestoreDBInstanceToPointInTimeResult structure 結果
DBInstance structure DBサーバー
備考: DBInstanceの子要素はDescribeDBInstancesで返却される要素をすべて記載しているためAPIによっては返却されない要素もあります。実際のレスポンスはレスポンスサンプルを参照してください。
AllocatedStorage integer 割り当てるディスク容量(GB)
AutoMinorVersionUpgrade boolean マイナーバージョンの自動アップデートを行うかどうか
備考: 固定値falseを返却
AvailabilityZone string DBサーバーのゾーン
BackupRetentionPeriod integer バックアップ保持期間
BinlogRetentionPeriod integer

バイナリログ保持期間(日)

  • BinlogRetentionPeriodを変更した場合のみ要素を返却します。

ExternalReplicationInfo structure

外部レプリケーション情報

  • ※DBサーバーが以下の場合のみこのタグは返却されます
  • MySQLでシングル構成
  • MySQLで冗長構成 (データ優先)

ExternalReplicationMessage string

外部レプリケーション操作結果

  • ※エラー発生時は、実行時に出力されたメッセージ

ExternalReplicationStatus string

外部レプリケーション操作ステータス

  • set(SetExternalMaster実行成功 & StartReplication未実行)
  • started(StartReplication実行成功 & StopReplication未実行)
  • stopped(StopReplication実行成功 & ResetExternalMaster未実行)
  • set-error(SetExternalMaster実行失敗)
  • start-error(StartReplication実行失敗)
  • stop-error(StopReplication実行失敗)
  • reset-error(ResetExternalMaster実行失敗)

ReplicationAddresses list 外部レプリケーション接続元グローバルIPアドレスリスト
ReplicationAddress string

外部レプリケーション接続元グローバルIPアドレス

  • ※シングル構成の場合は外部レプリケーション接続元グローバルIPアドレスを1つ返却します
  • ※冗長構成(データ優先)の場合は外部レプリケーション接続元グローバルIPアドレスを2つ返却します

ReplicationPrivateAddresses list 外部レプリケーション接続元プライベートIPアドレスリスト
ReplicationPrivateAddress string

外部レプリケーション接続元プライベートIPアドレス

  • ※シングル構成の場合は外部レプリケーション接続元プライベートIPアドレスを1つ返却します
  • ※冗長構成(データ優先)の場合は外部レプリケーション接続元プライベートIPアドレスを2つ返却します

ExternalMasterAddress string マスターとなるDBサーバーのIPアドレスまたはホスト名
CACertificateIdentifier string DBサーバーのサーバー証明書と紐付くCA証明書
DBInstanceClass string DBサーバータイプ
DBInstanceIdentifier string DBサーバー名
DBInstanceStatus string DBサーバーのステータス
DBInstanceUpgradeStatus string

DBサーバーの基盤アップグレードステータス

  • required(アップグレードが必要)
  • preparing(アップグレード準備中)
  • upgradable(アップグレード可能)
  • upgrading(アップグレード中)
  • latest(最新)
  • canceling(キャンセル中)
  • not-upgradable(アップグレード不可)

DBName string DB名
DBParameterGroups list DBパラメーターグループ情報リスト
DBParameterGroup structure DBパラメーターグループ
DBParameterGroupName string DBパラメーターグループ名
ParameterApplyStatus string

DBパラメーターの適用ステータス

  • 値:applying(適用中) | pending-reboot(再起動待ち) | in-sync(適用済み)

DBSecurityGroups list DBファイアウォールグループ情報リスト
DBSecurityGroup structure DBファイアウォールグループ
DBSecurityGroupName string DBファイアウォールグループ名
Status string

DBファイアウォールグループのステータス

  • 値:active(有効) | adding(適用中) | removing(取り外し中) | failed(変更失敗)

Endpoint structure DB接続時のエンドポイント
Port integer ポート番号
Address string

グローバルIPアドレス

  • ※PubliclyAccessibleがオフの場合、このタグは返却されません。

NiftyPrivateAddress string プライベートIPアドレス
Engine string データベースエンジン
EngineVersion string データベースエンジンのバージョン
InstanceCreateTime timestamp DBサーバーの作成日時
LatestRestorableTime timestamp ポイントインタイムリカバリー可能な最新の時刻
LicenseModel string DBサーバーのライセンスモデル
MasterUsername string DBサーバーのマスターユーザー名
MultiAZ boolean 冗長化機能が有効かどうか
NiftyMultiAZType string 冗長構成タイプ
備考: ニフクラ独自仕様
OptionGroupMemberships list オプショングループ情報リスト
OptionGroupMembership structure オプショングループ情報
OptionGroupName string

下記の固定値を返却

  • DBエンジンがMySQL 5.6系の場合、default:mysql-5-6
  • DBエンジンがMySQL 5.7系の場合、default:mysql-5-7
  • DBエンジンがMySQL 8.0系の場合、default:mysql-8-0
  • DBエンジンがPostgreSQL9.3系の場合、default:postgres-9-3
  • DBエンジンがPostgreSQL9.6系の場合、default:postgres-9-6
  • DBエンジンがPostgreSQL11系の場合、default:postgres-11
  • DBエンジンがPostgreSQL13系の場合、default:postgres-13

Status string オプショングループのステータス
備考: 固定値in-syncを返却
PendingModifiedValues structure 保留の修正情報
AllocatedStorage integer 保留中のディスク容量
BackupRetentionPeriod integer 保留中のバックアップ保持期間
DBInstanceClass string 保留中のDBサーバータイプ
DBInstanceIdentifier string 保留中のDBサーバー名
EngineVersion string 保留中のデータベースエンジンのバージョン
MasterUserPassword string 保留中のDBサーバーのマスターユーザー名
MultiAZ boolean 保留中の「冗長化機能が有効かどうか」フラグ
Port integer 保留中のアクセス可能なポート番号
PreferredBackupWindow string バックアップ時間
PreferredMaintenanceWindow string メンテナンス時間
PubliclyAccessible boolean グローバルIPアドレスを有効にするかどうか
ReadReplicaDBInstanceIdentifiers list リードレプリカ名リスト
ReadReplicaDBInstanceIdentifier string リードレプリカ名
ReadReplicaSourceDBInstanceIdentifier string リードレプリカのマスターとして設定されているDBサーバー名
SecondaryAvailabilityZone string

待機系DBサーバーのゾーン

  • ※冗長化機能がオンの場合、固定でAvailabilityZoneと同じ値が返却されます
  • ※冗長化機能がオフの場合、このタグは返却されません

StatusInfos list

リードレプリカのステータス

  • ※DBサーバーがリードレプリカでない場合、空タグが返却されます

DBInstanceStatusInfo structure DBサーバーのステータス情報のリスト
Message string

エラーメッセージ

  • ※エラーが発生していない場合は空タグが返却されます

Normal boolean 正常かどうか
Status string

DBサーバーのステータス

  • 値(StatusTypeが”read replication”の場合): replicating(レプリケーション中) | error(レプリケーションエラー)

StatusType string DBサーバーのステータス種別
備考: 固定値"read replication"を返却
VpcSecurityGroups string ※返却値なし
NiftyStorageType integer ディスクタイプ
備考: ニフクラ独自仕様
NiftyNetworkId string プライベートLANのネットワークユニークID
備考: ニフクラ独自仕様
NiftyMasterPrivateAddress string 主系DBサーバー用のプライベートIPアドレス
備考: ニフクラ独自仕様
NiftySlavePrivateAddress string 待機系DBサーバー用のプライベートIPアドレス
備考: ニフクラ独自仕様
AccountingType string 当月の利用料金タイプ
NextMonthAccountingType string 翌月の利用料金タイプ
ResponseMetadata structure 共通メタ情報
RequestId string リクエスト識別子

エラー

コード メッセージ タイプ HTTPステータスコード 説明
Client.InvalidParameterCannotSpecify.DBInstanceClass

Specified DB Instance class is not available in the specified Availability Zone.

Sender 400 指定されたAvailabilityZoneで作成できないDBサーバータイプを指定した場合
Client.InvalidParameterCannotSpecify.DBName

DBName INTO cannot be used. It is a reserved word for this engine

Sender 400 DBNameに予約語を指定した場合
Client.InvalidParameterCannotSpecify.Engine

Requested DBSnapshot and Engine are incompatible

Sender 400 SourceDBInstanceIdentifierに指定したDBサーバーと異なるエンジンを指定した場合
Client.InvalidParameterCannotSpecify.NiftyMasterPrivateAddress

NiftyMasterPrivateAddress is not allowed in the range of 10.0.0.0/8.

Sender 400 NiftyMasterPrivateAddressに許可されないIPアドレスを指定した場合
Client.InvalidParameterCannotSpecify.NiftySlavePrivateAddress

NiftySlavePrivateAddress is not allowed in the range of 10.0.0.0/8.

Sender 400 NiftySlavePrivateAddressに許可されないIPアドレスを指定した場合
Client.InvalidParameterCannotSpecify.NiftyVirtualPrivateAddress

NiftyVirtualPrivateAddress is not allowed in the range of 10.0.0.0/8.

Sender 400 NiftyVirtualPrivateAddressに許可されないIPアドレスを指定した場合
Client.InvalidParameterCannotSpecify.RestoreSourceDBInstanceIdentifier

Point-in-time restore is not enabled for this database instance. To enable point-in-time restore, use ModifyDBInstance to set the backup retention period to a non-zero value.

Sender 400 SourceDBInstanceIdentifierにBackupRetentionPeriod=0のDBサーバーを指定した場合
Client.InvalidParameterCombination.DBParameterGroupFamily.and.DBParameterGroup
  • MySQLの場合
    The Parameter Group default.mysql5.7 with DBParameterGroupFamily mysql5.7 cannot be used for this instance. Please use a Parameter Group with DBParameterGroupFamily mysql5.6
  • PostgreSQLの場合
    The Parameter Group default.postgresn.n with DBParameterGroupFamily postgresn.n cannot be used for this instance. Please use a Parameter Group with DBParameterGroupFamily postgres13.8
Sender 400 DBサーバーのDBParameterGroupFamilyと異なるDBパラメーターグループを指定した場合
Client.InvalidParameterDuplicate.DBInstanceIdentifier

DB Instance already exists

Sender 400 TargetDBInstanceIdentifierにすでに存在するDBInstanceIdentifierを指定した場合
Client.InvalidParameterDuplicate.PrivateAddress

Private addresses are not unique: 192.168.1.112

Sender 400 NiftyVirtualPrivateAddress、NiftyMasterPrivateAddress、NiftySlavePrivateAddressに重複したIPアドレスを指定した場合
Client.InvalidParameterDuplicate.PrivateAddress

Private address is already in use: 192.168.1.111

Sender 400 NiftyVirtualPrivateAddress、NiftyMasterPrivateAddress、NiftySlavePrivateAddressにすでに使用済みのIPアドレスを指定した場合
Client.InvalidParameterEitherOf.RestoreTime.or.UseLatestRestorableTime

If UseLatestRestorableTime is not true, the RestoreTime parameter must be specified.

Sender 400 RestoreTimeもUseLatestRestorableTimeも指定しなかった場合
Client.InvalidParameterFormat.DBInstanceIdentifier

The parameter TargetDBInstanceIdentifier is not a valid identifier. Identifiers must begin with a letter; must contain only lowercase ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens.

Sender 400 TargetDBInstanceIdentifierに無効な値(ハイフンで始まる 等)を指定した場合
Client.InvalidParameterFormat.DBName

DBName must begin with a letter and contain only alphanumeric characters.

Sender 400 DBNameに数字から始まる値を指定した場合
Client.InvalidParameterFormat.DBSecurityGroupName

NiftyDBSecurityGroupName can contain only lowercase ASCII letters and digits, spaces, underscores, and hyphens.

Sender 400 NiftyDBSecurityGroupNameに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterFormat.NiftyMasterPrivateAddress

Invalid NiftyMasterPrivateAddress: aaa.bbb.ccc.ddd.

Sender 400 NiftyMasterPrivateAddressにIPアドレスとして無効な値を指定した場合
Client.InvalidParameterFormat.NiftySlavePrivateAddress

Invalid NiftySlavePrivateAddress: aaa.bbb.ccc.ddd.

Sender 400 NiftySlavePrivateAddressにIPアドレスとして無効な値を指定した場合
Client.InvalidParameterFormat.NiftyVirtualPrivateAddress

Invalid NiftyVirtualPrivateAddress: aaa.bbb.ccc.ddd.

Sender 400 NiftyVirtualPrivateAddressにIPアドレスとして無効な値を指定した場合
Client.InvalidParameterFormat.RestoreSourceDBInstanceIdentifier

The parameter SourceDBInstanceIdentifier is not a valid identifier. Identifiers must begin with a letter; must contain only lowercase ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens.

Sender 400 SourceDBInstanceIdentifierに無効な値(ハイフンで始まる 等)を指定した場合
Client.InvalidParameterFormat.RestoreTime

timestamp must follow ISO8601

Sender 400 RestoreTimeに日時以外を指定した場合
Client.InvalidParameterIllegalInput.AccountingType

Invalid Accounting Type: 3

Sender 400 AccountingTypeに1,2以外を指定した場合
Client.InvalidParameterIllegalInput.AvailabilityZone

aaa is not a valid availability zone.

Sender 400 存在しないAvailabilityZoneを指定した場合
Client.InvalidParameterIllegalInput.DBInstanceClass

Invalid DB instance class:aaa

Sender 400 DBInstanceClassに存在しないDBサーバータイプを指定した場合
Client.InvalidParameterFormat.DBParameterGroupName

The parameter NiftyDBParameterGroupName is not a valid identifier.Identifiers must begin with a letter; must contain only lowercase ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens.

Sender 400 NiftyDBParameterGroupNameに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterIllegalInput.DowngradeRestore
Sender 400 DowngradeRestoreに真偽値型でない値を指定した場合
Client.InvalidParameterIllegalInput.Engine

Invalid DB engine: aaa

Sender 400 Engineに有効でない値を指定した場合
Client.InvalidParameterIllegalInput.EngineVersion
  • MySQLの場合
    Cannot find version 5.7.32 for mysql
  • PostgreSQLの場合
    Cannot find version 13.7 for postgres
Sender 400 DBスナップショットのEngineVersionに対応していない場合
Client.InvalidParameterIllegalInput.LicenseModel
  • MySQLの場合
    Invalid license model ‘aaa’ for engine ‘mysql’. Valid license models are: general-public-license
  • PostgreSQLの場合
    Invalid license model ‘aaa’ for engine ‘postgres’. Valid license models are: postgresql-license
Sender 400 LicenseModelに無効な値を指定した場合
Client.InvalidParameterIllegalInput.MultiAZ

boolean must follow xsd1.1 definition

Sender 400 MultiAZに真偽値型でない値を指定した場合
Client.InvalidParameterIllegalInput.NiftyStorageType

Invalid Storage Type: 9

Sender 400 NiftyStorageTypeに 0,1,2,3以外を指定した場合
Client.InvalidParameterIllegalInput.Port
Sender 400 Portに数値でない値を指定した場合
Client.InvalidParameterIllegalInput.PubliclyAccessible
Sender 400 PubliclyAccessibleに真偽値型でない値を指定した場合
Client.InvalidParameterIllegalInput.UseLatestRestorableTime

boolean must follow xsd1.1 definition

Sender 400 UseLatestRestorableTimeに真偽値型でない値を指定した場合
Client.InvalidParameterMissing.AvailabilityZone

AvailabilityZone is required

Sender 400 プライベートLANを利用している時、AvailabilityZoneを指定しなかった場合
Client.InvalidParameterMissing.NiftyMasterPrivateAddress

The parameter NiftyMasterPrivateAddress must be provided and must not be blank.

Sender 400 プライベートLANを利用している時、NiftyMasterPrivateAddressを指定しなかった場合
Client.InvalidParameterMissing.NiftySlavePrivateAddress

The parameter NiftySlavePrivateAddress must be provided and must not be blank for Multi-AZ instances.

Sender 400 プライベートLANを利用している、かつ、MultiAZ=trueの時、NiftySlavePrivateAddressを指定しなかった場合
Client.InvalidParameterMissing.NiftyVirtualPrivateAddress

The parameter NiftyVirtualPrivateAddress must be provided and must not be blank.

Sender 400 プライベートLANを利用している時、NiftyVirtualPrivateAddressを指定しなかった場合
Client.InvalidParameterNotFound.AvailableDBSnapshot

The specified instance cannot be restored to a time earlier than 2017-05-01T08:53:00Z because there are no older backups available.

Sender 400 SourceDBInstanceIdentifierに指定したDBサーバーに利用可能なDBスナップショットが無い場合
Client.InvalidParameterNotFound.DBParameterGroup

NiftyDBParameterGroup not found: aaa

Sender 404 存在しないNiftyDBParameterGroupNameを指定した場合
Client.InvalidParameterNotFound.DBSecurityGroup

NiftyDBSecurityGroup not found: aaa

Sender 404 存在しないNiftyDBSecurityGroupNameを指定した場合
Client.InvalidParameterNotFound.NiftyNetworkId

Private LAN net-1234abcd does not exist.

Sender 404 プライベートLAN使用で、存在しないNiftyNetWorkIdを指定した場合
Client.InvalidParameterNotFound.RestoreSourceDBInstance

The source instance could not be found: aaa

Sender 404 SourceDBInstanceIdentifierに存在しないDBInstanceIdentifierを指定した場合
Client.InvalidParameterOutOfRange.NiftyMasterPrivateAddress

Invalid NiftyMasterPrivateAddress: 192.168.100.100. Valid range is 192.168.1.1-192.168.1.254

Sender 400 NiftyMasterPrivateAddressにサブネットの範囲外のIPアドレスを指定した場合
Client.InvalidParameterOutOfRange.NiftyMasterPrivateAddress

Invalid NiftyMasterPrivateAddress: 192.168.1.113/8. Valid CIDR prefix is /24

Sender 400 NiftyMasterPrivateAddressのプレフィックスにプライベートLAN作成時に指定したプレフィックスと異なる値を指定した場合
Client.InvalidParameterOutOfRange.NiftySlavePrivateAddress

Invalid NiftySlavePrivateAddress: 192.168.100.100. Valid range is 192.168.1.1-192.168.1.254

Sender 400 NiftySlavePrivateAddressにサブネットの範囲外のIPアドレスを指定した場合
Client.InvalidParameterOutOfRange.NiftySlavePrivateAddress

Invalid NiftySlavePrivateAddress: 192.168.1.114/8. Valid CIDR prefix is /24

Sender 400 NiftySlavePrivateAddressのプレフィックスにプライベートLAN作成時に指定したプレフィックスと異なる値を指定した場合
Client.InvalidParameterOutOfRange.NiftyVirtualPrivateAddress

Invalid NiftyVirtualPrivateAddress: 192.168.100.100. Valid range is 192.168.1.1-192.168.1.254

Sender 400 NiftyVirtualPrivateAddressにサブネットの範囲外のIPアドレスを指定した場合
Client.InvalidParameterOutOfRange.NiftyVirtualPrivateAddress

Invalid NiftyVirtualPrivateAddress: 192.168.1.112/8. Valid CIDR prefix is /24

Sender 400 NiftyVirtualPrivateAddressのプレフィックスにプライベートLAN作成時に指定したプレフィックスと異なる値を指定した場合
Client.InvalidParameterOutOfRange.Port

Invalid endpoint port: 100000. Valid range is 1150-65535

Sender 400 Portに1150-65535でない値を指定した場合
Client.InvalidParameterOutOfRange.RestoreTime

The specified instance cannot be restored to a time later than 2017-05-19T08:50:00Z

Sender 400 RestoreTimeに最新のリストア可能な時間より後の時間を指定した場合
Client.InvalidParameterOutOfRange.RestoreTime

The specified instance cannot be restored to a time earlier than 2017-05-25T08:45:00Z because its backup retention period is set to 1 days

Sender 400 バックアップ保持期間より前のデータをリストアしようとした場合
Client.InvalidParameterRequired.DBInstanceIdentifier

The parameter TargetDBInstanceIdentifier must be provided and must not be blank.

Sender 400 必須のTargetDBInstanceIdentifierを指定しなかった場合
Client.InvalidParameterRequired.RestoreSourceDBInstanceIdentifier

The parameter SourceDBInstanceIdentifier must be provided and must not be blank.

Sender 400 必須のSourceDBInstanceIdentifierを指定しなかった場合
Client.InvalidParameterTooLong.DBInstanceIdentifier

The parameter TargetDBInstanceIdentifier is not a valid identifier because it is longer than 63 characters.

Sender 400 TargetDBInstanceIdentifierに63文字を 超える値を指定した場合
Client.InvalidParameterTooLong.DBName

DBName must be less than 64 characters long.

Sender 400 DBNameに64文字を超える値を指定した場合
Client.InvalidParameterTooLong.DBParameterGroupName

The parameter NiftyDBParameterGroupName is not a valid identifier because it is longer than 255 characters.

Sender 400 NiftyDBParameterGroupNameに 255文字を超える値を指定した場合
Client.InvalidParameterTooLong.RestoreSourceDBInstanceIdentifier

The parameter SourceDBInstanceIdentifier is not a valid identifier because it is longer than 63 characters.

Sender 400 SourceDBInstanceIdentifierに63文字を超える値を指定した場合
Client.LimitExceeded.NumberOfDBInstance

Request would result in user exceeding the allowed number of DB Instances.

Sender 400 作成可能なDBサーバーの上限に達している場合
Client.ResourceInapplicable.DBInstanceNotEligibleToDowngrade

Cannot downgrade the DB Instance engine version because it is not eligible for downgrade.

Sender 400 リストア元となるDBサーバー のDBエンジンバージョン が基盤ダウングレード対象外の場合に、DowngradeRestore=trueを指定した場合
Client.ResourceInapplicable.RestoreTime

If UseLatestRestorableTime is true, the RestoreTime parameter must be omitted.

Sender 400 UseLatestRestorableTime=trueの時、RestoreTimeを指定した場合
Client.ResourceIncorrectState.DBSecurityGroup.Processing

DBSecurityGroup is not in available state.

Sender 400 設定しようとしたDBファイアウォールグループのルールに、 ステータス「authorizing」または「revoking」のルールが存在する場合
Client.ResourceIncorrectState.DBSnapshot.Unavailable

DBSnapshot must have state available but actually has creating

Sender 400 リストア元となるDBスナップショットのステータスが有効でない場合
Client.ResourceIncorrectState.RestoreSourceDBInstance.Unavailable

The specified DB Instance is not in the available state.

Sender 400 SourceDBInstanceIdentifierに指定したDBサーバーのステータスが有効でない場合
Client.ZoneMisMatch.DBInstance.and.DBSecurityGroup

NiftyDBSecurityGroup default.west-11 cannot be used in east-21 zone. The availability zone of default.west-11 is west-11.

Sender 400 指定されたゾーンと異なるゾーンに所属するDBファイアウォールグループを指定した場合
Client.ZoneMisMatch.DBInstance.and.NiftyNetworkId

Private LAN net-123456ab not belong to availability zone west-12.

Sender 400 指定されたNiftyNetworkIdが所属するゾーンと指定されたAvailabilityZoneが一致しない場合
Client.ZoneMisMatch.NiftyStorageType

Invalid Storage Type: 1

Sender 400 指定したAvailabilityZoneに存在しないストレージタイプを指定した場合

リクエストサンプル

    https://jp-east-1.rdb.api.nifcloud.com/
  ?Action=RestoreDBInstanceToPointInTime
  &SourceDBInstanceIdentifier=mydbinstance
  &TargetDBInstanceIdentifier=mydbinstancepit
  &UseLatestRestorableTime=true
  &DowngradeRestore=false
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-12-09T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

  

応答サンプル

    <RestoreDBInstanceToPointInTimeResponse>
  <RestoreDBInstanceToPointInTimeResult>
    <DBInstance>
      <AllocatedStorage>50</AllocatedStorage>
      <AutoMinorVersionUpgrade>false</AutoMinorVersionUpgrade>
      <AvailabilityZone>east-13</AvailabilityZone>
      <BackupRetentionPeriod>1</BackupRetentionPeriod>
      <CACertificateIdentifier>rdb-ca-2023</CACertificateIdentifier>
      <DBInstanceClass>db.small</DBInstanceClass>
      <DBInstanceIdentifier>mydbinstancepit</DBInstanceIdentifier>
      <DBInstanceStatus>creating</DBInstanceStatus>
      <DBInstanceUpgradeStatus>latest</DBInstanceUpgradeStatus>
      <DBName>mydb</DBName>
      <DBParameterGroups>
        <DBParameterGroup>
          <DBParameterGroupName>default.mysql5.6</DBParameterGroupName>
          <ParameterApplyStatus>in-sync</ParameterApplyStatus>
        </DBParameterGroup>
      </DBParameterGroups>
      <DBSecurityGroups>
        <DBSecurityGroup>
          <DBSecurityGroupName>default.east-13</DBSecurityGroupName>
          <Status>active</Status>
        </DBSecurityGroup>
      </DBSecurityGroups>
      <Engine>mysql</Engine>
      <EngineVersion>5.6.12</EngineVersion>
      <LicenseModel>general-public-license</LicenseModel>
      <MasterUsername>mydbuser</MasterUsername>
      <MultiAZ>true</MultiAZ>
      <OptionGroupMemberships>
        <OptionGroupMembership>
          <OptionGroupName>default:mysql-5-6</OptionGroupName>
          <Status>in-sync</Status>
        </OptionGroupMembership>
      </OptionGroupMemberships>
      <PendingModifiedValues/>
      <PreferredBackupWindow>05:30:00-06:00:00</PreferredBackupWindow>
      <PreferredMaintenanceWindow>mon:06:01:00-mon:07:31:00</PreferredMaintenanceWindow>
      <PubliclyAccessible>true</PubliclyAccessible>
      <ReadReplicaDBInstanceIdentifiers/>
      <ReadReplicaSourceDBInstanceIdentifier/>
      <SecondaryAvailabilityZone>east-13</SecondaryAvailabilityZone>
      <NiftyStorageType>0</NiftyStorageType>
      <AccountingType>2</AccountingType>
      <NextMonthAccountingType>2</NextMonthAccountingType>
    </DBInstance>
  </RestoreDBInstanceToPointInTimeResult>
  <ResponseMetadata>
    <RequestId>7799796f-24ad-4f89-955b-fdceec44038e</RequestId>
  </ResponseMetadata>
</RestoreDBInstanceToPointInTimeResponse>

  

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2024年11月18日時点の情報です。

推奨画面サイズ 1024×768 以上