Creating Applications, Groups, and Components in Batches

Function

You can create applications, groups, and components in the advanced creation method.

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:application:create	Write	application *	-	-	-

URI

POST /v1/application-view/batch-create

Request Parameters

**Table 1** Request body parameters
Parameter	Mandatory	Type	Description
application_list	Yes	Array of application_list objects	Definition: List of application information. Constraints: N/A Value Range: N/A Default value: N/A
component_list	No	Array of component_list objects	Definition: List of component information. Constraints: N/A Value Range: None. Default value: N/A
group_list	No	Array of group_list objects	Definition: List of group information. Constraints: N/A Value Range: N/A Default value: N/A

**Table 2** application_list
Parameter	Mandatory	Type	Description
name	No	String	Definition: Application name. Constraints: N/A Range: The value can contain 3 to 50 characters, including letters, digits, hyphens (-), and underscores (_). Default value: N/A.
description	No	String	Definition: Application description Constraints: N/A Value Range: The value is a string with 0 to 256 characters. Default value: N/A
parent_name	No	String	Definition: Parent node name. Constraints: N/A Value Range: The value is a string of 3 to 50 characters. Default value: N/A
level	No	String	Definition: Level. The default application level is 1, and the sub-application level is 2. Constraints: N/A Value Range: 1: application layer 2: sub-application level Default value: The default application layer is 1.

**Table 3** component_list
Parameter	Mandatory	Type	Description
name	No	String	Definition: Name of a component. Constraints: N/A Value Range: The value can contain 3 to 50 characters, including letters, digits, hyphens (-), and underscores (_). Default value: N/A
parent_name	No	String	Definition: Parent node name. Constraints: N/A Value Range: The value is a string with 3 to 50 characters. Default value: N/A

**Table 4** group_list
Parameter	Mandatory	Type	Description
name	No	String	Definition: Group name. Constraints: N/A Value Range: The value can contain 3 to 50 characters, including letters, digits, hyphens (-), and underscores (_). Default value: N/A
region_id	No	String	Definition: Region ID. Constraints: N/A Value Range: N/A Default value: N/A
cmdb_resource_id_list	No	Array of strings	Definition: Associated resource ID list. Constraints: N/A Value Range: N/A Default value: N/A
parent_name	No	String	Definition: Parent node name. Constraints: N/A Value Range: The value is a string with 3 to 50 characters. Default value: N/A
sync_mode	No	String	Definition: Synchronization mode. Constraints: N/A Value Range: MANUAL: indicates manual association. You can manually associate resource data with a group for management. AUTO: Intelligent association is enabled. You can add resources with the same tag in an enterprise project to the same resource group by enterprise project and tag. Default value: N/A
sync_rules	No	Array of sync_rules objects	Definition: Automatic association rule. Constraints: N/A Value Range: Intelligently associate the selected enterprise project with the existing and future resources of the corresponding tag. Default value: N/A
application_name	No	String	Definition: Name of the application associated with the group. Constraints: None. Range: The value can contain 3 to 50 characters, including letters, digits, hyphens (-), and underscores (_). Default value: None.
component_name	No	String	Definition: Name of the component associated with the group. Constraints: N/A Value Range: The value can contain 3 to 50 characters, including letters, digits, hyphens (-), and underscores (_). Default value: N/A
vendor	No	String	Definition: Cloud vendor information. Constraints: None. Value Range: RMS: Huawei Cloud. AWS: Amazon Azure: Microsoft Azure ALI: Alibaba Cloud VMWARE: VMware OPENSTACK: OpenStack cloud platform. HCS: Huawei hybrid cloud solution Huawei Cloud Stack OTHER: other cloud vendors Default value: N/A
relation_configurations	No	Array of GroupRelationConfiguration objects	Definition: Group configuration information. Constraints: N/A Value Range: Associated configuration information of the group, for example, configuration information of the corresponding APM. Default value: N/A
related_domain_id	No	String	Definition: ID of the associated tenant. Constraints: N/A Value Range: The value is a string with 32 characters. Default value: N/A

**Table 5** sync_rules
Parameter	Mandatory	Type	Description
ep_id	No	String	Definition: Enterprise project ID. Constraints: N/A Value Range: Select a project ID that exists inEnterprise Management. Default value: N/A
rule_tags	No	String	Definition: Associate resources with tags. Constraints: N/A Value Range: The value can be customized. Default value: N/A

**Table 6** GroupRelationConfiguration
Parameter	Mandatory	Type	Description
type	No	String	Definition: Configuration type. Configure the application, component, and environment of the APM service corresponding to the group. APM service performance information can be obtained during fault diagnosis. Constraints: N/A Value range: APM: probe developed by the APM service OTEL: open-source probe OpenTelemetry SKYWALKING: open-source probe SkyWalking Default value: N/A
parameters	No	Map<String,String>	Definition: Configuration parameters. Constraints: N/A Value range: APM configuration parameter app_id->business_id->env_id. The value contains multiple fields. The maximum length is for reference only. Default value: N/A

Response Parameters

Status code: 200

**Table 7** Response body parameters
Parameter	Type	Description
application_ids	Array of strings	Definition: Application ID list. Value Range: N/A
component_ids	Array of strings	Definition: Component ID list. Value Range: N/A
group_ids	Array of strings	Definition: Group ID list. Value Range: N/A

Example Requests

This API is used to create applications, groups, and components in batches.

POST https://{Endpoint}/v1/application-view/batch-create

{
  "application_list" : [ {
    "name" : "testcreatet111",
    "description" : "test11",
    "level" : "1"
  } ],
  "component_list" : [ {
    "name" : "testcomponent22",
    "parent_name" : "testcreatet111"
  } ],
  "group_list" : [ {
    "name" : "testgroup888",
    "region_id" : "testregion",
    "vendor" : "RMS",
    "component_name" : "testcomponent22",
    "application_name" : "testcreatet111",
    "sync_mode" : "AUTO",
    "related_domain_id" : null,
    "sync_rules" : [ {
      "ep_id" : "0",
      "rule_tags" : "[{\"key\":\"test1222\",\"value\":\"teee\"}]"
    } ],
    "relation_configurations" : null,
    "cmdb_resource_id_list" : null
  } ]
}

Example Responses

Status code: 200

Applications, groups, and components are successfully created in batches.

{
  "data" : {
    "application_ids" : [ "68906f0d2e9e061ab9424d0d", "68906f0d2e9e061ab9424d0c" ],
    "component_ids" : [ "68906f0d2e9e061ab9424d0e" ],
    "group_ids" : [ "68906f0d2e9e061ab9424d10" ]
  }
}