All Products
Search
Document Center

ApsaraMQ for MQTT:DisasterDowngrade

Last Updated:Mar 26, 2025

Downgrades the virtual IP address (VIP) access of a specific instance during the disaster recovery of multiple instances. Only Enterprise Platinum Edition instances support this operation. To call the operation, you must submit a ticket.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
InstanceIdstringYes

The ID of the ApsaraMQ for MQTT instance.

mqtt-cn-xxx
DowngradeInstanceIdstringYes

The ID of the ApsaraMQ for MQTT instance for which you want to downgrade the VIP access.

mqtt-cn-xxxx

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

82B9E503-F4A1-4F30-976F-C6999FF9****
Codeinteger

The response code. The status code 200 indicates that the request was successful. Other status codes indicate that the request failed. For information about error codes, see Error codes.

200
Successboolean

Indicates whether the request was successful. Valid values: true and false.

True
Messagestring

The returned message.

operation success.
AccessDeniedDetailstring

The details about the access denial. This parameter is returned only if Resource Access Management (RAM) permission verification failed.

None

Examples

Sample success responses

JSONformat

{
  "RequestId": "82B9E503-F4A1-4F30-976F-C6999FF9****",
  "Code": 200,
  "Success": true,
  "Message": "operation success.",
  "AccessDeniedDetail": "None"
}

Error codes

HTTP status codeError codeError message
400InstancePermissionCheckFailedAn error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.
400InvalidParameter.%sAn error occurred while validating the parameter. The parameter may be missing or invalid.
404ApiNotSupportThe specified API is not supported.
500InternalErrorAn error occurred while processing your request. Try again later.

For a list of error codes, visit the Service error codes.