Creating a Layout

Function

This API is used to create a layout.

Calling Method

For details, see Calling APIs.

URI

POST /v1/{project_id}/workspaces/{workspace_id}/soc/layouts

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID, which is used to specify the project that a resource belongs to. You can query the resources of a project by project ID. You can obtain the project ID from the API or console. Obtaining the Project ID Constraints N/A Range N/A Default Value N/A
workspace_id	Yes	String	Definition Workspace ID. Constraints N/A Range N/A Default Value N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. You can obtain it by calling the IAM API for obtaining a user token. The user token is the value of X-Subject-Token in the response header. Obtaining a User Token Constraints N/A Range N/A Default Value N/A
content-type	Yes	String	Definition Content type. application/json;charset=UTF-8: common API request type Constraints N/A Range application/json;charset=UTF-8 Default Value N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
name	Yes	String	The name, display only
description	No	String	The description, display only
create_time	No	String	Create time
creator_name	No	String	Creator name value
cloud_pack_id	No	String	Subscription ID.
cloud_pack_name	No	String	Subscription package name.
cloud_pack_version	No	String	Subscription package version.
is_built_in	No	Boolean	Built-in or not. true: Built-in; false: Custom.
layout_json	No	Object	Layout information.
region_id	No	String	region id
domain_id	No	String	domain id
thumbnail	No	String	Template thumbnail. This parameter cannot be empty when the layout is a template.
used_by	Yes	String	Services that use the template (DATACLASS, AOP_WORKFLOW, SECURITY_REPORT, DASHBOARD) and the corresponding fields.
layout_type	No	String	Layout type. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
binding_id	No	String	Data class ID or workflow ID. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
binding_code	No	String	Data class name (business_code). This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
fields_sum	No	Integer	Total number of fields. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
wizards_sum	No	Integer	Total number of pages. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
sections_sum	No	Integer	Total number of system indicators.
tabs_sum	No	Integer	Total number of custom indicators.
boa_version	No	String	BOA base version.

Response Parameters

Status code: 200

**Table 4** Response header parameters
Parameter	Type	Description
X-request-id	String	Request ID. Format: request_uuid-timestamp-hostname.

**Table 5** Response body parameters
Parameter	Type	Description
code	String	Error code.
message	String	Error message.
request_id	String	Request id
success	Boolean	Request result.
data	LayoutDetailInfo object	Information of layout detail

**Table 6** LayoutDetailInfo
Parameter	Type	Description
cloud_pack_id	String	Subscription ID.
cloud_pack_name	String	Subscription package name.
cloud_pack_version	String	Subscription package version.
is_built_in	Boolean	Built-in or not. true: Built-in; false: Custom.
is_template	Boolean	Layout template.
create_time	String	Create time
creator_id	String	Creator id value
creator_name	String	Creator name value
description	String	The description, display only
en_description	String	english description of layout
id	String	Subscription ID.
name	String	The name, display only
en_name	String	english name of layout
layout_json	String	Wizard ID list in the layout.
project_id	String	Project id value
update_time	String	Update time
workspace_id	String	workspace id
region_id	String	region id
domain_id	String	domain id
thumbnail	String	Template thumbnail. This parameter cannot be empty when the layout is a template.
used_by	String	Services that use the template (DATACLASS, AOP_WORKFLOW, SECURITY_REPORT, DASHBOARD) and the corresponding fields.
layout_cfg	String	The parameter specifies which icon is used.
layout_type	String	Layout type. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
binding_id	String	Data class ID or workflow ID. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
binding_name	String	Data class name or workflow name. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
binding_code	String	Data class name or workflow name. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
fields_sum	Integer	Total number of fields. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
wizards_sum	Integer	Total number of pages. This parameter is not returned when used_by is SECURITY_REPORT or DASHBOARD.
sections_sum	Integer	Total number of system indicators.
tabs_sum	Integer	Total number of custom indicators.
version	String	SecMaster edition.
boa_version	String	BOA base version.

Status code: 400

**Table 7** Response header parameters
Parameter	Type	Description
X-request-id	String	Request ID. Format: request_uuid-timestamp-hostname.

**Table 8** Response body parameters
Parameter	Type	Description
code	String	Definition Error code. Range N/A
message	String	Definition Error description. Range N/A

Example Requests

Request body for creating a layout.

{
  "name" : "Query layouts of an account.",
  "binding_code" : "Alert",
  "boa_version" : "v3",
  "is_built_in" : false,
  "layout_type" : "LIST",
  "used_by" : "DATACLASS"
}

Example Responses

Status code: 200

Response to successful creation.

{
  "code" : "909494e3-558e-46b6-a9eb-07a8e18ca62f",
  "message" : "Error message",
  "success" : true,
  "data" : [ {
    "layout_details" : {
      "binding_code" : "Indicator",
      "binding_id" : "8e6e880c-caba-3511-88f6-545cc9f2a5bd",
      "binding_name" : "Indicator",
      "boa_version" : "v3",
      "create_time" : "2025-06-30T20:01:25Z+0800",
      "creator_id" : "system",
      "creator_name" : "system",
      "description" : "Domain",
      "en_description" : "Built-in layout, indicator management - Domain",
      "en_name" : "Domain",
      "fields_sum" : 17,
      "id" : "fc574642-7a4d-32bb-bb6f-ddcfb74624d9",
      "is_built_in" : true,
      "is_template" : "fals",
      "layout_cfg" : "indicator",
      "layout_json" : [ "28f87ba3-1146-4179-9799-5b5dbeee37ef" ],
      "layout_type" : "Detail",
      "modules_sum" : 0,
      "name" : "domain",
      "parent_id" : "144d0a96-db2c-3140-8a2f-ec30d8cee6c9",
      "project_id" : "15645222e8744afa985c93dab6341da6",
      "sections_sum" : 0,
      "tabs_sum" : 0,
      "update_time" : "2025-06-30T20:01:25Z+0800",
      "used_by" : "DATACLASS",
      "wizards_sum" : 1,
      "workspace_id" : "7e0f8248-5799-465e-9d94-9ff07f4b800d"
    }
  } ]
}