创建应用 - CreateApplication
功能介绍
应用是根据业务需要,对相同或者相近业务的一组组件进行逻辑划分。
创建应用后,即可为该应用添加子应用、组件等信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
coc:application:create
Write
application *
-
-
-
URI
POST /v1/applications
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
参数解释: 应用名称。 约束限制: 由中文、英文字母、数字、中划线、下划线组成。 取值范围: 长度在3~50个字符之间。 默认取值: 不涉及。 |
parent_id |
否 |
String |
参数解释: 父节点id。 约束限制: 不涉及。 取值范围: 查询自己创建的项目,则此处返回所属区域的项目ID。 默认取值: 不涉及。 |
description |
否 |
String |
参数解释: 描述信息。 约束限制: 不涉及。 取值范围: 可以自定义,长度在1~256之间。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
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 |
创建应用成功。 |
错误码
请参见错误码。