After STS API operations are called, data is returned in a unified format. The returned data is in either the XML or JSON format, and the XML format is the default option. Sample responses in API documents are formatted in a way that is easier for you to read. The actual responses are not formatted with line breaks or indentation.

Sample success responses

An HTTP status code 2xx indicates that the API operation is successful.

  • XML format
    <? xml version="1.0" encoding="utf-8"? >
    <!--Result Root Node-->
    <Operation name+Response>
        <!--Return Request Tag-->
        <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
        <!--Return Result Data-->
    </Operation Name+Response>
  • JSON format
    {
        "RequestId": "4C467B38-3910-447D-87BC-AC049166F216",
        /* Return Result Data */
    }

Sample error responses

An HTTP status code 4xx or 5xx indicates that the API operation failed and no result data is returned. The returned message body contains the specific error code, the error message, the RequestId parameter, and the HostId parameter. The RequestId parameter indicates the globally unique ID of the API request. The HostId parameter indicates the ID of the host to which your API request is sent. You can locate the error by using the error code.

  • XML format
    <? xml version="1.0" encoding="UTF-8"? >
    <Error>
       <RequestId>8906582E-6722-409A-A6C4-0E7863B733A5</RequestId>
       <HostId>sts.aliyuncs.com</HostId>
       <Code>InvalidParameter</Code>
       <Message>The specified parameter "Action or Version" is not valid. </Message>
    </Error>
  • JSON format
    {
        "RequestId": "7463B73D-35CC-4D19-A010-6B8D65D242EF",
        "HostId": "sts.aliyuncs.com",
        "Code": "InvalidParameter",
        "Message": "The specified parameter \"Action or Version\" is not valid."
    }