文档首页/ 云运维中心 COC/ API参考/ API/ 应用资源管理/ 应用/ 批量创建应用,分组,组件 - BatchCreateApplicationView
更新时间:2025-10-14 GMT+08:00
分享

批量创建应用,分组,组件 - BatchCreateApplicationView

功能介绍

用户可以通过高级创建方式,创建应用,分组,组件。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    coc:application:create

    Write

    application *

    -

    -

    -

URI

POST /v1/application-view/batch-create

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

application_list

Array of application_list objects

参数解释:

应用信息组成的列表。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

component_list

Array of component_list objects

参数解释:

组件信息组成的列表。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

group_list

Array of group_list objects

参数解释:

分组信息组成的列表。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 application_list

参数

是否必选

参数类型

描述

name

String

参数解释:

应用名称。

约束限制:

不涉及。

取值范围:

由中文、英文字母、数字、中划线、下划线组成,长度在3~50个字符之间。

默认取值:

不涉及。

description

String

参数解释:

应用描述。

约束限制:

不涉及。

取值范围:

字符串,长度在0到256个字符之间。

默认取值:

不涉及。

parent_name

String

参数解释:

父节点名称。

约束限制:

不涉及。

取值范围:

字符串,长度3到50个字符。

默认取值:

不涉及。

level

String

参数解释:

层级,默认应用层级为1,子应用层级为2。

约束限制:

不涉及。

取值范围:

  • 1:应用层级。

  • 2:子应用层级。

默认取值:

默认应用层级为1。

表3 component_list

参数

是否必选

参数类型

描述

name

String

参数解释:

组件名称。

约束限制:

不涉及。

取值范围:

由中文、英文字母、数字、中划线、下划线组成,长度在3~50个字符之间。

默认取值:

不涉及。

parent_name

String

参数解释:

父节点名称。

约束限制:

不涉及。

取值范围:

字符串,长度3到50个字符。

默认取值:

不涉及。

表4 group_list

参数

是否必选

参数类型

描述

name

String

参数解释:

分组名称。

约束限制:

不涉及。

取值范围:

由中文、英文字母、数字、中划线、下划线组成,长度在3~50个字符之间。

默认取值:

不涉及。

region_id

String

参数解释:

区域id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

cmdb_resource_id_list

Array of strings

参数解释:

关联的资源id列表。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

parent_name

String

参数解释:

父节点名称。

约束限制:

不涉及。

取值范围:

字符串,长度3到50个字符。

默认取值:

不涉及。

sync_mode

String

参数解释:

同步模式。

约束限制:

不涉及。

取值范围:

  • MANUAL:表示手动关联:用户在对应分组下,手动将对应资源数据关联至分组内进行管理。

  • AUTO:表示智能关联:用户通过企业项目和标签的形式,将企业项目下的相同标签资源创建至同一资源分组。

默认取值:

不涉及。

sync_rules

Array of sync_rules objects

参数解释:

智能关联规则。

约束限制:

不涉及。

取值范围:

智能关联已选择的企业项目和对应标签的现存及未来创建的资源。

默认取值:

不涉及。

application_name

String

参数解释:

分组关联的应用名称。

约束限制:

不涉及。

取值范围:

由中文、英文字母、数字、中划线、下划线组成,长度在3~50个字符之间。

默认取值:

不涉及。

component_name

String

参数解释:

分组关联的组件名称。

约束限制:

不涉及。

取值范围:

由中文、英文字母、数字、中划线、下划线组成,长度在3~50个字符之间。

默认取值:

不涉及。

vendor

String

参数解释:

云厂商信息。

约束限制:

不涉及。

取值范围:

  • RMS: 华为云。

  • AWS:亚马逊。

  • AZURE:微软。

  • ALI:阿里云。

  • VMWARE:VMware。

  • OPENSTACK:openstack云平台。

  • HCS:Huawei Cloud Stack(简称 HCS),华为混合云解决方案。

  • OTHER:其他云厂商。

默认取值:

不涉及。

relation_configurations

Array of GroupRelationConfiguration objects

参数解释:

分组配置信息。

约束限制:

不涉及。

取值范围:

分组的关联配置信息,比如对应的APM的配置信息。

默认取值:

不涉及。

related_domain_id

String

参数解释:

关联的租户id。

约束限制:

不涉及。

取值范围:

字符串,长度32个字符。

默认取值:

不涉及。

表5 sync_rules

参数

是否必选

参数类型

描述

ep_id

String

参数解释:

企业项目id。

约束限制:

不涉及。

取值范围:

请选择企业管理中存在的项目ID。

默认取值:

不涉及。

rule_tags

String

参数解释:

关联标签。

约束限制:

不涉及。

取值范围:

可自定义。

默认取值:

不涉及。

表6 GroupRelationConfiguration

参数

是否必选

参数类型

描述

type

String

参数解释:

配置类型,配置本分组所对应的APM服务中的应用-组件-环境,故障诊断时可获取APM服务相关性能信息。

约束限制:

不涉及。

取值范围:

  • APM:apm服务自研探针。

  • OTEL:OpenTelemetry开源探针。

  • SKYWALKING:SkyWalking开源探针。

默认取值:

不涉及。

parameters

Map<String,String>

参数解释:

配置参数。

约束限制:

不涉及。

取值范围:

apm相关配置参数 app_id->business_id->env_id。

包含多个字段,最大长度仅供参考。

默认取值:

不涉及。

响应参数

状态码:200

表7 响应Body参数

参数

参数类型

描述

application_ids

Array of strings

参数解释:

应用id列表。

取值范围:

不涉及。

component_ids

Array of strings

参数解释:

组件id列表。

取值范围:

不涉及。

group_ids

Array of strings

参数解释:

分组id列表。

取值范围:

不涉及。

请求示例

批量创建应用,分组,组件。

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
  } ]
}

响应示例

状态码:200

批量创建应用,分组,组件成功。

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

状态码

状态码

描述

200

批量创建应用,分组,组件成功。

错误码

请参见错误码

相关文档