华为云用户手册

注意事项 存量托管任务开启后，不可取消，不可删除。 IAM 子账号暂不支持使用存量托管功能，建议使用主账号配置。 单个任务只能托管已授权的某个桶中存量文件，托管多个桶中存量文件请创建多个任务。 已托管的音视频文件不会重复托管至点播服务，但若新的存量托管任务中有重复的音视频文件，且选择了转码模板或工作流，则会对重复托管的音视频进行转码或执行工作流，从而产生相关的音视频处理费用。 音视频文件增量托管完成后，对应的文件存储路径及文件名称，不能包含下述关键字，否则可能会造成音视频播放异常。 shield asset play_video play_audio play_multi_video play_multi_audio

操作场景 当您在应用设计态完成应用的构建和发布后，需要将已发布的应用代码包部署至工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F），才可在应用运行态调用API和管理应用的模型数据。 应用部署完成后，应用运行态会自动加载应用代码包，同步部署应用时选择的已发布版本应用代码包，初始化应用运行态。初始化过程中，可能受网络不稳定或其他因素影响，导致应用运行态的API和模型数据出现异常。xDM-F提供初始化异常监控服务，可视化展示应用运行态初始化异常的原因，支持手动重新加载应用代码包。

管理SDK任务 SDK任务列表当前处于试运行阶段，如需使用，请咨询对应销售经理或提交工单咨询处理。 为了方便用户查看当前应用的SDK任务，用户可以在“应用发布”页面，单击“SDK任务列表”，在展开的“SDK任务列表”页面进行查看。 图11 SDK任务列表 在该页面中，可以查看到的SDK任务列表操作包括：应用版本号、SDK版本、类型、任务状态、错误信息、创建人、创建时间以及结束时间等。 此外，为了帮助用户快速查询指定的SDK任务，支持通过设置如下筛选条件，单击“搜索”进行筛选。 图12 搜索SDK任务 应用版本号：可通过应用发布时生成的应用版本号进行筛选。 SDK版本：可通过iDME的版本进行筛选。 任务状态：支持按排队中、执行中、成功以及失败进行筛选。 创建人：可通过生成SDK任务的用户名筛选。 创建时间：可自定义SDK任务的创建时间进行筛选。 结束时间：可自定义SDK任务的结束时间进行筛选。

组件来源说明 组件来源 说明 源码仓库 参考创建仓库授权创建授权，然后设置代码来源。 Jar包 支持以下上传方式： 从CodeArts软件发布库选择对应软件包。需要提前将软件包上传至CodeArts软件发布库，相关操作请参考上传软件包。 从SWR软件仓库选择对应的软件包。需要提前将软件包上传至软件仓库，相关操作请参考上传软件包。 从OBS对象存储选择对应的软件包。需要提前将软件包上传至OBS桶中，相关操作请参考流式上传（PUT上传） 。 从自定义文件地址获取对应的软件包，支持自定义HTTP/HTTPS协议的文件地址下载。您需要提前将软件包上传至对应的自定义文件地址下。 War包 Zip包 压缩包 镜像包 容器应用需要基于镜像创建。支持“我的镜像”（私有镜像）、“开源镜像”、“共享镜像”、“第三方镜像”。 若选择“我的镜像”，您首先需要将镜像上传至镜像仓库，请参考上传镜像。 若选择“第三方镜像”，您需要已获取第三方镜像的地址。镜像地址格式为： {第三方镜像仓库IP地址}:{第三方镜像仓库访问端口号}/{镜像存储路径}/{镜像名称}:{镜像版本号} 或者： {镜像名称}:{镜像版本号} 若没标注镜像版本号，则默认为最新版本号latest。 目前仅支持获取第三方公开镜像。

组件部署方式说明 组件部署方式 说明 容器部署 云容器引擎部署：云容器引擎CCE提供高度可扩展的、高性能的企业级Kubernetes集群，支持运行Docker容器。借助云容器引擎，您可以在云平台上轻松部署、管理和扩展容器化应用程序。 虚拟机部署 虚拟机，即弹性 云服务器ECS ，是由CPU、内存、操作系统、云硬盘组成的基础的计算组件。弹性云服务器创建成功后，您就可以像使用自己的本地PC或物理服务器一样，在云上使用弹性云服务器，将组件部署在虚拟机上。

