本文へジャンプします。

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

2024年4月1日をもって、「ニフクラ」は、「FJcloud-V」に統合し、名称を変更しました。
「ニフクラ」「NIFCLOUD」「nifcloud」は、「FJcloud-V」に読み替えていただきますようお願いいたします。

ニフクラ ユーザーガイド

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

UpgradeDBEngineVersion

処理概要

DBサーバーのデータベースエンジンのバージョンをアップグレードします。

アップグレード可能なバージョンはDescribeDBEngineVersions APIから取得できます。

MySQLの場合、かつ、リードレプリカが存在する場合は、マスターより先に全てのリードレプリカをアップグレードする必要があります。

アップグレードが成功した場合、元のバージョンに戻すことはできません。

必要に応じてPreUpgradeDBSnapshotIdentifierを指定し、アップグレード前のDBスナップショットを作成してください。

指定するパラメーター

パラメーター 型 説明 必須
AllowMajorVersionUpgrade boolean メジャーアップグレードを許可するかどうか
Default: False
DBInstanceIdentifier string DBサーバー名
 ○
DBParameterGroupName string

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

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

アップグレード前にDBスナップショットを作成する場合のDBスナップショット名

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

 ○ (SkipPreUpgradeSnapshotがfalseの場合)
SkipPreUpgradeSnapshot boolean アップグレード前にDBスナップショットの作成をスキップするかどうか
Default: False

応答フィールド

フィールド (項目) 型 説明
UpgradeDBEngineVersionResponse structure ルート
␣UpgradeDBEngineVersionResult 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エンジンが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 翌月の利用料金タイプ
␣␣Marker string

前のリクエストで提供されるページを表す文字列（ページング用）

  • この値が指定された場合、レスポンスでマーカーを超えたレコードが最大MaxRecord個返される
␣ResponseMetadata structure 共通メタ情報
␣␣RequestId string リクエスト識別子

エラー

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

Cannot upgrade mysql from 5.7.15 to 5.6.34.

 Sender 400 アップグレード対象外のEngineVersionを指定した場合
Client.InvalidParameterCombination.DBParameterGroupFamily.and.DBParameterGroup

The Parameter Group default.mysql5.6 with DBParameterGroupFamily mysql5.1 cannot be used for this instance. Please use a Parameter Group with DBParameterGroupFamily mysql5.7

 Sender 400 DBサーバーのDBParameterGroupFamilyと異なるDBパラメーターグループを指定した場合
Client.InvalidParameterCombination.EngineVersion.and.AllowMajorVersionUpgrade

The AllowMajorVersionUpgrade flag must be present when upgrading to a new major version.

 Sender 400 AllowMajorVersionUpgrade=falseの時、メジャーアップグレードのEngineVersionを指定した場合
Client.InvalidParameterDuplicate.DBSnapshotIdentifier

Cannot create the snapshot because a snapshot with the identifier sample-snapshot already exists.

 Sender 400 すでに存在するDBSnapshotIdentifierを指定した場合
Client.InvalidParameterFormat.DBInstanceIdentifier

The parameter DBInstanceIdentifier 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 DBInstanceIdentifierに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterFormat.DBParameterGroupName

The parameter DBParameterGroupName 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 DBParameterGroupNameに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterFormat.DBSnapshotIdentifier

The parameter PreUpgradeDBSnapshotIdentifier 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 PreUpgradeDBSnapshotIdentifierに無効な値(ハイフンから始まる 等)を指定した場合
Client.InvalidParameterIllegalInput.AllowMajorVersionUpgrade
Sender 400 AllowMajorVersionUpgradeにBoolean型以外の値を指定した場合
Client.InvalidParameterIllegalInput.SkipPreUpgradeSnapshot
Sender 400 SkipPreUpgradeSnapshotにBoolean型以外の値を指定した場合
Client.InvalidParameterNotFound.DBInstance

DBInstance aaa not found.

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

DBParameterGroup not found: aaa

 Sender 404 存在しないDBParameterGroupNameを指定した場合
"default."で始まり、"default."より後の値がEngine及びEngineVersionに紐づくDBパラメーターグループファミリと一致しない場合
例) Engine=mysql、EngineVersion=5.6.34、DBパラメータファミリ=mysql5.6の場合
⇒「default.mysql5.6」以外で「default.～」形式の場合はエラー
Client.InvalidParameterMissing.DBSnapshotIdentifier

PreUpgradeDBSnapshotIdentifier is required unless SkipPreUpgradeSnapshot is specified.

 Sender 400 SkipPreUpgradeSnapshot=falseの時、PreUpgradeDBSnapshotIdentifierを指定しなかった場合
Client.InvalidParameterRequired.DBInstanceIdentifier

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

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

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

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

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

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

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

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

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

 Sender 400 PreUpgradeDBSnapshotIdentifierに255字を超える値を指定した場合
Client.LimitExceeded.NumberOfDBSnapshot

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

 Sender 400 作成可能なDBスナップショットの上限に達している場合
Client.ResourceInapplicable.DBSnapshotIdentifier

Only one of SkipPreUpgradeSnapshot and PreUpgradeDBSnapshotIdentifier can be specified.

 Sender 400 SkipPreUpgradeSnapshot=trueの時、PreUpgradeDBSnapshotIdentifierを指定した場合
Client.ResourceInapplicable.DBSnapshotIdentifier

PreUpgradeDBSnapshotIdentifier can not be specified when upgrading a replica instance.

 Sender 400 リードレプリカをアップグレードしようとした時、PreUpgradeDBSnapshotIdentifierを指定した場合
Client.ResourceIncorrectState.DBInstance.CannotUpgrade

