Returned Values

Status Code

After sending a request, you will receive a response, including the status code, response header, and response body.

A status code is a group of digits ranging from 1xx to 5xx. It indicates the status of a response. For more information, see Status Code.

For example, if status code 201 is returned for calling the API used to create an IAM user, the request is successful.

Response Header

A response header corresponds to a request header, for example, Content-type.

Figure 1 shows the response header for the API of creating an IAM user.

Figure 1 Header of the response to the request for creating an IAM user

(Optional) Response Body

The body of a response is often returned in structured format (such as JSON or XML) as specified in the Content-type header field. The response body transfers content except the response header.

The following is part of the response body for the API used to create an IAM user.

{ 
     "user": { 
         "id": "c131886aec...", 
         "name": "IAMUser", 
         "description": "IAM User Description", 
         "areacode": "", 
         "phone": "", 
         "email": "***@***.com", 
         "status": null, 
         "enabled": true, 
         "pwd_status": false, 
         "access_mode": "default", 
         "is_domain_owner": false, 
         "xuser_id": "", 
         "xuser_type": "", 
         "password_expires_at": null, 
         "create_time": "2024-05-21T09:03:41.000000", 
         "domain_id": "d78cbac1..........", 
         "xdomain_id": "30086000........", 
         "xdomain_type": "", 
         "default_project_id": null 
     } 
 }

If an error occurs during API calling, the system returns an error code and a message to you. The following shows the format of an error response body:

{
    "error_msg": "The format of message is error",
    "error_code": "AS.0001"
}

In the preceding information, error_code is an error code, and error_msg describes the error.