該介面用於修改RDS叢集系列實例的Endpoint權重資訊。
介面說明
適用引擎
RDS MySQL
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
rds:ModifyDBInstanceEndpoint |
update |
*DBInstance
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ClientToken |
string |
否 |
該參數用於保證請求的冪等性，防止重複提交請求。參數值由用戶端產生，保證在不同請求間唯一。 該參數值由 ASCII 字元組成，最長不超過 64 個字元，不能包含非 ASCII 字元。 |
6000170000591aed949d0f**** |
| DBInstanceId |
string |
是 |
實例 ID。可調用 DescribeDBInstances 查詢。 |
rm-**** |
| DBInstanceEndpointId |
string |
是 |
實例的 Endpoint ID。可調用 DescribeDBInstanceEndpoints 查詢。 |
ep-**** |
| DBInstanceEndpointDescription |
string |
否 |
使用者自訂的 Endpoint 描述。 |
for readonly business |
| NodeItems |
array<object> |
否 |
Endpoint 節點相關資訊清單。 |
|
|
object |
否 |
節點詳情。 |
||
| DBInstanceId |
string |
否 |
實例 ID。可調用 DescribeDBInstances 查詢。 |
rm-**** |
| NodeId |
string |
否 |
節點 ID。 可以透過以下方式查詢節點 ID：
|
rn-xxxx-**** |
| Weight |
integer |
否 |
節點目前權重取值，按照該取值分配讀取流量。 取值範圍：0～100 |
50 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
傳回參數詳情。 |
||
| Data |
object |
傳回欄位清單。 |
|
| DBInstanceEndpointId |
string |
實例的 Endpoint ID。 |
ep-**** |
| DBInstanceName |
string |
實例 ID。 |
rm-**** |
| RequestId |
string |
請求 ID。 |
F2911788-25E8-42E5-A3A3-1B38D263F01E |
樣本
正常返回樣本
JSON格式
{
"Data": {
"DBInstanceEndpointId": "ep-****",
"DBInstanceName": "rm-****"
},
"RequestId": "F2911788-25E8-42E5-A3A3-1B38D263F01E"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidSourceCategory | specified source category is invalid. | |
| 400 | InvalidDBInstanceConnType.Format | Specified DB instance conn type is not valid. | |
| 400 | APICallingFailed | Meta db calling failed. | |
| 400 | InvalidNodeItems.JsonFormat | NodeItems is not a json string. | |
| 400 | EmptyEndpointNodeConfig | Specified endpoint has no nodes, add node to endpoint first. | |
| 400 | InvalidNodeItems.RONodeIdPrimary | ReadOnly endpoint can not contain primary node. | |
| 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 | IncorrectDBInstanceState | Current DB instance state does not support this operation. | |
| 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 | IncorrectDBInstanceLockMode | Current DB instance lock mode does not support this operation. | |
| 404 | InvalidDBInstanceName.NotFound | Invalid DBInstanceId NotFound. | |
| 404 | Endpoint.NotFound | Specified endpoint is not existed. | |
| 404 | InvalidConnectionString.NotFound | Specified connection string or net type is not found. | |
| 404 | InvalidWeight.Format | The Specified Weight format is not valid. | |
| 404 | InvalidDBInstance.NotFound | Specified instance does not exist or not support. | |
| 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. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。