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

创建应用 - CreateApplication

功能介绍

应用是根据业务需要,对相同或者相近业务的一组组件进行逻辑划分。

创建应用后,即可为该应用添加子应用、组件等信息。

调试

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

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    coc:application:create

    Write

    application *

    -

    -

    -

URI

POST /v1/applications

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

name

String

参数解释:

应用名称。

约束限制:

由中文、英文字母、数字、中划线、下划线组成。

取值范围:

长度在3~50个字符之间。

默认取值:

不涉及。

parent_id

String

参数解释:

父节点id。

约束限制:

不涉及。

取值范围:

查询自己创建的项目,则此处返回所属区域的项目ID。

默认取值:

不涉及。

description

String

参数解释:

描述信息。

约束限制:

不涉及。

取值范围:

可以自定义,长度在1~256之间。

默认取值:

不涉及。

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

data

String

参数解释:

COC-CMDB分配的uuid。

取值范围:

不涉及。

请求示例

创建应用管理下应用。

POST https://{Endpoint}/v1/applications

{
  "parent_id" : "67e3b885ef614c77c8b76f49",
  "name" : "test应用",
  "description" : "test应用"
}

响应示例

状态码:200

创建应用成功。

{
  "data" : {
    "id" : "685d07b102a50263fb2c209d",
    "name" : "test应用",
    "code" : null,
    "domainId" : "dc2d76541f754d68a4c8d150262d92c2",
    "description" : "test应用",
    "parentId" : "67e3b885ef614c77c8b76f49",
    "path" : "6835d67559221e2d9a6bfa1b.6895bab5e86fed4474120a77",
    "isCollection" : null,
    "collectionUserIdList" : null,
    "createTime" : "2025-08-08T08:52:05.949+00:00",
    "updateTime" : "2025-08-08T08:52:05.949+00:00"
  }
}

状态码

状态码

描述

200

创建应用成功。

错误码

请参见错误码

相关文档