Help Center/ Cloud Firewall/ API Reference/ API/ Multi-Account Management/ Enabling Multi-Account Management
Updated on 2025-08-12 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Enabling Multi-Account Management

Function

This API is used to enable multi-account management.

Calling Method

For details, see Calling APIs.

URI

POST /v1/{project_id}/system/multi-account/enable

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID, which is used to specify the project that an asset belongs to. You can query the assets of a project by project ID. You can obtain the project ID from the API or console. For details, see Obtaining a Project ID.

Constraints

N/A

Range

32-bit UUID.

Default Value

N/A
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

fw_instance_id

Yes

String

Definition

Firewall ID. It is a unique ID generated after a firewall instance is created. You can obtain the firewall ID by referring to Obtaining a Firewall ID.

Constraints

N/A

Range

32-bit UUID.

Default Value

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

data

data object

Definition

Response information.

Range

N/A
Table 4 data

Parameter

Type

Description

id

String

Definition

Firewall ID.

Range

N/A

name

String

Definition

Firewall name.

Range

N/A

trust_service_status

Integer

Definition

CFW trustworthy service status.

Range

1: enabled

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Definition

Error code.

Range

N/A

error_msg

String

Definition

Error message.

Range

N/A

Example Requests

Enable multi-account management. The project ID is 176d761dc156471c9c9b227376594160, and the firewall ID is ea0e700f-7ae6-47c1-a8d0-ed4b1acd8e8e.

https://{Endpoint}/v1/176d761dc156471c9c9b227376594160/system/multi-account/enable?fw_instance_id=ea0e700f-7ae6-47c1-a8d0-ed4b1acd8e8e

Example Responses

Status code: 200

OK

{
  "data" : {
    "id" : "ea0e700f-7ae6-47c1-a8d0-ed4b1acd8e8e",
    "name" : "CFW-9809-1"
  }
}

Status code: 400

Bad Request

{
  "error_code" : "CFW.00200003",
  "error_msg" : "Parameter error."
}

Status Codes

Status Code

Description

200

OK

400

Bad Request

Error Codes

See Error Codes.

Parent Topic: Multi-Account Management