Upgrade Instance (Postpaid Plan)

Last updated: 2017-05-03 14:35:33

1. API Description

This API (UpgradeMongoDB) is used to upgrade a replica set instance (annual or monthly plan). Please make sure your account balance is sufficient.
Domain for API request: mongodb.api.qcloud.com

2. Input Parameters

The following request parameter list only provides API request parameters. Common request parameters are also needed when the API is called. For more information, please see Common Request Parameters page. The Action field for this API is UpgradeMongoDB.

Parameter Name Required Type Description
instanceId Yes String ID of instance to work with. This can be obtained from instanceId in the returned values of API DescribeMongoDBInstances.
memory Int Memory size of upgraded instance. Each memory value corresponds to a selectable disk capacity range (in MB)
diskSize Yes Int Disk capacity of upgraded instance (in GB)

3. Output Parameters

Parameter Name Type Description
code Int Common error code; 0: Succeeded; other values: Failed. For more information, please see Common Error Codes on the Error Codes page.
message String Error message description. A null value indicates a success
codeDesc String Description of error code at business side. For a successful operation, "Success" will be returned. In case of an error, a message describing the reason for the error will be returned.
data Array Returned order ID

Parameter data indicates the order ID, and is composed as follows:

Parameter Name Type Description
data.dealId String Order ID. You can use API DescribeMongodbDealDetail to query order details

4. Error Codes

The following error codes include the business logic error codes for this API.

Error Code Error Message Error Description
11050 InvalidParameter Incorrect business parameter
11056 InstanceNotExists Instance does not exist
11051 InstanceDeleted The instance has been reclaimed upon expiration
11068 UpgradeNotAllowedOnZoneId Upgrade of instances is not allowed for this zone
11069 DiskSizeLessThanRealSize The requested disk capacity is less than the actual value
11070 DiskSizeLessThanRealSize The requested memory size is less than the actual value
100207 OperationConstraints.AccountBalanceNotEnough Insufficient account balance. Please top it up

5. Example

Input


https://mongodb.api.qcloud.com/v2/index.php?Action=UpgradeMongoDB
&<Common Request Parameters>
&instanceId=cmgo-6ozqe0uh
&memory=8192
&diskSize=60

Output

{
    "code":"0",
    "message":"",
    "codeDesc": "Success",
    "data":{
        "dealId":"432587"
    }
}