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

Returned Values

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

Status Code

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

If status code 201 is returned for the API for creating an IAM user as an administrator, the request is successful.

Response Header

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

For the API for creating an IAM user as an administrator, the message header shown in Figure 1 is returned.
Figure 1 Response header fields for the API used to create an IAM user

Response Body

A response body is generally returned in a structured format, corresponding to the Content-Type in the response header, and is used to transfer content other than the response header.

For the API for creating an IAM user as an administrator, the following message body is returned. Only part of the response is shown here.

{ 
    "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": "Request body is invalid.", 
    "error_code": "IAM.0011" 
}

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