Updated on 2025-05-06 GMT+08:00

Creating a Service Agency

Function

This API is used to create a service agency with just a few clicks.

URI

POST /v1/{project_id}/service-agencies

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant resource space ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token. The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

type

Yes

String

Type of the service agency scenario.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

agencies

Array of strings

Service agency authorization record.

Example Requests

Create a service agency.

POST https://{endpoint}/v1/{project_id}/service-agencies

{
  "type" : "TARGET_CONNECTION"
}

Example Responses

Status code: 200

Operation successful.

{
  "agencies" : [ "EG_DELEGATE_FG_AGENCY" ]
}

Status Codes

Status Code

Description

200

Operation successful.

Error Codes

See Error Codes.