Response

Status Codes

After sending a request, you will receive a response, including a 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 request.

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

Response Header

Similar to a request, a response also has a header, for example, Content-Type.

The following shows the response header fields for the create an IAM user. The X-Subject-Token header field is the desired user token. You can use the token to authenticate other API calls.

For security purposes, you are advised to set the token in ciphertext in configuration files or environment variables and decrypt it when using it.

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

(Optional) Response Body

This part is optional. The body of a response is often returned in structured format (for example, 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, an error code and a message will be displayed. The following shows an error response body.

{
    "error_msg": The request message format is invalid.",
    "error_code": "AS.0001"
}

In the response body, error_code is an error code, and error_msg provides information about the error.