Help Center/ Cloud Operations Center/ API Reference/ API/ Application Resource Management/ Application/ Creating Applications, Groups, and Components in Batches
Updated on 2025-12-05 GMT+08:00

Creating Applications, Groups, and Components in Batches

Function

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

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

Range

N/A

Default value

N/A

component_list

No

Array of component_list objects

Definition

List of component information.

Constraints

N/A

Range

N/A

Default value

N/A

group_list

No

Array of group_list objects

Definition

List of group information.

Constraints

N/A

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

Range

The value is a string. It contains 0 to 256 characters.

Default value

N/A

parent_name

No

String

Definition

Parent node name.

Constraints

N/A

Range

The value is a string. It contains 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

Range

  • 1: application level

  • 2: sub-application level

Default value

The default application level is 1.

Table 3 component_list

Parameter

Mandatory

Type

Description

name

No

String

Definition

Component name.

Constraints

N/A

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

Range

The value is a string. It contains 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

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

Range

N/A

Default value

N/A

cmdb_resource_id_list

No

Array of strings

Definition

Associated resource ID list.

Constraints

N/A

Range

N/A

Default value

N/A

parent_name

No

String

Definition

Parent node name.

Constraints

N/A

Range

The value is a string. It contains 3 to 50 characters.

Default value

N/A

sync_mode

No

String

Definition

Synchronization mode.

Constraints

N/A

Range

  • MANUAL: indicates manual association. You can manually associate resource data with a group for management.

  • AUTO: indicates intelligent association. You can create resources with the same tag in an enterprise project in the same resource group.

Default value

N/A

sync_rules

No

Array of sync_rules objects

Definition

Automatic association rule.

Constraints

N/A

Range

The selected enterprise project is automatically associated 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

N/A

Range

The value can contain 3 to 50 characters, including letters, digits, hyphens (-), and underscores (_).

Default value

N/A

component_name

No

String

Definition

Name of the component associated with the group.

Constraints

N/A

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

N/A

Range

  • RMS: Huawei Cloud

  • AZURE: Microsoft Azure

  • ALI: Alibaba Cloud

  • VMWARE: VMware

  • OPENSTACK: OpenStack cloud platform

  • HCS: Huawei Cloud Stack (HCS), a hybrid cloud solution of Huawei.

  • OTHER: other cloud vendors

AWS: Amazon Web Services

Default value

N/A

relation_configurations

No

Array of GroupRelationConfiguration objects

Definition

Group configuration information.

Constraints

N/A

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

Range

The value is a string. It contains 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

Range

Select a project ID that is available inEnterprise Management.

Default value

N/A

rule_tags

No

String

Definition

Tag that is associated with resources.

Constraints

N/A

Range

This parameter 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

Range

  • APM: probe developed by the APM service

  • OTEL: the open-source probe OpenTelemetry

  • SKYWALKING: the open-source probe SkyWalking

Default value

N/A

parameters

No

Map<String,String>

Definition

Configuration parameters.

Constraints

N/A

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

data

data object

Definition

IDs of created applications, components, and groups.

Range

The value range is 0 to 500.

Table 8 data

Parameter

Type

Description

application_ids

Array of strings

Definition

Application ID list.

Range

N/A

component_ids

Array of strings

Definition

Component ID list.

Range

N/A

group_ids

Array of strings

Definition

Group ID list.

Range

N/A

Example Requests

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 created in batches.

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

Status Codes

Status Code

Description

200

Applications, groups, and components are created in batches.

Error Codes

See Error Codes.