すべてのプロダクト
Search

このプロダクト

    :ApsaraDB RDSインスタンスの仕様の変更

    ドキュメントセンター

    :ApsaraDB RDSインスタンスの仕様の変更

    最終更新日:Mar 07, 2025

    ModifyDBInstanceSpec操作を呼び出して、ApsaraDB RDSインスタンスのインスタンスタイプまたはストレージ容量を変更できます。 この操作は、プライマリインスタンスと読み取り専用インスタンスでサポートされています。 この操作は、ディザスタリカバリインスタンスまたは一時インスタンスではサポートされていません。

    この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。

    • インスタンスのステータスは [実行中] です。
    • インスタンスには進行中のバックアップタスクがありません。
    • DBInstanceClassパラメーターとDBInstanceStorageパラメーターの少なくとも1つがリクエストに指定されています。
    • ストレージ容量を削減する場合、指定した新しいストレージ容量は使用ストレージの1.1倍以上になります。
    • インスタンスはプライマリインスタンスまたは読み取り専用インスタンスです。
    説明 インスタンスのRDSエディションをアップグレードする場合は、新しいRDSエディションをサポートするインスタンスタイプのみを選択する必要があります。 たとえば、インスタンスのRDSエディションをRDS Basic editionからRDS High-availability Editionにアップグレードする場合は、RDS High-availability Editionをサポートするインスタンスタイプのみを選択する必要があります。

    デバッグ

    OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

    リクエストパラメーター

    項目 データ型 必須／任意 例: 説明　
    操作 String 必須 ModifyDBInstanceSpec

    実行する操作です。 値をModifyDBInstanceSpecに設定します。

    DBInstanceId String 必須 rm-uf6wjk5 *******

    インスタンスの ID です。

    DBInstanceClass String 任意 rds.mys2.small

    インスタンスの新しいインスタンスタイプ。 詳細については、「プライマリApsaraDB RDSインスタンスタイプ」をご参照ください。 DescribeAvailableClasses操作を呼び出して、リージョンで使用可能なインスタンスタイプを照会できます。

    説明
    • DBInstanceClassパラメーターとDBInstanceStorageパラメーターの少なくとも1つを指定する必要があります。
    • DescribeDBInstanceAttributeを呼び出して、インスタンスの使用中のインスタンスタイプを照会できます。
    DBInstanceStorage Integer いいえ 20

    インスタンスの新しいストレージ容量。 単位 : GB 5 GBのステップサイズでストレージ容量を増やすことができます。 詳細については、「プライマリApsaraDB RDSインスタンスタイプ」をご参照ください。 DescribeAvailableClasses操作を呼び出して、インスタンスタイプでサポートされているストレージ容量の範囲を照会できます。

    説明
    • DBInstanceStorageパラメーターとDBInstanceClassパラメーターの少なくとも1つを指定する必要があります。
    • インスタンスがローカルSSDを使用してRDS High-availability EditionでMySQLを実行している場合、5 GBのステップサイズでストレージ容量を減らすことができます。
    • DescribeDBInstanceAttributeを呼び出して、インスタンスの現在のストレージ容量を照会できます。
    PayType String 必須 Postpaid

    インスタンスの課金方法です。 有効な値：

    • 後払い: 従量課金
    • プリペイド: サブスクリプション
    EffectiveTime String 任意 MaintainTime

    仕様を適用する時刻が変更されます。 有効な値：

    • Immediate: 仕様の変更はすぐに適用されます。
    • MaintainTime: 指定されたメンテナンス期間中に仕様の変更が適用されます。 詳細については、「ModifyDBInstanceMaintainTime」をご参照ください。

    デフォルト値: Immediate。

    EngineVersion String 任意 5.6

    インスタンスのデータベースエンジンバージョンです。

    • MySQLの有効な値: 5.5、5.6、5.7、および8.0
    • SQL Serverの有効な値: 2008r2、08r2_ent_ha、2012、2012_ent_ha、2012_std_ha、2012_web、2014_std_ha、2016_ent_ha、2016_std_ha、2016_web、2017_std_ha、2017_ent、2019_std_ha、および2019_ent
    • PostgreSQLの有効な値: 10.0、11.0、12.0、13.0、および14.0
    • MariaDB TXの有効な値: 10.3
    DBInstanceStorageType String 任意 local_ssd

    インスタンスに使用されるストレージタイプ。 有効な値：

    • local_ssd: ローカルssd。
    • cloud_ssd: 標準ssd。 このストレージタイプは推奨されず、一部のAlibaba Cloudリージョンでは使用できません。
    • cloud_essd: パフォーマンスレベル1 (PL1) の拡張SSD (essd) 。
    • cloud_essd2: PL2のESSD。
    • cloud_essd3: PL3のESSD。

    ストレージタイプを変更するには、次の情報に注意してください。

    • インスタンスがPostgreSQLを実行している場合、インスタンスのストレージタイプを標準SSDからESSDにアップグレードできます。 ただし、インスタンスのストレージタイプをESSDから標準SSDにダウングレードすることはできません。 ESSDは、次のパフォーマンスレベル (PL) を提供します。PL1のESSD、PL2のESSD、およびPL3のESSD。 PL1のESSD、PL2のESSD、およびPL3のESSD間でストレージタイプをアップグレードまたはダウングレードできます。 詳細については、「設定項目」をご参照ください。
    方向 String 任意 アップ

    インスタンスで実行する変更のタイプ。 有効な値：

    • アップ: サブスクリプションインスタンスをアップグレードするか、従量課金インスタンスをアップグレードまたはダウングレードします。
    • Down: サブスクリプションインスタンスをダウングレードします。
    • TempUpgrade: サブスクリプションインスタンスの仕様を自動的に変更します。 この値は、自動仕様変更に必要です。
    説明
    • デフォルト値: Up。
    • DBInstanceStorageTypeパラメーターのみを指定する場合は、Directionパラメーターを空のままにすることができます。 たとえば、インスタンスのストレージタイプのみを標準SSDからESSDに変更する場合、Directionパラメーターを指定する必要はありません。
    SourceBiz String 任意 N/A

    非推奨のパラメーター。

    DedicatedHostGroupId String 任意 dhg-7a9 ********

    専用クラスターのID。

    ZoneId String 任意 cn-hangzhou-d

    インスタンスのゾーン ID。

    SwitchTime String 任意 2019-07-10T13:15:12Z

    仕様を変更する時刻。 オフピーク時に仕様を変更することを推奨します。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

    説明
    • 現在の時刻より後の時刻を指定する必要があります。これは、この操作を呼び出す時刻を指します。 それ以外の場合、仕様変更タスクは失敗します。 仕様変更タスクが失敗した場合は、注文が自動的にキャンセルされるのを待ってから、この操作を再度呼び出す必要があります。
    • 仕様の変更にストレージ容量の増加または異なるPL間のESSDストレージタイプの変更のみが含まれる場合、仕様の変更はすぐに有効になり、ワークロードには影響しません。 このパラメーターを設定する必要はありません。
    ResourceGroupId String 任意 rg-acfmy **********

    インスタンスが属するリソースグループの ID 。

    UsedTime Long いいえ 3

    ApsaraDB RDS for SQL Serverインスタンスで仕様の有効期間が変更されます。 有効期間の終了時に、インスタンスの仕様は、エラスティックアップグレードが実行される前に使用されていた仕様に復元されます。 単位：日

    MaxCapacity double いいえ 8

    Rds Capacity Unit (RCU) の最大値。

    MinCapacity double いいえ 0.5

    RCUの最小値。

    自動一時停止 Boolean いいえ 真実

    自動停止をサポートするかどうかを指定します。

    カテゴリー String 任意 高可用性

    インスタンスのRDSエディション。 有効な値：

    • 基本: RDS Basicエディション。
    • 高可用性: RDS高可用性エディション。
    • AlwaysOn: RDS Cluster Edition。
    • ファイナンス: RDS Enterprise Edition。 このエディションは、中国のサイト (aliyun.com) でのみ利用できます。
    説明 EngineVersionパラメーターをSQL Serverのバージョンに設定した場合は、このパラメーターも指定する必要があります。

    レスポンスパラメーター

    項目 データ型 例: 説明　
    DBInstanceId String rm-uf6wjk5 *******

    インスタンスの ID です。

    RequestId String 3C5CFDEE-F774-4DED-89A2-1D76EC63C575

    リクエストの ID です。

    OrderId Long 20793850608 ****

    注文 ID。

    例

    リクエストの例

    http(s):// rds.aliyuncs.com/?Action=ModifyDBInstanceSpec
