Common return parameters are the parameters that will be returned each time the cloud API is called. These parameters are discussed in the document for each API. Here's a list of common return parameters:
Name | Type | Description |
---|---|---|
code | Int | Error code when calling cloud API. A code of 0 means the API call succeeded. Other values means the call failed. For information, refer to Error Codes page. |
message | String | Detailed error message, which varies depending on different APIs. |
Take Query Scaling Group List(DescribeScalingGroup) as an example, the possible common return parameters when the API call succeeds or fails are as follows:
If the API call succeeds, the common return parameters will be in the following format:
{
"code":"0",
"message":"",
<Instruction return parameters>
}
An error code of 0 means the API call succeeded. In addition, since the API call succeeded, the message field for error information will be empty.
If the API call fails, the common return parameters will be in the following format:
{
"code":"XXXX",
"message":"(XXXX)XXXXX",
<Instruction return parameters>
}
The error code is not 0, which means the API call failed. In addition, since the API call failed, the message field will display detailed error information.
Was this page helpful?