この API を使用して、RDS MySQL および RDS PostgreSQL のメジャーバージョンアップグレードの事前チェックレポートを取得します。
操作説明
適用エンジン
RDS MySQL
RDS PostgreSQL
機能ドキュメント
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| DBInstanceId |
string |
必須 |
インスタンス ID。 |
pgm-bp1c808s731l**** |
| PageSize |
integer |
任意 |
チェックレポートの 1 ページあたりのエントリ数。 有効な値：
|
30 |
| PageNumber |
integer |
任意 |
チェックレポートのページ番号。 値は 0 より大きい整数である必要があります。デフォルト値：1。 |
1 |
| TargetMajorVersion |
string |
任意 |
インスタンスのターゲットメジャーエンジンバージョン。ターゲットメジャーエンジンバージョンは、現在のメジャーエンジンバージョンより新しい必要があります。 |
12.0 |
| TaskId |
integer |
任意 |
事前チェックタスク ID。 |
416980000 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
返されるパラメーターの詳細。 |
||
| RequestId |
string |
リクエスト ID。 |
D1586777-41B5-5F9E-81E8-93DFDD379024 |
| PageNumber |
integer |
ページ番号。 |
1 |
| PageRecordCount |
integer |
1 ページあたりのエントリ数。 |
30 |
| TotalRecordCount |
integer |
返されたエントリの総数。 |
1 |
| Items |
array<object> |
メジャーエンジンバージョンアップグレードの事前チェックレポート。 |
|
|
object |
メジャーエンジンバージョンアップグレードの事前チェックレポートの詳細。 |
||
| TargetMajorVersion |
string |
アップグレード先のインスタンスのメジャーエンジンバージョン。 |
12.0 |
| EffectiveTime |
string |
事前チェックレポートの有効期限。 時刻は、yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 規格に準拠しています。時刻は協定世界時 (UTC) で表示されます。 |
1635748703000 |
| SourceMajorVersion |
string |
インスタンスの元のメジャーエンジンバージョン。 |
11.0 |
| Result |
string |
メジャーエンジンバージョンアップグレードの事前チェックの結果。 有効な値：
説明
このパラメーターの値が Fail の場合は、Detail パラメーターの値を確認して問題を解決し、事前チェックを再度実行する必要があります。一般的な問題と解決策の詳細については、「ApsaraDB RDS for PostgreSQL インスタンスのチェックレポートの概要」をご参照ください。 |
Success |
| TaskId |
integer |
メジャーエンジンバージョンアップグレードの事前チェックタスクの ID。 |
416980000 |
| Detail |
string |
メジャーエンジンバージョンアップグレードの事前チェックレポートの内容。 |
[user_check_report]User check success\n[pg_upgrade_internal.log]Performing... |
| CheckTime |
string |
事前チェックが実行された時刻。 時刻は、yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 規格に準拠しています。時刻は協定世界時 (UTC) で表示されます。 |
1635143903000 |
| RecommendDiskSize |
integer |
アップグレードに必要な最小ストレージ容量。単位：GB。 説明
このパラメーターは、ApsaraDB RDS for PostgreSQL インスタンスの場合にのみ返されます。 |
100 |
| RecommendLeastMemSize |
integer |
アップグレードに必要な最小メモリ。単位：GB。 説明
このパラメーターは、ApsaraDB RDS for PostgreSQL インスタンスの場合にのみ返されます。 |
8 |
| RecommendMemSize |
integer |
アップグレードに推奨されるメモリサイズ。単位：GB。 インスタンスのメモリサイズが推奨メモリサイズ以上の場合、アップグレードは最大速度で実行され、インスタンスの読み取り専用時間が最小限に抑えられます。 説明
このパラメーターは、ApsaraDB RDS for PostgreSQL インスタンスの場合にのみ返されます。 |
32 |
| UpgradeMode |
string |
例
成功レスポンス
JSONJSON
{
"RequestId": "D1586777-41B5-5F9E-81E8-93DFDD379024",
"PageNumber": 1,
"PageRecordCount": 30,
"TotalRecordCount": 1,
"Items": [
{
"TargetMajorVersion": "12.0",
"EffectiveTime": "1635748703000",
"SourceMajorVersion": "11.0",
"Result": "Success",
"TaskId": 416980000,
"Detail": "[user_check_report]User check success\\n[pg_upgrade_internal.log]Performing...",
"CheckTime": "1635143903000",
"RecommendDiskSize": 100,
"RecommendLeastMemSize": 8,
"RecommendMemSize": 32,
"UpgradeMode": ""
}
]
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidDBInstanceName.NotFound | The specified DB instance name does not exist. | |
| 400 | Order.ComboInstanceNotAllowOperate | A package instance is not allowed to operate independently. | |
| 400 | Price.PricingPlanResultNotFound | Pricing plan price result not found. | |
| 400 | Order.NoRealNameAuthentication | You have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication. | |
| 400 | InsufficientAvailableQuota | Your account quota limit is less than 0, please recharge before trying to purchase. | |
| 400 | CommodityServiceCalling.Exception | Failed to call commodity service. | |
| 400 | RegionDissolvedEOM | Dear customer, Alibaba Cloud plans to optimize and adjust the current region. Cloud services in this region will cease operations. You are currently unable to operate new purchase orders. Thank you for your understanding and support. | |
| 400 | Commodity.InvalidComponent | The module you purchased is not legal, please buy it again. | |
| 400 | RegionEndTimeDissolvedAustralia | Cloud services in the Australia (Sydney) region will be discontinued. Set the validity date to September 30, 2024 or earlier than September 30, 2024. | |
| 400 | Price.CommoditySys | Commodity system call exception. | |
| 400 | Pay.InsufficientBalance | Insufficient available balance. | |
| 400 | Order.PeriodInvalid | There is a problem with the period you selected, please choose again. | |
| 400 | pay.noCreditCard | Account not bound to credit card. | |
| 400 | Order.InstHasUnpaidOrder | There is an unpaid order for the service you have purchased. Please pay or void it before placing the order. | |
| 400 | noAvailablePaymentMethod | No payment method is specified for your account. We recommend that you add a payment method. | |
| 400 | BasicInfoUncompleted | Your information is incomplete. Complete your information before the operation. | |
| 400 | Risk.RiskControlRejection | Your account is abnormal, please contact customer service for details. | |
| 400 | Api.NotSupport | Specified api is not supported. | |
| 400 | ContainForbiddenLabelError | There is a label that prohibits placing orders. Please contact your distributor for assistance. | |
| 400 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in records. | |
| 400 | InvalidInstanceLevel.DiskType | Specified instance level not support request disk type | |
| 400 | InvalidParam | Sepcified wal level Parameter is invalid. There are still logical slots in instance, so it can not be set as replica. | |
| 400 | KmsApiError | User secret key invalid. | |
| 400 | System.SaleValidateFailed | Sales expression validation system error. | |
| 400 | Abs.InvalidAccount.NotFound | account is not found. | |
| 400 | SqlExecuteFailedOrTimeout | sql command execution failed or timed out:%s. | |
| 400 | ColdData.EngineVersionNotSupport | The current instance engine version not support coldDataEnabled. | |
| 400 | ColdData.MinorVersionNotSupport | The current instance minor version not support coldDataEnabled. | |
| 400 | IncorrectTargetClasscode | The current instance type does not support this operation. | |
| 400 | InvalidConnectionString.Duplicate | Specified connection string already exists in the RDS. | |
| 400 | RequiredParam.NotFound | Required input param is not found. | |
| 400 | Parameters.Invalid | Parameter error, please check the parameters. | |
| 400 | BackupPolicyNotSupport | Cold Data won't open with CrossBackup or Flash Backup, please check Backup Policy. | |
| 400 | InvalideStatus.Format | The instance status does not support this operation. | |
| 400 | InvalidReleasedKeepPolicy.Format | Specified Released Keep Policy is not valid. | |
| 400 | InvalidDBInstanceEngineType.Format | the DB instance engine type does not support this operation. | |
| 400 | Pay.NoCreditCard | No credit cards. | |
| 400 | VpcNetworkTypeNotSupport | The vpc network type instance does not support this operation. | |
| 400 | MirrorInsExists | Specified DB instance mirror ins already existed. | |
| 400 | UnsupportedClassCode | The specified DB instance class stops selling. | |
| 400 | InvalidBackupSet | The specified database does not exist in the backup set. | |
| 400 | OrdTCommodityQueryError | Failed to query for product. | |
| 400 | ProductInstanceReleased | The instance has been released. Please check before placing the order. | |
| 400 | RegionEndTimeDissolvedIndia | The region is no longer supported. | |
| 500 | ExternalFailure | The request processing has failed due to external service failure. | |
| 500 | RequestMetaDataFailed | The service request failed. Please try again later or contact service personnel. | |
| 500 | InvokeProxyFailure | The request processing has failed due to service failure of rds api. | |
| 403 | OrderStatus.UnPaid | The specified db instance has unpaid order. | |
| 403 | InvalidReduceDiskSize | The storage capacity after the scale-down must be larger than the used amount. | |
| 403 | CloudSSDNotSupport | Cloud ssd does not support this operation, please upgrade to essd. | |
| 403 | InvalidUserOperatorPermission | The user permission does not support this operation. | |
| 403 | InvalidVswitchId | Specified conn vswitch id is not valid. | |
| 403 | IncorrectMinorVersion | Current engine minor version does not support operations. | |
| 403 | OperationDenied.ZoneResource | There is no available zone for inventory. | |
| 403 | NotInFlowController | Sorry,no permission. | |
| 403 | InvalidKmsKey | Kms key is disabled. | |
| 403 | InvalidInstanceLevel.Malformed | Current DB instance level does not support this operation. | |
| 404 | InvalidClusterKms | The current instance does not authorized to access the Key Management Service. | |
| 404 | Request.NotFound | The requested resource is not available. | |
| 404 | HostInfo.NotFound | The specified host info is not found. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。