&DBInstanceId=rm-uf6wjk5 *******
&PayType=後払い
&DBInstanceClass=rds.mys2.small
&<共通リクエストパラメーター>

    正常に処理された場合のレスポンス例

    XML 形式

    HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDBInstanceSpecResponse>
    <RequestId>3C5CFDEE-F774-4DED-89A2-1D76EC63C575</RequestId>
    <DBInstanceId>rm-uf6wjk5 *******</DBInstanceId>
    <OrderId>20793850608 ****</OrderId>
</ModifyDBInstanceSpecResponse>

    JSON 形式

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "3C5CFDEE-F774-4DED-89A2-1D76EC63C575" 、
  "DBInstanceId" : "rm-uf6wjk5 ********" 、
  "OrderId" : "20793850608 ****"
}

    エラーコード

    HTTP ステータスコード エラーコード エラーメッセージ 説明　
    400 CannotDecreaseEssdPerfLevel cloud essdのパフォーマンスレベルを下げることはできません。 ストレージタイプの変更が許可されていない場合に返されるエラーメッセージ。 標準SSDでSQL Serverを実行するインスタンスのストレージタイプは、ESSDにのみ変更できます。 ローカルSSDでSQL Serverを実行するインスタンスのストレージタイプは、標準SSDまたはESSDに変更できます。
    400 InvalidEssdStorageSize 無効なcloud essdストレージサイズ。 指定されたストレージ容量が無効な場合に返されるエラーメッセージ。 有効なストレージ容量を選択して再試行する必要があります。
    400 NotSupportReduceDiskSize ディスクサイズの縮小をサポートしていません。 インスタンスのストレージ容量を減らすことができない場合に返されるエラーメッセージ。
    400 INST_HAS_UNPAID_ORDER 指定されたインスタンスには未払いの注文があります。 インスタンスに未払いの注文がある場合に返されるエラーメッセージ。 この操作を呼び出す前に、注文の支払いが必要です。
    400 InvalidDBInstanceClass.NotFound 指定された DB インスタンスクラスが見つかりません。 新しいインスタンスタイプが見つからないか、購入できなくなった場合に返されるエラーメッセージ。 使用可能なインスタンスタイプを選択する必要があります。
    400 InvalidAvZone. フォーマット 指定されたAvZoneは無効です。 AvZoneパラメーターの値が無効な場合に返されるエラーメッセージ。
    400 OperationDenied.OrderUnPaid 注文ステータス (未払い) が間違っているため、操作は許可されません。 未払いの注文がある場合に返されるエラーメッセージ。 この操作を呼び出す前に、注文の支払いが必要です。
    400 OperationDenied.InvalidStorageSize ストレージサイズの制限を超えています。 新しいストレージ容量が上限を超えた場合に返されるエラーメッセージ。 ディスク領域をクリアまたは拡張する必要があります。
    400 InsufficientResourceCapacity インスタンスクラスターはこの操作をサポートしていません。 インスタンスが属する専用クラスターで操作がサポートされていない場合に返されるエラーメッセージ。
    400 InvalidUsedTime パラメーターusedTimeが無効です。 UsedTimeパラメーターの値が無効な場合に返されるエラーメッセージ。
    400 CannotChangeStorageType 一時アップグレードでは、ストレージタイプの変更はサポートされません。 エラスティックアップグレードがストレージタイプの変更をサポートしていない場合に返されるエラーメッセージ。
    400 TempUpgrade.NotSupport インスタンスは一時アップグレードをサポートしていません。 インスタンスがエラスティックアップグレードをサポートしていない場合に返されるエラーメッセージ。
    400 EngineNotSupported 指定されたエンジンは操作をサポートできません。 この操作がインスタンスで実行されているデータベースエンジンでサポートされていない場合に返されるエラーメッセージ。 マイナーエンジンのバージョンを更新する必要があります。
    400 MaxscaleNotSupport Maxscaleがサポートされていません インスタンスがデータベースプロキシ機能をサポートしていない場合に返されるエラーメッセージ。 指定したデータベースプロキシ構成を確認する必要があります。
    400 ADInstanceNotSupportThisOperation ADインスタンスはこの操作をサポートしていません Active Directory (AD) ドメインに追加されたインスタンスで操作がサポートされていない場合に返されるエラーメッセージ。
    400 BYOKInstanceNotSupportThisOperation BYOKインスタンスはこの操作をサポートしていません ディスク暗号化が有効になっているインスタンスでは、操作がサポートされていない場合に返されるエラーメッセージ。
    400 BYOLInstanceNotSupportThisOperation BYOLインスタンスはこの操作をサポートしていません Bring Your Own License (BYOL) を使用するインスタンスで操作がサポートされていない場合に返されるエラーメッセージ。
    400 SSLInstanceNotSupportThisOperation SSLを開いたインスタンス、アップグレードはこの操作ではありません SSL暗号化機能が有効になっているインスタンスでは、操作がサポートされていない場合に返されるエラーメッセージ。
    400 TDEInstanceNotSupportThisOperation インスタンスがTDEを開きました。この操作はサポートされていません 透過的データ暗号化 (TDE) 機能が有効になっているインスタンスでは、操作がサポートされていない場合に返されるエラーメッセージ。
    400 InstanceIsSnapshotBackupNotSupportThisOperation インスタンスのバックアップ方法はスナップショットバックアップです。この操作はサポートされていません スナップショットバックアップ機能が有効になっているインスタンスでは、操作がサポートされていない場合に返されるエラーメッセージ。
    400 InstanceHasReadOnlyInstanceNotSupportThisOperation インスタンスに読み取り専用インスタンスがあるか、読み取り専用インスタンスです。この操作はサポートされていません 読み取り専用インスタンスまたは読み取り専用インスタンスがアタッチされているインスタンスで操作がサポートされていない場合に返されるエラーメッセージ。
    400 IncorrectDBInstanceState Current DB instance state does not support this operation. インスタンスが現在の状態の場合、この操作がサポートされていない場合に返されるエラーメッセージ。
    403 IncorrectDBInstanceType データベースインスタンスタイプは操作をサポートしていません。 インスタンスで実行されているデータベースエンジンで操作がサポートされていない場合に返されるエラーメッセージ。
    403 OperationDenied.NotSupportedBackupMethod ストレージが4000 GBを超える場合、スナップショットバックアップのみがサポートされます。 ストレージ容量が4,000 GBを超え、スナップショットバックアップのみがサポートされている場合に返されるエラーメッセージ。
    403 IncorrectReadDBInstanceDisksize 読み取りインスタンスのディスクサイズは、プライマリインスタンス以上である必要があります。 読み取り専用インスタンスのストレージ容量がプライマリインスタンスのストレージ容量よりも小さい場合に返されるエラーメッセージ。 読み取り専用インスタンスのストレージ容量がプライマリインスタンスのストレージ容量以上であることを確認します。

    エラーコードリストについては、「API エラーセンター」をご参照ください。