Cannot upgrade because it is DB Engine ‘postgres’ with read replicas.

 Sender 400 Engine=postgresの時、リードレプリカをもつDBサーバーを指定した場合
Client.ResourceIncorrectState.DBInstance.CannotUpgrade

Cannot upgrade because it is a read replica for DB Engine ‘postgres’.

 Sender 400 Engine=postgresの時、リードレプリカを指定した場合
Client.ResourceIncorrectState.DBInstance.CannotUpgrade

Cannot upgrade because it is different from the master DB instance engine version.

 Sender 400 マスターDBサーバーと異なるエンジンバージョンのリードレプリカをアップグレードした場合
Client.ResourceIncorrectState.DBInstance.CannotUpgrade

One or more of the DB Instance’s read replicas need to be upgraded: replica-db-server.

 Sender 400 リードレプリカより先にマスターDBサーバーをアップグレードした場合
Client.ResourceIncorrectState.DBInstance.Unavailable

The specified DB Instance is not in the available state.

 Sender 400 DBサーバーのステータスが有効でない場合
Client.ResourceIncorrectState.DBInstanceUpgradeStatus.Processing

Can not be specified when the upgrade status of the specified DB Instance is progress.

 Sender 400 DBサーバーの基盤アップグレードステータスが処理中（「required」、「latest」以外）の場合
Client.ResourceIncorrectState.ReadReplicaSourceDBInstance.Unavailable

The master DB instance relevant to specified readreplica DB instance is not the available.

 Sender 400 リードレプリカをアップグレードする時、マスターDBサーバーのステータスが有効でない場合
Client.ResourceIncorrectState.ReadReplica.Unavailable

The readreplica DB instance relevant to specified master DB instance is not the available.

 Sender 400 マスターDBサーバーをアップグレードする時、リードレプリカのステータスが有効でない場合

リクエストサンプル

    https://jp-east-1.rdb.api.nifcloud.com/
  ?Action=UpgradeDBEnginversion
  &DBInstanceIdentifier=mydbinstance
  &AllowMajorVersionUpgrade=true
  &DBParameterGroupName=mydbparameter57
  &EngineVersion=5.7.15
  &PreUpgradeDBSnapshotIdentifier=preupgrademydbsnapshot
  &SkipPreUpgradeSnapshot=false
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-12-09T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

応答サンプル

    <UpgradeDBEnginversionResponse>
  <UpgradeDBEnginversionResult>
    <DBInstance>
      <AllocatedStorage>50</AllocatedStorage>
      <AutoMinorVersionUpgrade>false</AutoMinorVersionUpgrade>
      <AvailabilityZone>east-13</AvailabilityZone>
      <BackupRetentionPeriod>1</BackupRetentionPeriod>
      <CACertificateIdentifier>rdb-ca-2023</CACertificateIdentifier>
      <DBInstanceClass>db.small</DBInstanceClass>
      <DBInstanceIdentifier>mydbinstance</DBInstanceIdentifier>
      <DBInstanceStatus>modifying</DBInstanceStatus>
      <DBInstanceUpgradeStatus>latest</DBInstanceUpgradeStatus>
      <DBName>mydb</DBName>
      <DBParameterGroups>
        <DBParameterGroup>
          <DBParameterGroupName>default.mysql5.6</DBParameterGroupName>
          <ParameterApplyStatus>in-sync</ParameterApplyStatus>
        </DBParameterGroup>
      </DBParameterGroups>
      <DBSecurityGroups>
        <DBSecurityGroup>
          <DBSecurityGroupName>mydbsecuritygroup</DBSecurityGroupName>
          <Status>active</Status>
        </DBSecurityGroup>
      </DBSecurityGroups>
      <Endpoint>
        <Port>3306</Port>
        <Address>XXX.XXX.XXX.XXX</Address>
        <NiftyPrivateAddress>YYY.YYY.YYY.YYY</NiftyPrivateAddress>
      </Endpoint>
      <Engine>mysql</Engine>
      <EngineVersion>5.6.12</EngineVersion>
      <ExternalReplicationInfo>
        <ReplicationAddresses>
          <ReplicationAddress>xxx.xxx.xxx.xxx</ReplicationAddress>
          <ReplicationAddress>yyy.yyy.yyy.yyy</ReplicationAddress>
        </ReplicationAddresses>
        <ReplicationPrivateAddresses>
          <ReplicationPrivateAddress>xxx.xxx.xxx.xxx</ReplicationPrivateAddress>
          <ReplicationPrivateAddress>yyy.yyy.yyy.yyy</ReplicationPrivateAddress>
        </ReplicationPrivateAddresses>
      </ExternalReplicationInfo>
      <InstanceCreateTime>2013-11-30T06:28:42.000Z</InstanceCreateTime>
      <LatestRestorableTime>2013-11-30T06:40:00.000Z</LatestRestorableTime>
      <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-06:00</PreferredBackupWindow>
      <PreferredMaintenanceWindow>mon:06:01-mon:07:31</PreferredMaintenanceWindow>
      <PubliclyAccessible>true</PubliclyAccessible>
      <SecondaryAvailabilityZone>east-13</SecondaryAvailabilityZone>
      <VpcSecurityGroups/>
      <NiftyStorageType>0</NiftyStorageType>
      <AccountingType>2</AccountingType>
      <NextMonthAccountingType>2</NextMonthAccountingType>
    </DBInstance>
  </UpgradeDBEnginversionResult>
  <ResponseMetadata>
    <RequestId>4838a0d1-e2ff-4da9-b675-0e3f9eb21c10</RequestId>
  </ResponseMetadata>
</UpgradeDBEnginversionResponse>

ニフクラ サイト内検索

APIメニュー

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

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

ページの先頭へ