Help Center/ Cloud Operations Center/ API Reference/ API/ Fault Management/ WarRoom/ Creating a War Room in the Tenant Zone

Updated on 2025-10-24 GMT+08:00

View PDF

Creating a War Room in the Tenant Zone

Function

This API is used to create a war room in the tenant zone.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.

If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
coc:warroom:create	Write	-	-	-	-

URI

POST /v1/external/warrooms

Request Parameters

**Table 1** Request body parameters
Parameter	Mandatory	Type	Description
war_room_name	Yes	String	War room title Minimum: 1 Maximum: 255
description	No	String	War room description Minimum: 0 Maximum: 255
region_code_list	No	Array of strings	Region ID Minimum: 1 Maximum: 255 Array Length: 0 - 1000
application_id_list	Yes	Array of strings	ID of the affected application Minimum: 1 Maximum: 255 Array Length: 1 - 1000
incident_number	Yes	String	Incident ticket number Minimum: 1 Maximum: 255
schedule_group	Yes	Array of ScheduleGroupInfo objects	Shift group Array Length: 0 - 1000
participant	No	Array of strings	Participant Minimum: 0 Maximum: 255 Array Length: 0 - 1000
war_room_admin	Yes	String	War room administrator Minimum: 1 Maximum: 255
application_names	No	Array of strings	Application name list Minimum: 0 Maximum: 1000 Array Length: 0 - 1000
region_names	No	Array of strings	Region names Minimum: 0 Maximum: 1000 Array Length: 0 - 1000
enterprise_project_id	Yes	String	Enterprise project ID Minimum: 1 Maximum: 64
notification_type	No	String	Group creation mode Minimum: 0 Maximum: 64
notification_modes	No	Array of strings	Notification mode. Multiple notification modes are supported. Array Length: 0 - 5

**Table 2** ScheduleGroupInfo
Parameter	Mandatory	Type	Description
role_id	Yes	String	Role ID Minimum: 0 Maximum: 255
scene_id	Yes	String	Scenario ID Minimum: 0 Maximum: 255

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
provider_code	String	Service ID Default: 4 Minimum: 3 Maximum: 3
error_code	String	Request response code. The value ranges from 0000 to 9999. The value is 0 in normal cases. Minimum: 1 Maximum: 20
error_msg	String	Request response description Minimum: 0 Maximum: 10240
data	String	warroom Id Minimum: 0 Maximum: 255

Example Requests

{
  "war_room_name" : "Test 001",
  "description" : "Description 001",
  "region_code_list" : "[\"cn-east-3\"]",
  "application_id_list" : "[\"CS10004308\"]",
  "incident_number" : 360243622,
  "incident_level" : "string",
  "schedule_group" : {
    "role_id" : "string",
    "scene_id" : "string"
  },
  "participant" : [ "string" ],
  "war_room_admin" : "string"
}