Function

This API is used to create an agency for a DLI user.

URI

URI format
POST /v2/{project_id}/agency

Parameter description

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID, which is used for resource isolation. For details about how to obtain its value, see Obtaining a Project ID.

Request

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
roles	Yes	Array of Strings	Role. Currently, only obs_adm, dis_adm, ctable_adm, vpc_netadm, smn_adm, and te_admin are supported. obs_adm: Administrator permissions for accessing and using the Object Storage Service. dis_adm: Administrator permissions for using Data Ingestion Service data as the data source ctable_adm: Administrator permissions for accessing and using the CloudTable service vpc_netadm: Administrator permissions for using the Virtual Private Cloud service smn_adm: Administrator permissions for using the Simple Message Notification service te_admin: Tenant Administrator permissions

Response

**Table 3** Response parameters
Parameter	Mandatory	Type	Description
is_success	No	Boolean	Indicates whether the request is successfully executed. Value true indicates that the request is successfully executed.
message	No	String	System prompt. If execution succeeds, the parameter setting may be left blank.

Example Request

{
    "roles": [
        "ctable_adm",
        "vpc_netadm",
        "dis_adm",
        "smn_adm",
        "obs_adm"
    ]
}

Example Response

{
    "is_success": true,
    "message": ""
}

Status Codes

Table 4 describes status codes.

**Table 4** Status codes
Status Code	Description
200	The job is created successfully.
400	Request failure.

Error Codes

If an error occurs when this API is invoked, the system does not return the result similar to the preceding example, but returns the error code and error information. For details, see Error Code.

Creating a DLI Agency