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

Returned Values

After sending a request, you will receive a response, including 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 response. For more information, see Status Codes.

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 Header of the response to the request for creating 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 the administrator, the following message body is returned. The following is part of the response body for the API for obtaining 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": "Request body is invalid.",
    "error_code": "IAM.0011"
}

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