技术栈简介 技术栈包含组件运行所依赖的操作系统、框架和运行时，由技术栈名称、类型、状态、版本等属性构成。其中，版本号遵从语义化版本控制规范。 ServiceStage为您提供并管理技术栈生命周期，您只需聚焦具体业务开发，提升您的应用托管体验。 技术栈各生命周期阶段定义如下： Preview：Beta版本技术栈发布。 GA（General Availability）：正式版本技术栈发布。 EOL（End of Life）：技术栈生命周期结束。 技术栈状态定义如下： Preview：生命周期处于Preview阶段的技术栈。 Supported：生命周期处于GA阶段的技术栈。 Deprecated：生命周期处于GA阶段、但是已经发布了EOL公告的技术栈，或者ServiceStage服务不主推的技术栈。 技术栈的详细信息请参见表1。

最新公告 以下为CCE发布的最新公告，请您关注。 序号 公告标题 公告类型 发布时间 1 关于CentOS停止维护的通知 产品变更公告 2024/10/23 2 NVIDIA Container Toolkit容器逃逸漏洞公告（CVE-2024-0132） 漏洞公告 2024/10/11 3 Linux CUPS服务RCE 漏洞公告（CVE-2024-47076、CVE-2024-47175、CVE-2024-47176、CVE-2024-47177） 漏洞公告 2024/10/11 4 华为云容器服务CCE Autopilot数据面账单变更公告 产品变更公告 2024/09/14 5 华为云容器服务CCE Autopilot于2024年9月30日00:00（北京时间）转商 产品变更公告 2024/08/29 6 NGINX Ingress控制器验证绕过漏洞公告（CVE-2024-7646） 漏洞公告 2024/08/26 7 Docker Engine授权插件AuthZ权限绕过漏洞公告（CVE-2024-41110） 漏洞公告 2024/07/31 8 Linux内核权限提升漏洞公告（CVE-2024-1086） 漏洞公告 2024/07/16 9 OpenSSH远程代码执行漏洞公告（CVE-2024-6387） 漏洞公告 2024/07/03 10 Fluent Bit内存崩溃漏洞公告（CVE-2024-4323） 漏洞公告 2024/05/23 11 runc systemd属性注入漏洞公告（CVE-2024-3154） 漏洞公告 2024/04/29 12 集群网络、存储功能可靠性加固说明 产品变更公告 2024/04/26 13 1.23版本集群停止维护公告 集群版本公告 2024/04/25 14 关于CCE集群Docker支持策略公告 产品变更公告 2024/02/19 15 runc漏洞（CVE-2024-21626）对CCE服务的影响说明 漏洞公告 2024/02/01 16 1.21版本集群停止维护公告 集群版本公告 2024/01/22 17 1.19版本集群停止维护公告 集群版本公告 2023/07/07 18 1.17版本集群停止维护公告 集群版本公告 2022/11/29 19 ServiceAccount Token安全性提升说明 产品变更公告 2022/11/24 20 Kubernetes安全漏洞公告（CVE-2022-3172） 漏洞公告 2022/09/23 21 Linux Kernel openvswitch 模块权限提升漏洞预警（CVE-2022-2639） 漏洞公告 2022/09/16 更多历史公告请详见产品变更公告、集群版本公告及漏洞公告。

响应示例 查询成功 { "metadata": { "version": "2.0.0" }, "data": [ { "id": "0bdfddb8-c4f9-4a88-8360-07a8a616a804", "key": "2", "labels": { "2": "2" }, "value": "2", "status": "enabled", "value_type": "text" }, { "id": "34befef9-7f3a-4394-85f9-142622a11b1d", "key": "1", "labels": { "1": "1" }, "value": "1", "status": "enabled", "value_type": "text" } ] }

URI POST /v1/{project_id}/kie/download 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户子项目的唯一标识，字符长度为1~64位，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 label 否 String 按label过滤项导出，格式为：{标签key}:{标签value}。 match 否 String 对label过滤项的匹配选项。 如果值为exact表示严格匹配，包括label个数和内容相等。 不填表示包含匹配。

响应示例 状态码： 200 查询成功，如果summary存在，则header里面的X-Schema-Summary的value为该schema对应的摘要。 { "schema" : "---\nswagger: \"2.0\"\ninfo:\n version: \"1.0.0\"\n title: \"swagger definition for com.service.provider.controller.ProviderImpl\"\n x-java-interface: \"cse.gen.springmvc.provider.provider.ProviderImplIntf\"\nbasePath: \"/provider\"\nconsumes:\n- \"application/json\"\nproduces:\n- \"application/json\"\npaths:\n /helloworld:\n get:\n operationId: \"helloworld\"\n produces:\n - \"application/json\"\n parameters:\n - name: \"name\"\n in: \"query\"\n required: true\n type: \"string\"\n responses:\n 200:\n description: \"response of 200\"\n schema:\n type: \"string\"\n" }

