Updated on 2024-08-08 GMT+08:00

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.

If status code 201 is returned for the calling of the API for obtaining a user token, 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 response body for the API of creating an IAM user is shown as follows. The following shows part of the response body for the API to obtain a user token.

{ 
     "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.