文档首页 > > API参考> 应用管理 API V2(推荐使用)> 实例> 创建组件实例

创建组件实例

分享
更新时间: 2020/03/02 GMT+08:00

功能介绍

此API用来创建应用组件实例。

URI

POST /v2/{project_id}/cas/applications/{application_id}/components/{component_id}/instances

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户项目ID

application_id

String

应用ID

component_id

String

组件ID

请求参数

请求参数

表2 请求参数

参数

参数类型

是否必选

描述

name

String

应用组件实例名称

environment_id

String

环境ID

replica

Integer

实例副本数

flavor_id

String

资源规格,可查询获取所有支持的应用资源规格接口获取。

artifacts

Map<String, Object>

组件部署件。key为组件component_name,对于Docker多容器场景,key为容器名称。请参考表3

version

String

应用组件版本号,满足版本语义,如1.0.0。

configuration

Map<String, Object>

应用配置,环境变量等,如{“env”: [{“name”: “log-level”: “warn”}]}, 默认空。

description

String

描述

external_accesses

Array of objects

外网访问,参考表4

refer_resources

Array of objects

部署资源,参考表5

表3 artifact参数

参数

参数类型

是否必选

描述

storage

String

存储方式,支持swr、obs、devcloud。

type

String

类别,虚机部署为package,容器部署为image

url

String

软件包/镜像地址,对于需要使用组件的源码或者软件包自动生成的镜像,格式为“组件名:v${index}

auth

String

认证方式,支持iam和none,默认为iam

version

String

版本号

properties

String

属性

表4 external_accesses参数

参数

参数类型

是否必选

描述

protocol

String

协议,支持http、https。

address

String

访问地址

forward_port

integer

端口号

表5 refer_resources参数

参数

参数类型

是否必选

描述

id

String

资源ID

type

String

基础资源:cce、cci、ecs、as

可选资源:rds、dcs、elb等其他类型。

refer_alias

String

应用别名,dcs时才提供,支持“distributed_session”、“distributed_cache”、“distributed_session, distributed_cache”,

默认值是“distributed_session, distributed_cache”。

parameters

Map<String,String>

引用资源参数

响应参数

响应参数

表6 响应参数说明

参数

参数类型

描述

job_id

String

Job ID,用于查询创建任务信息

instance_id

String

应用组件实例ID

示例

请求示例

{
    "name": "component-instance-name", 
    "environment_id": "6e763000-9128-4a9d-adea-34c42cc5344d", 
    "flavor_id": "MICRO-5G:0.5C:1G", 
    "replica": 1, 
    "artifacts": {
        "container-name": {
            "storage": "swr", 
            "type": "image", 
            "url": "{IP}:20202/xxxxxxxx/junit-platformstest:1.0", 
            "auth": "iam"
        }
    }, 
    "version": 1, 
    "description": "instance desc", 
    "configuration": {
        "env": [
            {
                "name": "log-level", 
                "value": "warn"
            }
        ]
    }, 
    "refer_resources": [
        {
            "id": "b6862a62-d916-11e9-bdf1-0255ac101fd9", 
            "type": "cce", 
            "parameters": {
                "namespace": "default"
            }
        }, 
        {
            "id": "8c0a45cc-626f-4d65-8257-507ee059aa9a", 
            "type": "elb"
        }
    ]
}

响应示例

{
    "instance_id": "89f5baf5-efe4-4f12-9c0d-734d2af5a184", 
    "job_id": "JOB66761060-f209-407c-a093-4df6f531b9dc"
}

状态码

表7 状态码说明

HTTP状态码

描述

200

操作成功。

400

错误的请求。

404

请求对象不存在

500

内部错误

错误码格式为:SVCSTG.00100.[Error_ID],例如:SVCSTG.00100400。错误码说明请参考V2版本API错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区