URI GET /v4/{project_id}/registry/microservices/{service_id}/schemas/{schema_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 微服务引擎专业版，请填租户项目id，长度为1~64，获取方法请参考获取项目ID。也可以填固定值default。 微服务引擎专享版，请填固定值：default。 service_id 是 String 微服务唯一标识。字符长度为1~64，正则表达式为^.*$。获取方法请参考查询所有微服务信息。 schema_id 是 String 契约的id。获取方法请参考查询微服务的所有契约。

响应参数 状态码： 200 表3 响应Header参数 参数 参数类型 描述 X-Schema-Summary String 微服务契约的摘要。 表4 响应Body参数 参数 参数类型 描述 schema String 契约内容。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 errorCode String 错误代码。 errorMessage String 错误信息。 detail String 详细定位信息。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 errorCode String 错误代码。 errorMessage String 错误信息。 detail String 详细定位信息。

URI GET /v2/{project_id}/enginemgr/engines 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户子项目的唯一标识，字符长度为1~64位，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量 limit 否 Integer 每页数据大小 type 否 String 查询的引擎类型： CS E、CSE_SHARE。

响应示例 { "total": 1, "data": [{ "id": "891bf21a-4024-4f47-b38c-bd259ca8f10a", "name": "test", "enterpriseProjectId": "0", "enterpriseProjectName": "default", "type": "CSE_SHARE", "description": "", "flavor": "cse.s1.medium2", "payment": "0", "authType": "RBAC", "status": "Available", "externalAddress": "192.168.0.169", "serviceEndpoint": { "kie": { "masterEntrypoint": "https://192.168.0.169:30110", "masterEntrypointIpv6": "https://[2407:c080:11f0:11:b11d:675c:97ab:65f6]:30110", "slaveEntrypoint": null, "slaveEntrypointIpv6": null, "type": "REGISTRY" }, "serviceCenter": { "masterEntrypoint": "https://192.168.0.169:30100", "masterEntrypointIpv6": "https://[2407:c080:11f0:11:b11d:675c:97ab:65f6]:30100", "slaveEntrypoint": null, "slaveEntrypointIpv6": null, "type": "REGISTRY" } }, "publicAddress": "", "publicServiceEndpoint": { "kie": { "masterEntrypoint": "", "masterEntrypointIpv6": "", "slaveEntrypoint": "", "slaveEntrypointIpv6": "", "type": "REGISTRY" }, "serviceCenter": { "masterEntrypoint": "", "masterEntrypointIpv6": "", "slaveEntrypoint": "", "slaveEntrypointIpv6": "", "type": "REGISTRY" } }, "totalInstance": 200, "usedInstance": 0, "availableInstance": 200, "version": "2.3.1", "latestVersion": "2.3.3", "createTime": 1635576800332, "dueTo": 4102415999000, "latestJobId": 12339, "engineAdditionalActions": ["Retry"], "specType": "CSE2", "reference": { "vpc": "vpc-test", "vpcId": "09902850-9454-4715-9764-018f0c3701hy", "azList": ["test"], "networkId": "88550801-e892-4f8e-b21b-f7147f604f69", "subnetCidr": "192.168.0.0/24", "subnetCidrV6": "2407:c080:11f0:11::/64", "subnetGateway": "192.168.0.2", "publicIpId": null, "serviceLimit": 200, "instanceLimit": 200, "inputs": { "is_arm_cluster": "false", "nodeFlavor": "s6.large.2" } } }] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Authorization 否 String 若微服务引擎专享版开启了安全认证，此参数必填。否则，无此参数。 开启了安全认证的微服务引擎专享版Token，格式为： Authorization:Bearer {Token} Token获取方法，请参考获取微服务引擎专享版用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 properties 是 Object 微服务扩展属性，可以自定义KEY和相应的Value。长度最小1字节。

URI PUT /v4/{project_id}/registry/microservices/{service_id}/properties 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 微服务引擎专业版，请填租户项目id，长度为1~64， 获取方法请参考获取项目ID。也可以填固定值default。 微服务引擎专享版，请填固定值：default。 service_id 是 String 微服务唯一标识。字符长度为1~64，正则表达式为^.*$，获取方法请参考查询所有微服务信息。

响应参数 状态码： 400 表4 响应Body参数 参数 参数类型 描述 errorCode String 错误代码。 errorMessage String 错误信息。 detail String 详细定位信息。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 errorCode String 错误代码。 errorMessage String 错误信息。 detail String 详细定位信息。

响应示例 { "components": [ { "source": { "kind": "package", "url": "obs://bucket0001/weather-1.0.0.jar", "storage": "obs" }, "name": "mycomponent", "id": "b8702b0f-94d3-4822-98a1-56815632a0a0", "labels": null, "runtime_stack": { "name": "OpenJDK8", "deploy_mode": "virtualmachine", "version": "1.1.1" }, "external_accesses": null, "status": { "component_status": "RUNNING", "available_replica": 1, "replica": 1, "fail_detail": null, "last_job_id": "JOB8be53b2a-af9a-4e2b-8505-096688a52237", "creator": "ss-test", "create_time": 1679556221028, "update_time": 1679556318779 }, "environment_name": "sudo", "environment_id": "4d084044-0b80-4641-963c-b9c9f4092a4f", "application_name": "app-39mbbn", "application_id": "fc092465-a5fb-4a52-bc65-b735f18366d8", "creator": "ss-test", "platform_type": "cce", "version": "2023.0323.15181" } ], "count": 1 }

响应消息 表4 响应参数 参数 参数类型 描述 count Integer 组件总数。 components Array of objects 组件参数，请参考表5。 表5 components 参数 参数类型 描述 id String 组件ID。 name String 组件名称。 labels Array of objects 标签。容器部署可通过标签查询对应工作负载，虚机部署可配置对应的微服务名称的标签来使用优雅上下线功能，请参考表10。 status Object 组件状态，请参考表8。 runtime_stack Object 技术栈，请参考表7。 application_name String 应用名称。 application_id String 应用ID。 environment_name String 环境名称。 environment_id String 环境ID。 version String 版本号。 source Object 代码/软件包来源，请参考表6。 creator String 创建人。 platform_type String 部署类型。 external_accesses Array of Objects 外部访问，请参考表11。 表6 source 参数 参数类型 描述 kind String 组件来源类型。 code，源码。 package，软件包。 image，镜像包。 version String 版本号。 url String 包地址，类型为package和image时需要添加。 storage String 存储方式，例如：obs。 auth String 认证方式，例如：iam。 repo_auth String 授权名称。 repo_namespace String 代码仓库命名空间。 repo_ref String 代码分支或者Tag，例如：master。 repo_type String 代码仓类型，例如：CodeArts、Gitee、GitHub、BitBucket、GitLab。 web_url String 代码跳转链接，例如：https://github.com/example/demo.git。 repo_url String 代码仓url，例如：https://github.com/example/demo.git。 表7 runtime_stack 参数 参数类型 描述 name String 技术栈名称。 type String 技术栈类型，支持Java、Tomcat、Nodejs、Php、Docker、Python。 当部署模式为虚机部署时，仅支持Java、Tomcat、Nodejs；容器部署上述类型都支持。 version String 技术栈版本。 deploy_mode String 部署模式。 表8 status参数 参数 参数类型 描述 component_status String 组件状态。 INITIALIZING，初始化。 UPGRADING，升级中。 FAILED，失败。 RUNNING，运行中。 DOWN，下线。 DELETING，删除中。 DELETED，已删除。 RESERVED，保留。 STARTING，启动中。 STOPPING，停止中。 STOPPED，停止。 RESTARTING，重启中。 PENDING，未就绪。 UNKNOWN，未知。 PARTIALLY_FAILED，部分失败。 available_replica Integer 可用实例。 replica Integer 总实例。 fail_detail String 失败原因。 cluster_deleted，集群被删除。 cluster_unavailable，集群不可用。 cluster_inaccessible，集群无法访问。 namespace_deleted，命名空间被删除。 namespace_unavailable，命名空间不可用。 namespace_inaccessible，命名空间无法访问。 resource_deleted，资源已删除。 create_failed，创建组件失败。 delete_failed，删除组件失败。 last_job_id String 最后执行任务ID。 create_time Integer 创建时间。 update_time Integer 更新时间。 creator String 创建人。 artifact Object 组件构建信息，请参考表9。 表9 artifact 参数 参数类型 描述 type String 组件来源类型。 虚拟机部署支持软件包package。 容器部署支持软件包package、镜像包image。 url String 软件包/镜像地址。 表10 labels 参数 参数类型 描述 key String 标签名称 value String 标签值 表11 external_accesses 参数 参数类型 描述 protocol String 外部访问类型，取值范围为：http、https。 address String 外部访问地址。 forward_port Integer 外部访问端口。

请求消息 表3 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），默认取值为“application/json;charset=utf8”。 X-Auth-Token 是 String 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考获取用户Token。

请求消息 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），默认取值为“application/json;charset=utf8”。 X-Auth-Token 是 String 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考获取用户Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 泳道的名称。 由大小写英文字母、数字、中划线（-）、下划线（_）组成，并以大小写英文字母开头，大小写英文字母或者数字结尾，长度为2~64个字符。 tag 是 String 泳道的标签。 type 是 String 泳道的类型。当泳道组下没有泳道时，必须先创建基线泳道；当泳道组下已创建基线泳道时，只能创建灰度泳道。 BASE，基线泳道。 GRAY，灰度泳道。

响应示例 { "id": "9974a8b3-cbd7-4084-bac9-194f7d5ba3da", "name": "gray", "swimlane_group_id": "b76dad96-66cf-4ae7-aa55-11b6d630e777", "type": "GRAY", "tag": "gray", "weight": 0, "route_status": "DISABLED", "rule_match_mode": null, "project_id": "4008a952b3f44b5a919c9a48d90811f3", "rules": null, "creator": "test_user", "create_time": 1722928561358, "update_time": 1722928561358 }

响应消息 表4 响应参数 参数 参数类型 描述 id String 泳道ID。 name String 泳道名称。 swimlane_group_id String 所属的泳道组ID。 type String 泳道类型。 BASE：基线泳道。 GRAY：灰度泳道。 tag String 泳道标签，根据标签来控制流量的走向。 route_status String 泳道路由状态。 ENABLE：开启路由。 DISABLE：关闭路由。 rule_match_mode String 路由规则匹配模式。 当泳道组灰度类型为基于内容，即gray_release_type为CONTENT时生效。 ALL：匹配所有的规则。 ANY：匹配任一规则。 rules Array of objects 路由规则。当泳道组灰度类型为基于内容，即gray_release_type为CONTENT时生效。请参考表5。 weight Integer 泳道流量权重，范围在0-100之间。当泳道组灰度类型为基于流量，即gray_release_type为WEIGHT时生效。 project_id String 项目ID。 create_time Integer 创建时间。 update_time Integer 更新时间。 creator String 创建人。 表5 rules 参数 参数类型 描述 type String 灰度匹配规则类型。当前只支持HEADER，即基于Header头进行匹配。 key String 键。 value String 值。 condition String 匹配条件。 EXACT：精确匹配。 PREFIX：前缀匹配。 REGEX：正则匹配。

请求消息 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），默认取值为“application/json;charset=utf8”。 X-Auth-Token 是 String 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考获取用户Token。

URI GET /v3/{project_id}/cas/applications/{application_id}/configuration 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户项目ID。获取方法，请参考获取项目ID。 application_id 是 String 应用ID。获取方法，请参考获取所有应用。 表2 查询参数 参数 是否必选 参数类型 描述 environment_id 否 String 环境ID。获取方法，请参考获取所有环境。

响应示例 { "configuration": [ { "application_id": "fdd7889d-eef8-4db1-befc-7037b02d949e", "environment_id": "0fa75dfe-0d32-4bc1-848b-8008cf3f2567", "configuration": { "env": [ { "name": "app-env", "value": "env" } ] } } ] }

请求消息 表3 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），默认取值为“application/json;charset=utf8”。 X-Auth-Token 是 String 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考获取用户Token。

响应消息 表4 响应参数 参数 参数类型 描述 configuration Array of objects 配置列表，请参考表5。 表5 configuration 参数 参数类型 描述 application_id String 应用ID。 environment_id String 环境ID。 configuration Object 环境变量配置，请参考表6。 表6 configurationEnv 参数 参数类型 描述 env Array of object 环境变量，请参考表7。 表7 env 参数 参数类型 描述 name String 变量名。 value String 变量值。

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 id String 微服务引擎专享版专享版ID。 name String 微服务引擎专享版名称。 jobId Integer 微服务引擎专享版执行任务ID。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 errorCode String 错误代码。 errorMessage String 错误信息。 detail String 详细定位信息。 状态码： 500 表8 响应Body参数 参数 参数类型 描述 errorCode String 错误代码。 errorMessage String 错误信息。 detail String 详细定位信息。

请求示例 创建一个名称为“test”微服务引擎专享版，其计费模式为按需计费，规格为cse.s1.small2，可用区为test，关闭安全认证，微服务引擎的部署类型为CSE2。 POST https://{endpoint}/v2/{project_id}/enginemgr/engines { "name": "test", "description": "test", "payment": "1", "flavor": "cse.s1.small2", "azList": ["test"], "authType": "NONE", "vpc": "vpc-demotest", "vpcId": "09902850-9454-4715-9764-018f0c37022", "networkId": "88550801-e892-4f8e-b21b-f7147f6229", "subnetCidr": "192.168.0.5/26", "specType": "CSE2, "inputs": { "nodeFlavor": "s6.large.2" } }