# 根据发布单ID查看发布单详情 - ViewReleaseTaskDetailsBasedOnTheReleaseTaskID #### 功能介绍 此API用来根据发布单ID查看发布单详情。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-servicestage/servicestage_06_0183.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | servicestage:pipeline:get | read | pipeline \* | - | - | - | #### URI GET /v3/{project_id}/pipeline/pipelines/{pipeline_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 租户项目ID。获取方法，请参考[获取项目ID](https://support.huaweicloud.com/api-servicestage/servicestage_06_0164.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | pipeline_id | 是 | String | **参数解释：** 发布单ID。获取方法，请参考[获取发布单列表 - ObtainReleaseTaskList](https://support.huaweicloud.com/api-servicestage/servicestage_06_0246.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求消息 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Content-Type | 是 | String | **参数解释：** 消息体的类型（格式）。 **约束限制：** 不涉及 **取值范围：** application/json;charset=utf8 **默认取值：** 不涉及 | | X-Auth-Token | 是 | String | **参数解释：** 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考[认证鉴权](https://support.huaweicloud.com/api-servicestage/servicestage_06_0010.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应消息 表3响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 发布单名称。 | | description | String | 发布单描述。 | | model_version | Integer | 发布单模型。 仅支持2，表示新模型。 | | config_mode | String | 发布单部署模式。 - ui，界面创建。 - template，模板创建。 | | id | String | 发布单ID。 | | fail_mode | String | 激进策略。 - stop，关。 - continue，开。 | | enterprise_project_id | String | 企业项目ID。 | | pipeline_declaration | Array of objects | 阶段参数，当"config_mode"为"ui"时必选，请参考[表4]。 | 表4pipeline_declaration | 参数 | 参数类型 | 描述 | |:---|:---|:---| | sources | Array of objects | 模板包列表，请参考[表5]。 | | stages | Array of objects | 阶段参数，请参考[表8]。 | 表5template_sources | 参数 | 参数类型 | 描述 | |:---|:---|:---| | template_source | Object | 模板包信息，请参考[表6]。 | | input_values | Map\ | 模板包输入信息。 | 表6template_source | 参数 | 参数类型 | 描述 | |:---|:---|:---| | storage | String | 组件模板包存储方式。 - devcloud，CodeArts软件发布库。 - obs，OBS对象存储。 - http，自定义文件地址。 | | url | String | 组件模板包地址。 组件模板包存储方式为自定义文件地址时有效。 | | http_username | String | 用户名。 组件模板包存储方式为自定义文件地址且安全认证方式为用户名密码认证时有效。 | | http_password | String | 密码。 组件模板包存储方式为自定义文件地址且安全认证方式为用户名密码认证时有效。 | | http_headers | Array of objects | 请求头，请参考[表7]。 组件模板包存储方式为自定义文件地址且安全认证方式为自定义Header认证时有效。 | 表7http_headers | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 请求key。 **取值范围：** 不涉及 | | value | String | **参数解释：** 请求value。 **取值范围：** 不涉及 | 表8stages | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 阶段名称，单个发布单中参数唯一。 | | display_name | String | 阶段显示名称，若不填则和阶段名称一致。 | | task_group | Array of strings | 任务分组，任务分组中的参数必须和[表9]中的"group_index"字段相对应。 | | tasks | Array of objects | 任务参数，请参考[表9]。 | 表9tasks | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 任务名称，单个阶段中参数唯一。 | | display_name | String | 任务显示名称，若不填则和任务名称一致。 | | order_index | Integer | 任务执行顺序，若任务"group_index"一致，则表示为同一任务组，同一任务组中执行顺序唯一。 | | group_index | String | 任务分组，任务分组一致则表示为同一分组，与[表8]中的"task_group"字段保持一致 | | task_type_id | Object | 任务执行参数，请参考[表10]。 | | input | Object | 任务执行参数，根据任务类型确定。 - 若任务类型为[表10]中的构建任务，请参考[表11]。 - 若任务类型为[表10]中的卡点任务，请参考[表12]。 - 若任务类型为[表10]中的应用任务，请参考[表14]。 - 若任务类型为[表10]中的组件任务，请参考[表15]。 | 表10task_type_id | 参数 | 参数类型 | 描述 | |:---|:---|:---| | category | String | 任务类型。 - Build，构建任务。 - CheckPoint，卡点任务。 - Environment，环境任务。 - Component，组件任务。 - Application，应用任务。 | | type | String | 任务执行类型。 - create，创建。 - update，修改。 - upsert，创建或修改。 - approval，审批。 | 表11build | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 构建任务名称。 | | id | String | 构建任务ID。 | | enterprise_project_id | String | 构建任务企业项目ID。 | 表12checkpoint | 参数 | 参数类型 | 描述 | |:---|:---|:---| | mode | String | 若不填则表示无需指定人员审核。 - all，全部审核人审核通过则表示审核通过。 - any，任意审核人审核通过则表示审核通过。 | | users | Array of objects | 审核人。若不填则表示无需人审核，请参考[表13]。 | 表13users | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 用户ID。 | | label | String | 用户标签，用于前端展示。 | | name | String | 用户名称，用于前端展示。 | 表14application | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 应用名称。 | | description | String | 应用描述。 | | enterprise_project_id | String | 企业项目ID。 | 表15component | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 应用组件ID。 | | name | String | 应用组件名称。 由英文字母、数字、中划线（-）、下划线（_）组成，并以英文字母开头，英文字母或者数字结尾，长度为2\~64个字符。 | | workload_name | String | 工作负载名称。 | | labels | Array of objects | 标签。容器部署可通过标签查询对应工作负载；虚拟机部署可配置对应的微服务名称的标签来使用优雅上下线功能。请参考[表16]。 | | runtime_stack | Object | 运行时，请参考[表42]，可通过查询[查询技术栈 - QueryTechnologyStack](https://support.huaweicloud.com/api-servicestage/servicestage_06_0085.html)接口返回的信息获取。 | | environment_id | String | 环境ID。 | | description | String | 描述。 最大长度为128个字符。 | | source | Object | 代码/软件包来源，请参考[表43]。 | | build | Object | 组件构建，容器部署并没有使用镜像时必传，请参考[表44]。 | | limit_cpu | Number | 最大CPU限制，单位为Core。 | | limit_memory | Number | 最大内存限制，单位为GiB。 | | request_cpu | Number | 申请CPU资源，单位为Core。 | | request_memory | Number | 申请内存资源，单位为GiB。 | | version | String | 组件版本号，最大长度32，规则为： \^(\[0-9\]+)(\\.\[0-9\]+){2,3}$ | | envs | Array of objects | 环境变量列表，请参考[表40]。 | | replica | Integer | 实例数。 | | storages | Array of objects | 存储，请参考[表17]。 | | deploy_strategy | Object | 组件部署，请参考[表20]。 | | command | Object | 启动命令，请参考[表24]。 | | post_start | Object | 启动后处理，请参考[表25]。 | | pre_stop | Object | 停止前处理，请参考[表25]。 | | mesher | Object | 多语言接入服务网格，当技术栈选择Node.js且绑定微服务引擎时为必选，请参考[表26]。 | | timezone | String | 指定组件运行的时区。 | | jvm_opts | String | jvm参数，例如-Xms256m -Xmx1024m，多个参数以空格间隔，不填则使用默认值。 | | tomcat_opts | Object | tomcat参数，技术栈选择tomcat时生效，请参考[表27]。 | | host_aliases | Array of objects | 主机别名，请参考[表28]。 | | dns_policy | String | DNS策略。 - Default，继承pod所在节点域名解析配置。 - ClusterFirst，追加域名解析配置。 - ClusterFirstWithHostNet，仅对以hostNetWork方式运行的pod生效。 - None，替换域名解析策略。 | | dns_config | Object | DNS配置，请参考[表29]。 | | workload_kind | String | 工作负载类型。 - deployment，无状态工作负载。 - statefulset，有状态工作负载。 - daemonset，守护进程集。 - job，普通任务。 | | security_context | Object | 安全策略，请参考[表31]。 | | logs | Array of objects | 日志采集，请参考[表33]。 | | custom_metric | Object | 自定义指标监控，请参考[表34]。 | | affinity | Array of objects | 亲和性，请参考[表35]。 | | anti_affinity | Array of objects | 反亲和性，请参考[表35]。 | | liveness_probe | Object | 组件存活探针，请参考[表37]。 | | readiness_probe | Object | 组件业务探针，请参考[表37]。 | | startup_probe | Object | 组件启动探针，请参考[表37]。 | | refer_resources | Array of objects | 关联资源，请参考[表38]。 | | external_accesses | Array of objects | 外部访问，请参考[表46]。 | | tolerations | Array of objects | 容忍度策略，请参考[表47]。 | | container_name | String | 容器名称。 | | update_strategy | Object | 组件升级策略，请参考[表50]。 | | multi_containers | Array of objects | 多容器配置，请参考[表48]。 | | service_name | String | 有状态负载的实例间发现服务配置Service名称。 | | ports | Array of objects | 有状态负载的实例间发现服务配置端口配置，请参考[表49]。 | | workload_content | String | 工作负载内容。 | | configs | Array of objects | 组件统一配置，请参考[表51]。 | | config_mode | String | 工作负载配置模式。 | | enable_sermant_injection | Boolean | 是否开启Sermant。 | | enable_sermant_spring_register | Boolean | Spring Cloud Huawei框架的微服务是否需要Sermant帮助注册到注册中心。 | | enable_sermant_dubbo_register | Boolean | Dubbo框架的微服务是否需要Sermant帮助注册到注册中心。 | | enable_sermant_config | Boolean | 是否开启Sermant动态配置插件能力。 | | cell_id | String | 部署单元ID。 | | swimlane_id | String | 泳道ID。 | | sermantAgentInjectActionFlag | Boolean | JDK17以及JDK21是否自动添加以下JVM环境变量。 JDK17： ``` --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.net=ALL-UNNAMED --add-opens java.base/java.math=ALL-UNNAMED --add-opens java.base/sun.net.www=ALL-UNNAMED --add-opens java.base/sun.net.www.protocol.http=ALL-UNNAMED ``` JDK21： ``` --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.net=ALL-UNNAMED --add-opens java.base/java.math=ALL-UNNAMED --add-opens java.base/sun.net.www=ALL-UNNAMED --add-opens java.base/sun.net.www.protocol.http=ALL-UNNAMED -Dnet.bytebuddy.experimental=true ``` | | sys_config | Map\ | 使用压缩包在虚拟机环境下部署组件配置项。 | | image_pull_secrets | Array of strings | 镜像拉取密钥列表。 | | auto_lts_config | Object | LTS自动配置，请参考[表52]。 | | config_encryption | Object | 单容器组件配置加密密钥时需设置，请参考[表53]。 | | task_setting | Object | job类型工作负载的任务设置，请参考[表54]。 | 表16labels | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 标签名称。 **取值范围：** 不涉及 | | value | String | **参数解释：** 标签值。 **取值范围：** 不涉及 | 表17storages | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | 数据存储类型。 - HostPath，本地磁盘主机路径挂载。 - EmptyDir，本地磁盘临时路径挂载。 - ConfigMap， 本地磁盘配置项挂载。 - Secret，本地磁盘密钥挂载。 - PersistentVolumeClaim， 云存储挂载。 | | name | String | 存储盘名称。 | | parameters | Object | 对应各种数据存储类型的信息参数，请参考[表18]。 | | mounts | Array of objects | 数据存储挂载路径，请参考[表19]。 | 表18component_storage_parameters | 参数 | 参数类型 | 描述 | |:---|:---|:---| | path | String | **参数解释：** 主机路径， 适用于HostPath的存储类型。 **取值范围：** 不涉及 | | name | String | **参数解释：** 配置项、密钥或者PVC的名字， 适用于ConfigMap、Secret和PersistentVolumeClaim的存储类型。 **取值范围：** 不涉及 | | default_mode | Integer | **参数解释：** 挂载的权限，十进制格式，例如：384。适用于ConfigMap和Secret的存储类型。 **取值范围：** 不涉及 | | medium | String | **参数解释：** 适用于EmptyDir类型的存储，例如：memory。 **取值范围：** 不涉及 | 表19mounts | 参数 | 参数类型 | 描述 | |:---|:---|:---| | path | String | **参数解释：** 挂载路径。 **取值范围：** 不涉及 | | sub_path | String | **参数解释：** 挂载路径的子路径。 **取值范围：** 不涉及 | | read_only | Boolean | **参数解释：** 是否只读。 **取值范围：** - true：只读，只能读应用路径中的数据存储。 - false：读写，可修改应用路径中的数据存储，应用迁移时新写入的数据不会随之迁移，会造成数据丢失。 | 表20deploy_strategy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | 部署类型。 - OneBatchRelease，单批升级。 - RollingRelease，滚动部署升级。 - GrayRelease，灰度发布升级。 | | rolling_release | Object | 滚动部署参数，部署类型为RollingRelease时为必选，请参考[表21]。 | | gray_release | Object | 灰度发布升级，部署类型为GrayRelease时为必选，请参考[表22]。 | 表21rolling_release | 参数 | 参数类型 | 描述 | |:---|:---|:---| | batches | Integer | 分批部署批次。 | 表22gray_release | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | 灰度策略。 - WEIGHT，按灰度流量进行升级。 - CONTENT，按内容进行灰度。 | | first_batch_weight | Integer | 首批灰度流量比例，灰度策略为WEIGHT时为必选。 | | first_batch_replica | Integer | 首批灰度实例数量，灰度策略为WEIGHT时为必选。 | | remaining_batch | Integer | 剩余实例部署批次，首批灰度发布成功之后，剩余实例滚动升级分多少批次完成。 例如：剩余实例数是5，剩余部署批次是3，那么升级剩余实例会按照2:2:1个实例分批升级。 灰度策略为WEIGHT时为必选。 | | deployment_mode | Integer | 部署模型。 - 1，上游是微服务网关。 - 3，上游是微服务。 - 4，上游是ELB。 | | replica_surge_mode | String | 灰度实例新增模式，灰度策略为CONTENT时为必选。 - MIRROR，蓝绿。 - EXTRA，金丝雀（先增后减）。 - NOSURGE，金丝雀（先减后增）。 | | rule_match_mode | String | 灰度规则生效方式，灰度策略为CONTENT时为必选。 - ALL，满足所有条件。 - ANY，满足任一条件。 | | rules | Object | 灰度规则，参数[表23]，灰度策略为CONTENT时为必选。 | 表23gray_rules | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释：** 匹配类型。 **取值范围：** HEADER：请求头 | | key | String | **参数解释：** 参数名称。 **取值范围：** 不涉及 | | value | String | **参数解释：** 条件值。 **取值范围：** 不涉及 | | condition | String | **参数解释：** 条件类型。 **取值范围：** - EQUAL：相等。 - MATCH：匹配。 - IN：枚举。 | 表24command | 参数 | 参数类型 | 描述 | |:---|:---|:---| | command | Array of strings | **参数解释：** 运行命令，控制容器运行的输入命令。 **取值范围：** 不涉及 | | args | Array of strings | **参数解释：** 运行参数，控制容器运行命令的输入参数。例如：-port=8080，多条参数以换行分隔。 **取值范围：** 不涉及 | 表25component_lifecycle | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释：** 处理方式。 **取值范围：** - http，http请求方式。 - command，命令行方式。 | | scheme | String | **参数解释：** http请求类型。type为http类型时生效。 **取值范围：** - HTTP - HTTPS | | host | String | **参数解释：** 默认为POD的IP，可以指定自定义的IP。type为http类型时生效。 **取值范围：** 不涉及 | | port | Integer | **参数解释：** 端口号，type为http类型时生效。 **取值范围：** 不涉及 | | path | String | **参数解释：** 请求路径，type为http类型时生效。 **取值范围：** 不涉及 | | command | Array of strings | **参数解释：** 命令列表，type为command类型时生效。 **取值范围：** 不涉及 | 表26mesher | 参数 | 参数类型 | 描述 | |:---|:---|:---| | port | Integer | **参数解释：** 进程侦听端口。 **取值范围：** 不涉及 | 表27tomcat_opt | 参数 | 参数类型 | 描述 | |:---|:---|:---| | server_xml | String | **参数解释：** 1. 侦听端口以server.xml配置的为准，如果之前在公网访问配置了侦听端口，请保持一致。 2. 自定义的Tomcat配置可能存在端口冲突，请检查自定义的端口是否被占用。 **取值范围：** 不涉及 | 表28host_aliases | 参数 | 参数类型 | 描述 | |:---|:---|:---| | ip | String | **参数解释：** IP地址。 **取值范围：** 不涉及 | | hostname | Array of strings | **参数解释：** 主机别名。 **取值范围：** 不涉及 | 表29dns_config | 参数 | 参数类型 | 描述 | |:---|:---|:---| | nameservers | Array of strings | Pod的DNS服务器的IP地址列表。 | | searches | Array of strings | 可选，用于在Pod中查找主机名的DNS搜索域的列表。 | | options | Array of objects | 可选，对象列表。其中每个对象可能具有name属性（必需）和value属性（可选）。 此属性中的内容将合并到从指定的DNS策略生成的选项，重复的条目将被删除，请参考[表30]。 | 表30options | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 操作名称。 **取值范围：** 不涉及 | | value | String | **参数解释：** 操作值。 **取值范围：** 不涉及 | 表31security_context | 参数 | 参数类型 | 描述 | |:---|:---|:---| | run_as_user | Integer | 运行用户，容器以当前用户权限运行，如以root权限运行则填写root用户ID 0。 | | run_as_group | Integer | 运行属组，指定所有容器中的进程都以属组运行。 | | capabilities | Object | 能力集，请参考[表32]。 | 表32capabilities | 参数 | 参数类型 | 描述 | |:---|:---|:---| | add | Array of strings | **参数解释：** 为运行用户添加Linux权限。 **取值范围：** 不涉及 | | drop | Array of strings | **参数解释：** 移除运行用户Linux权限。 **取值范围：** 不涉及 | 表33logs | 参数 | 参数类型 | 描述 | |:---|:---|:---| | log_path | String | **参数解释：** 容器中日志路径。 **取值范围：** 不涉及 | | rotate | String | **参数解释：** 日志转储周期。 **取值范围：** 不涉及 | | host_path | String | **参数解释：** 挂载的主机路径。 **取值范围：** 不涉及 | | host_extend_path | String | **参数解释：** 主机扩展路径，通过扩展主机路径，实现同一个主机路径下区分来自不同容器的挂载。 **取值范围：** - None：不使用扩展路径。 - PodUID：通过POD的ID扩展主机路径。 - PodName：通过POD的名称扩展主机路径。 - PodUID/ContainerName：通过POD的ID和容器名称扩展主机路径。 - PodName/ContainerName：通过POD的名称和容器名称扩展主机路径。 | 表34custom_metric | 参数 | 参数类型 | 描述 | |:---|:---|:---| | path | String | **参数解释：** 采集路径，例如：/metrics。 **取值范围：** 不涉及 | | port | Integer | **参数解释：** 采集端口，例如：9090。 **取值范围：** 不涉及 | | dimensions | String | **参数解释：** 监控维度，例如："cpu_usage,mem_usage"。 **取值范围：** 不涉及 | 表35component_affinity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kind | String | 对象类型。 - node：节点。 - pod：工作负载。 | | condition | String | 策略满足类型。 - required：必须满足。 - preferred：尽量满足。 | | match_expressions | Array of objects | 调度策略规则，请参考[表36]。 | | weight | String | 权重。 - "condition"选择"required"时，固定为100。 - "condition"选择"preferred"时，可输入1到100之间的整数。 | 表36match_expressions | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 匹配标签key值。 **取值范围：** 不涉及 | | operation | String | **参数解释：** 匹配条件。 **取值范围：** 不涉及 | | value | String | **参数解释：** 匹配标签value值。 **取值范围：** 不涉及 | 表37component_probe | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释：** 类型。 **取值范围：** - http：HTTP请求检查 - tcp：TCP端口检查 - command：执行命令检查 | | delay | Integer | **参数解释：** 启动后多久开始探测。 **取值范围：** 不涉及 | | timeout | Integer | **参数解释：** 探测超时时间 **取值范围：** 不涉及 | | scheme | String | **参数解释：** 请求类型。type为http类型时生效。 **取值范围：** - HTTP - HTTPS | | host | String | **参数解释：** 默认为POD的IP，可以指定自定义的IP。type为http类型时生效。 **取值范围：** 不涉及 | | port | Integer | **参数解释：** 端口号，type为http和tcp类型时生效。 **取值范围：** 不涉及 | | path | String | **参数解释：** 请求路径，type为http类型时生效。 **取值范围：** 不涉及 | | command | Array of strings | **参数解释：** 命令列表，type为command类型时生效。 **取值范围：** 不涉及 | 表38refer_resources | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 资源ID。 | | type | String | 资源类型： - elb：弹性负载均衡 - cce：云容器引擎 - ecs：弹性云服务器 - as： 弹性伸缩组 - cse：ServiceComb引擎 - nacos：注册配置中心 - dcs：分布式缓存服务 - rds：云数据库RDS - gaussdb：云数据库GaussDB - dms_rocketmq：分布式消息服务RocketMQ - customServer：自定义服务器 - pvc：存储卷声明 - css_es：云搜索服务Elasticsearch - custom_k8s：自定义kubernetes集群 | | parameters | Object | 资源参数，请参考[表39]。 | 表39refer_resource_parameter | 参数 | 参数类型 | 描述 | |:---|:---|:---| | namespace | String | 命名空间。 | | name | String | 资源名。 | | capacity | Integer | 存储容量，单位GiB。 | | type | String | 存储卷声明类型。 - efs，极速文件存储。 - obs，对象存储。 - sfs，文件存储。 - evs，云硬盘。 | | class | String | 存储卷声明子类型。 - csi-sfsturbo，type为efs时固定指定。 - csi-obs，type为obs时固定指定。 - csi-nas，type为sfs时固定指定。 - csi-disk，type为evs时固定指定。 | | obs_volume_type | String | OBS存储卷类型，默认为STANDARD标准存储类型。 - STANDARD：标准存储，拥有低访问时延和较高的吞吐量，适用于有大量热点对象（平均一个月多次）或小对象（\<1MB），且需要频繁访问数据的业务场景。 - WARM：低频访问存储，适用于不频繁访问（平均一年少于12次）但在需要时也要求能够快速访问数据的业务场景。 - COLD：归档存储，适用于很少访问（平均一年访问一次）数据的业务场景。 | | access_mode | String | 存储卷访问模式。 - ReadWriteOnce：卷可以被一个节点以读写方式挂载。 - ReadWriteMany：卷可以被多个节点以读写方式挂载。 | | availableZone | String | 可用区。 | | volume_type | String | 存储卷类型。 - SATA：普通IO，是指由SATA存储提供资源的磁盘类型。 - SAS：高IO，是指由SAS存储提供资源的磁盘类型。 - SSD：超高IO，是指由SSD存储提供资源的磁盘类型。 | 表40envs | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 变量名。 | | value | String | 变量值。 | | value_from | Object | 变量引用，请参考[表41]。 | 表41value_from | 参数 | 参数类型 | 描述 | |:---|:---|:---| | reference_type | String | **参数解释：** 引用类型。 **取值范围：** - configMapKey：配置项导入。 - secretKey：密钥导入。 | | name | String | **参数解释：** 配置项或密钥的名称。 **取值范围：** 不涉及 | | key | String | **参数解释：** 配置项或密钥的键值。 **取值范围：** 不涉及 | | optional | Boolean | **参数解释：** 配置项或密钥的key是否必须存在。 **取值范围：** - true：必须存在 - false：非必须存在 | 表42runtime_stack | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 技术栈名称，例如：OpenJDK8。 **取值范围：** 不涉及 | | type | String | **参数解释：** 技术栈类型。 **取值范围：** - 部署模式为虚机部署时，支持Java、Tomcat、Nodejs。 - 部署模式为容器部署时，支持Java、Tomcat、Nodejs、Php、Docker、Python。 | | version | String | **参数解释：** 技术栈版本，例如：1.1.4。 **取值范围：** 不涉及 | | deploy_mode | String | **参数解释：** 部署模式。 **取值范围：** - container：容器部署 - virtualmachine：虚机部署 | 表43source | 参数 | 参数类型 | 描述 | |:---|:---|:---| | kind | String | **参数解释：** 组件来源类型。 **取值范围：** - code：源码。 - package：软件包。 - image：镜像包。 | | version | String | **参数解释：** 版本号。 **取值范围：** 不涉及 | | url | String | **参数解释：** 包地址，类型为package和image时需要添加。 **取值范围：** 不涉及 | | storage | String | **参数解释：** 存储方式。 **取值范围：** - devcloud：CodeArts软件发布库。 - obs：OBS对象存储。 - http：自定义文件地址。 - swr：镜像仓库。 组件来源包类型为package和image时需要添加。 | | auth | String | **参数解释：** 认证方式。 **取值范围：** - iam：IAM认证 - none：无认证 | | repo_auth | String | **参数解释：** 授权名称，在授权列表获取，请参考[获取仓库授权列表 - ObtainGitRepositoryAuthorizationList](https://support.huaweicloud.com/api-servicestage/servicestage_06_0092.html)。 **取值范围：** 不涉及 | | repo_namespace | String | **参数解释：** 代码仓库命名空间。 **取值范围：** 不涉及 | | repo_ref | String | **参数解释：** 代码分支或者Tag，默认是master。 **取值范围：** 不涉及 | | repo_type | String | **参数解释：** 代码仓类型。 **取值范围：** - DevCloud，codearts制品仓。 - Gitee，开源中国推出代码托管平台。 - GitHub，开源代码仓。 - GitLab，开源代码仓。 - Bitbucket，源代码托管网站。 | | web_url | String | **参数解释：** 代码跳转链接，例如：https://github.com/example/demo.git。 **取值范围：** 不涉及 | | repo_url | String | **参数解释：** 代码仓url，例如：https://github.com/example/demo.git。 **取值范围：** 不涉及 | | commit_id | String | **参数解释：** 代码仓库中，commit id是每次提交的唯一标识符，用于识别和引用特定的提交。 **取值范围：** 长度为8到40个字符，以小写字母或数字开头。 | | http_username | String | **参数解释：** 在"storage"为"http"时需要填写，支持用户名、密码认证，这里填写用户名。 **取值范围：** 不涉及 | | http_password | String | **参数解释：** 在"storage"为"http"时需要填写，支持用户名、密码认证，这里填写密码。 **取值范围：** 不涉及 | | http_command | String | **参数解释：** 在"storage"为"http"时需要填写，这里是用户定义软件包的地址。 **取值范围：** 不涉及 | | http_headers | Map\ | **参数解释：** 在"storage"为"http"时需要填写，支持用户自定义请求头，支持填写一个key，value，例如{"key":"xx","value":"xx""}，其中的key和value关键字固定。 **取值范围：** 不涉及 | 表44build | 参数 | 参数类型 | 描述 | |:---|:---|:---| | parameters | Object | 只在没有ID，新创建构建时提供，请参考[表45]。 | 表45parameters | 参数 | 参数类型 | 描述 | |:---|:---|:---| | build_cmd | String | **参数解释：** 编译命令。默认： 1. 根目录存在build.sh：./build.sh 2. 根据运行系统，示例如下： - Java和Tomcat：**mvn clean package** - Nodejs: **npm build** **取值范围：** 不涉及 | | dockerfile_path | String | **参数解释：** dockerfile地址，默认是根目录./。 **取值范围：** 不涉及 | | artifact_namespace | String | **参数解释：** 构建归档组织，默认cas_{project_id}。 **取值范围：** 不涉及 | | cluster_id | String | **参数解释：** 指定构建集群的id。 **取值范围：** 不涉及 | | node_label_selector | Map\ | **参数解释：** key是标签的键，value是标签的值。 **取值范围：** 不涉及 | | environment_id | String | **参数解释：** 环境ID。 **取值范围：** 不涉及 | 表46external_accesses | 参数 | 参数类型 | 描述 | |:---|:---|:---| | protocol | String | **参数解释：** 外部访问类型。 **取值范围：** - http：超文本传输协议 - https：超文本传输安全协议 | | address | String | **参数解释：** 外部访问地址。 **取值范围：** 不涉及 | | forward_port | Integer | **参数解释：** 外部访问端口。 **取值范围：** 不涉及 | 表47tolerations | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 污点键。 **取值范围：** 不涉及 | | operator | String | **参数解释：** 操作符。 **取值范围：** - Equal：设置此操作符表示准确匹配指定污点键（必填）和污点值的节点。如果不填写污点值，则表示可以与所有污点键相同的污点匹配。 - Exists：设置此操作符表示匹配存在指定污点键的节点，此时容忍度不能指定污点值。若不填写污点键则可以容忍全部污点。 | | value | String | **参数解释：** 污点值。"operator"为"Equal"时，需要填写污点值。 **取值范围：** 不涉及 | | effect | String | **参数解释：** 污点策略。 **取值范围：** - NoScheduler：表示匹配污点效果为NoSchedule的污点。 - PreferNoSchedule：表示匹配污点效果为PreferNoSchedule的污点。 - NoExecute：表示匹配污点效果为NoExecute的污点。 - 不设置该参数：表示匹配所有污点效果。 | | toleration_seconds | Integer | **参数解释：** 容忍时间窗。 当"effect"为"NoExecute"时支持配置。在容忍时间窗内，Pod还会在拥有污点的节点上运行，超出时间后会被驱逐。 **取值范围：** 不涉及 | 表48multi_containers | 参数 | 参数类型 | 描述 | |:---|:---|:---| | container_name | String | 容器名称。 | | source | Object | 代码/软件包来源，请参考[表43]，多容器模式下仅支持镜像。 | | limit_cpu | Number | 最大CPU限制，单位为Core。 | | limit_memory | Number | 最大内存限制，单位为GiB。 | | request_cpu | Number | 申请CPU资源，单位为Core。 | | request_memory | Number | 申请内存资源，单位为GiB。 | | envs | Array of objects | 环境变量列表，请参考[表40]。 | | liveness_probe | Object | 容器存活探针，请参考[表37]。 | | readiness_probe | Object | 容器业务探针，请参考[表37]。 | | startup_probe | Object | 容器启动探针，请参考[表37]。 | | command | Object | 启动命令，请参考[表24]。 | | post_start | Object | 启动后处理，请参考[表25]。 | | pre_stop | Object | 停止前处理，请参考[表25]。 | | logs | Array of objects | 日志采集，请参考[表33]。 | | storages | Array of objects | 存储，请参考[表17]。 | | security_context | Object | 安全策略，请参考[表31]。 | | config_encryption | Object | 多容器组件配置加密密钥时需设置，请参考[表53]。 | 表49ports | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 端口名称。 **取值范围：** 不涉及 | | port | String | **参数解释：** 访问端口。 **取值范围：** 不涉及 | | target_port | String | **参数解释：** 容器端口。 **取值范围：** 不涉及 | 表50update_strategy | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释：** 组件升级类型： **取值范围：** - RollingUpdate：滚动升级，即逐步创建新实例再删除旧实例，为默认策略。 - Recreate：替换升级，即先把当前实例删掉再重新创建实例。 | | max_unavailable | - String - Integer | **参数解释：** 最大无效实例数。与replica相比，可以有多少个实例失效，也就是删除的比例，默认值是25%。workload_kind为deployment时支持设置。 **取值范围：** - 若下发百分比则为String类型，即与实例数相比无效实例数在实例数中的最大百分比。 - 若下发整数则为Integer类型，即与实例数相比最多可以有多少个无效实例数。 | | max_surge | - String - Integer | **参数解释：** 最大浪涌。与replica相比，可以有多少个实例存在，默认值是25%。仅workload_kind为deployment时支持设置。 **取值范围：** - 若下发百分比则为String类型。 - 若下发整数则为Integer类型。 | | termination_period_seconds | Integer | **参数解释：** 缩容时间窗。工作负载停止前命令的执行时间窗，默认值为30秒。 **取值范围：** 不涉及 | | min_ready_seconds | Integer | **参数解释：** 实例可用最短时间。指定新创建的实例在没有任意容器崩溃情况下的最小就绪时间，只有超出这个时间实例才被视为可用。 默认值为0。 **取值范围：** 不涉及 | | progress_deadline_seconds | Integer | **参数解释：** 升级最大时长。指定系统在报告组件升级失败之前等待组件取得进展的秒数。 如果指定，则此字段值需要大于min_ready_seconds取值。 **取值范围：** 不涉及 | | revision_history_limit | Integer | **参数解释：** 最大保留版本数。用来设定出于回滚目的所要保留的旧实例数量。默认情况下，系统保留10个旧实例。 **取值范围：** 不涉及 | 表51configs | 参数 | 参数类型 | 描述 | |:---|:---|:---| | config_id | String | **参数解释：** 统一配置ID。 **取值范围：** 不涉及 | | mount_path | String | **参数解释：** 挂载路径。 **取值范围：** 不涉及 | 表52auto_lts_config | 参数 | 参数类型 | 描述 | |:---|:---|:---| | enable | Boolean | **参数解释：** 是否开启LTS自动配置。 **取值范围：** - true：开启 - false：不开启 | | lts_log_path | Array of strings | **参数解释：** 接入配置日志路径。 **取值范围：** 不涉及 | 表53config_encryption | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key_id | String | **参数解释：** DEW服务中用户密钥ID。 **取值范围：** 不涉及 | 表54task_setting | 参数 | 参数类型 | 描述 | |:---|:---|:---| | parallelism | Integer | **参数解释：** 并行数。 **取值范围：** 不涉及 | | active_deadline_seconds | Integer | **参数解释：** 超时时间（秒）。 **取值范围：** 不涉及 | | completion_mode | String | **参数解释：** 完成模式 **取值范围：** - NonIndexed：非索引模式。 - Indexed：索引模式。 | | suspend | Boolean | **参数解释：** 是否挂起任务。 默认任务创建后被立即执行。 选择挂起任务后，任务创建后处于挂起状态；将其关闭后，任务继续执行。 **取值范围：** - true：挂起任务 - false：不挂起任务 | #### 请求示例 无 #### 响应示例 ``` { "id": "4105b37a-947e-4aca-90d8-cec7c04c6f38", "enterprise_project_id": "0", "name": "release-gn7mre11", "model_version": 2, "fail_mode": "stop", "description": "test", "pipeline_declaration": { "stages": [ { "name": "75foki", "display_name": "stage", "task_group": [ "0" ], "tasks": [ { "name": "bkdi55", "display_name": "create-application-187", "task_type_id": { "category": "Application", "type": "upsert" }, "input": { "name": "xxz", "description": "", "enterprise_project_id": "0" }, "order_index": 0, "group_index": "0" } ] } ] } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 操作成功。 | | 400 | 错误的请求。 | | 404 | 请求对象不存在。 | | 500 | 内部错误。 | #### 错误码 请参考[ServiceStage错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。