华为云用户手册

添加模块 主要介绍多终端独立版站点编辑中左侧导航栏“添加”模块的相关特性，如表8所示。 表8 添加模块特性 添加模块特性 入门版（PC端） 入门版（手机端） 标准版（PC端） 标准版（手机端） 营销版&企业版（PC端） 营销版&企业版（手机端） 文本/图片模块 √ √ √ √ √ √ 图文模块 √ × √ × √ × 音乐模块 √ √ √ √ √ √ 视频模块 √ √ √ √ √ √ 导航栏模块 √ √ √ √ √ √ Html代码模块 √ √ √ √ √ √ 多语言模块 √ √ √ √ √ √ 通栏模块 √ × √ × √ × 会员模块 √ √ √ √ √ √ 购物车模块 × × √ √ √ √ 模块动画效果模块 √ √ √ √ √ √

手机微应用插件 主要介绍多终端独立版站点编辑中左侧导航栏“插件”模块的“微应用”页签的相关特性，如表7所示。 表7 手机微应用插件特性 手机微应用插件特性 入门版（PC端） 入门版（手机端） 标准版（PC端） 标准版（手机端） 营销版&企业版（PC端） 营销版&企业版（手机端） 刮刮乐插件 × √ × √ × √ 大转盘插件 × √ × √ × √ 砸金蛋插件 × √ × √ × √ 微调研插件 × × × × × √ 微助力插件 × × × × × √ 微预约插件 × × × × × √ 微报名插件 × × × × × √ 微信分享插件 × × × × × √ 微名片插件 × × × × × √ 微现场插件 × × × × × √ 微红包插件 × × × × × √ 好友赞助插件 × × × × × √ 微众筹插件 × × × × × √ 微夺宝插件 × × × × × √ 水果机插件 × × × × × √ 摇一摇插件 × × × × × √ 贺卡插件 × × × × × √ 微会务插件 × × × × × √

搜索引擎优化 搜索引擎优化（SEO）的目标是提高网站在搜索引擎中的自然排名，从而增加有效访问量，让网站在行业内占据领先地位，获得品牌收益。如表3所示，主要介绍多终端独立版站点的搜索引擎优化相关特性。 表3 搜索引擎优化特性 搜索引擎优化特性 入门版 标准版 营销版 企业版 网站关键字和描述 √ √ √ √ 网站html静态化 × × √ √ 网站sitemap √ √ √ √ 301跳转 × × √ √ 404页面设置 √ √ √ √ 链接nofollow设置 √ √ √ √ 百度自动推送 × × √ √ 搜索引擎爬虫统计 √ √ √ √

营销插件 主要介绍多终端独立版站点编辑中左侧导航栏“插件”模块的“营销”页签的相关特性，如表6所示。 表6 营销插件特性 营销插件特性 入门版（PC端） 入门版（手机端） 标准版（PC端） 标准版（手机端） 营销版&企业版（PC端） 营销版&企业版（手机端） 广告插件 √ × √ × √ × 站内广告插件 × √ × √ × √ 搜狐畅言评论插件 √ √ √ √ √ √ 投票插件 √ √ √ √ √ √ 优惠券插件 × × × × √ √ 秒杀插件 × × × × √ √ 团购插件 × × × × √ √ 积分产品插件 × × × × √ √ Paypal购物插件 √ √ √ √ √ √

会员管理系统 主要介绍多终端独立版站点的会员管理系统相关特性，如表4所示。 表4 会员管理系统特性 会员管理系统特性 入门版 标准版 营销版 企业版 添加新用户 √ √ √ √ 会员管理 √ √ √ √ 会员注册项 √ √ √ √ 会员等级 √ √ √ √ 第三方帐号 √ √ √ √ 管理员管理 √ √ √ √ 角色管理 √ √ √ √ 邮件发送设置（会员忘记密码可通过邮件重置密码） √ √ √ √ 邮件发送设置（新会员注册、新订单提醒等） × × √ √ 会员卡管理 × × √ √ 会员交易 × × √ √

简介 多终端独立版站点提供PC、手机、微信公众号、小程序、APP五站合一的模板建站产品，适用于贸易类企业的B2C交易类型网站和跨境官网电商等网站建设。支持网站后台数据统一管理，多个终端共享同一套数据。可对多个终端分别编辑网站前台，可打造多样化终端，实现多个终端展示效果不同、内容不同。提供3000+套付费模板和600套免费模板，包含较完善的页面框架，素材和测试数据，可极大的缩短网站编辑上线时间。版本分为入门版、标准版、营销版和企业版四种版本，如表1所示。 多终端独立版产品目前已下线，不支持新购，历史存量用户可继续使用。

页面管理 主要介绍多终端独立版站点编辑中页面管理的相关特性，如表2所示。 表2 页面管理特性 页面管理特性 入门版 标准版 营销版 企业版 自定义页面地址 √ √ √ √ 鼠标拖动调整顺序 √ √ √ √ 复制页面 √ √ √ √ 复制为底版 √ √ √ √ 设定导航栏是否可见 √ √ √ √ 支持设定密码访问 √ √ √ √ 支持站外链接 √ √ √ √ 设定页脚是否显示 √ √ √ √ 页面的SEO设置 √ √ √ √ 编辑页面底版 √ √ √ √

操作系统服务与支持计划 Huawei Cloud EulerOS 版本 停止服务与支持日期 Huawei Cloud EulerOS 2.0 2028-06-30 Huawei Cloud EulerOS 1.1 2026-06-30 openEuler 版本 主要支持结束时间 扩展支持结束时间 openEuler 20.03 LTS 2022-3-30 2024-03-30 openEuler 22.03 LTS 2024-3-30 2026-03-30 EulerOS 版本 停止服务与支持日期 EulerOS 2.0SP12 2028-12-31 EulerOS 2.0SP11 2027-12-31 EulerOS 2.0SP10 2026-12-31 EulerOS 2.0SP9 2025-12-31 EulerOS 2.0SP8 2024-12-31 EulerOS 2.0SP5 2024-06-30 EulerOS 2.0SP3 2022-12-31 EulerOS 2.0SP2 2021-12-31 EulerOS 2.0SP1 2019-09-30 CentOS 版本 主要支持结束时间 扩展支持结束时间 CentOS 8 2021-12-31 2021-12-31 CentOS 7 2020-08-06 2024-06-30 CentOS 6 2017-05-10 2020-11-30 Debian 版本 停止支持日期 Debian 13 暂无明确时间 Debian 12 暂无明确时间 Debian 11 暂无明确时间 Debian 10 2022-09-10 Debian 9 2020-07-18 Debian 8 2018-06-17 Debian 7 2016-04-25 Ubuntu 版本 停止支持日期 Ubuntu 22.04 LTS 2027-04 Ubuntu 20.04 LTS 2025-04 Ubuntu 18.04 LTS 2023-06 Ubuntu 16.04 LTS 2021-04 Ubuntu 14.04 LTS 2019-04 Red Hat 版本 完全支持停止日期 Red Hat 9 2027-05-31 Red Hat 8 2024-05-31 Red Hat 7 2019-08-06 Red Hat 6 2016-05-10 FreeBSD 版本 停止维护更新日期 FreeBSD 13.0 FreeBSD 13.1发布后3个月 FreeBSD 12.3 2022-08-21 FreeBSD 12.2 2022-03-31 FreeBSD 12.1 2021-01-31 FreeBSD 12.0 2020-02-04 FreeBSD 11.4 2021-09-30 FreeBSD 11.3 2020-09-30 FreeBSD 11.2 2019-10-31 FreeBSD 11.1 2018-09-30 FreeBSD 11.0 2017-11-30 OpenSUSE 版本 停止维护更新日期 OpenSUSE 15.3 2022-11-30 OpenSUSE 15.2 2022-01-04 OpenSUSE 15.1 2021-02-02 OpenSUSE 15.0 2019-12-03 OpenSUSE 42.3 2019-07-01 OpenSUSE 42.2 2018-01-26 OpenSUSE 42.1 2017-05-17 SUSE Linux 版本 一般支持日期 SUSE Linux Enterprise Server 15 SP6 SUSE Linux Enterprise Server 15 SP7发布后的6个月 SUSE Linux Enterprise Server 15 SP5 2024-12-31 SUSE Linux Enterprise Server 15 SP4 2023-12-31 SUSE Linux Enterprise Server 15 SP3 2022-12-31 SUSE Linux Enterprise Server 15 SP2 2021-12-31 SUSE Linux Enterprise Server 15 SP1 2021-01-31 SUSE Linux Enterprise Server 15 2019-12-31 SUSE Linux Enterprise Server 12 SP5 2024-10-31 SUSE Linux Enterprise Server 12 SP4 2020-06-30 SUSE Linux Enterprise Server 12 SP3 2019-06-30 SUSE Linux Enterprise Server 12 SP2 2018-03-31 SUSE Linux Enterprise Server 12 SP1 2017-05-31 SUSE Linux Enterprise Server 12 2016-06-30 Fedora 版本 停止支持日期 Fedora 35 2022-12-13 Fedora 34 2022-06-07 Fedora 33 2021-11-30 Fedora 32 2021-05-25 Fedora 31 2020-11-24 Fedora 30 2020-05-26 Fedora 29 2019-11-26 Fedora 28 2019-05-28 Fedora 27 2018-11-30 Rocky Linux 版本 停止维护更新日期 Rocky Linux 8.5 2022-5-15 AlmaLinux 版本 停止维护更新日期 AlmaLinux 8.5 2031-11 Windows Server 版本 主要支持结束时间 扩展支持结束时间 Windows Server 2019 2024-01-09 2029-01-09 Windows Server 2016 2022-01-11 2027-01-12 Windows Server 2012 2018-10-09 2023-10-10 Windows Server 2012 R2 2018-10-19 2023-10-10 Windows Server 2008 已停止 已停止 Windows Server 2003 已停止 已停止

鲲鹏系统架构云服务器系列 以下云服务器支持的操作系统请参考表7。 鲲鹏通用计算增强型：kc1 鲲鹏内存优化型：km1 以下云服务器支持的操作系统请参考表8。 鲲鹏通用计算增强型：kc2 鲲鹏内存优化型：km2 鲲鹏超高I/O型云服务器：ki1系列支持CentOS 7.6、Huawei Cloud EulerOS 2.0。 鲲鹏AI推理加速型云服务器：kAi1s系列仅支持CentOS 7.6、Ubuntu 18.04 Server。 表7 OS-支持版本 OS发行版本 支持版本 Huawei Cloud EulerOS Huawei Cloud EulerOS 2.0 标准版 Huawei Cloud EulerOS 2.0 等保2.0三级版 CentOS 64bit：CentOS 8：8.0 64bit：CentOS 7：7.6/7.5/7.4 Ubuntu 64bit：Ubuntu 18.04 Server EulerOS 64bit：EulerOS 2.8 Red Hat 64bit：Red Hat 7：7.6/7.5 SUSE Linux Enterprise 64bit：SLES 12 SP5/SP4 64bit：SLES 15 openSUSE 64bit：openSUSE Leap 15：15.0 Fedora 64bit：Fedora 29 Debian 64bit：Debian 10.2.0 openEuler 64bit：openEuler 20.03 KylinSec 麒麟信安 64bit：KylinSec 3.3 Kylin 银河麒麟 64bit：KylinOS_V10_SP3 64bit：KylinOS_V10_SP2 64bit：KylinOS_V10_SP1 UnionTechOS 统信 64 bit：UnionTechOS Server 20 1050e NeoKylin 中标麒麟 64bit：NeoKylin 7.6 Rocky Linux 64bit：Rocky Linux 8.7 表8 OS-支持版本 OS发行版本 支持版本 Huawei Cloud EulerOS Huawei Cloud EulerOS 2.0 标准版 Huawei Cloud EulerOS 2.0 等保2.0三级版 CentOS 64bit：CentOS 7.6 Debian 64bit：Debian 10.2.0 openEuler 64bit：openEuler 20.03 Kylin 银河麒麟 64bit：KylinOS_V10_SP1

x86系统架构云服务器系列 以下云服务器支持的操作系统请参考表1。 通用入门型：t6 通用计算型：s2、s3、s6、sn3、s7、s7n 通用计算增强型：c3、c6、c6s、c7、c7t、c7 内存优化型：m2、m3、m6、m7 高性能计算型：hc2、h3 磁盘增强型：d2、d3、d6 以下云服务器支持的操作系统请参考表2。 通用计算增强型：c3ne 内存优化型：m3ne 以下云服务器支持的操作系统请参考表3。 超大内存型：e3、e6、e7 以下云服务器支持的操作系统请参考表4。 超高I/O型：i3、ir3 以下云服务器支持的操作系统请参考表5。 超高I/O型：i7、ir7 以下云服务器支持的操作系统请参考表6。 通用计算增强型：ac7、ac8 其他GPU加速型实例参考GPU产品说明。 建议您使用操作系统官方发行版本进行系统构建，避免对发行版本进行裁剪及高度定制，以减少问题发生概率。 操作系统发行版本由操作系统厂商进行不定期版本更迭，部分系统版本厂商已停止维护，不再发布问题修复及安全补丁，建议及时关注厂商公告进行系统升级更新，保证您系统的健壮性。 表1 OS-支持版本 OS发行系列 支持版本 Windows Windows Server 2022 Standard/Datacenter Windows Server 2019 Standard/Datacenter Windows Server 2016 Standard/Datacenter Windows Server 2012 R2 Standard/Datacenter Windows Server 2012 Standard/Datacenter Windows Server 2008 R2 Standard/Enterprise/Datacenter/Web Windows Server Core Version 1709 Huawei Cloud EulerOS 64bit：Huawei Cloud EulerOS 2.0 标准版 64bit：Huawei Cloud EulerOS 2.0 等保2.0三级版 64bit：Huawei Cloud EulerOS 1.1 CentOS兼容版 说明： 仅s6/c6s/c6/m6/d6系列云服务器支持Huawei Cloud EulerOS 1.1 CentOS兼容版操作系统。 Huawei Cloud EulerOS 1.1 CentOS兼容版仅支持新加坡区域。 CentOS 64bit：CentOS 8：8.3/8.2/8.1/8.0 64bit：CentOS 7：7.9/7.8/7.7/7.6/7.5/7.4/7.3/7.2/7.1/7.0 64bit：CentOS 6：6.10/6.9/6.8/6.7/6.6/6.5/6.4/6.3 CentOS Stream 64bit：CentOS Stream 9 64bit：CentOS Stream 8 Ubuntu 64bit：Ubuntu 24.04/22.04/20.04/18.04/16.04/14.04/12.04 Server 说明： Ubuntu 24.04目前仅在c7n/s7n/m7n系列云服务器使用avx指令集。 EulerOS 64bit：EulerOS 2.5/2.3/2.2 Red Hat 64bit：Red Hat 8：8.0 64bit：Red Hat 7：7.9/7.8/7.6/7.5/7.4/7.3/7.2/7.1/7.0 64bit：Red Hat 6：6.10/6.9/6.8/6.7/6.6/6.5/6.4 SUSE Linux Enterprise 64bit：SLES 15：15 SP5/15 SP4/15 SP3/15 SP2/15 SP1/15 64bit：SLES 12：12 SP5/12 SP4/12 SP3/12 SP2/12 SP1/12 64bit：SLES 11：11 SP4/11 SP3 Debian 64bit：Debian 12：12.0.0 64bit：Debian 11：11.6.0、11.1.0 64bit：Debian 10：10.0.0~10.5.0、10.7.0 64bit：Debian 9：9.13.0/9.12.0/9.11.0/9.9.0/9.8.0/9.7.0/9.6.0/9.5.0/9.4.0/9.3.0/9.0.0 64bit：Debian 8：8.0.0~8.10.0 openSUSE 64bit：openSUSE Leap 42：42.3/42.2/42.1 64bit：openSUSE Leap 15：15.1/15.0 64bit：openSUSE 13：13.2 Fedora 64bit：Fedora 22~32 CoreOS 64bit：CoreOS 2079.4.0 FreeBSD 64bit：FreeBSD 12.1、FreeBSD 11.0、FreeBSD 10.3 说明： 使用FreeBSD 11.0创建的云服务器不支持添加和删除网卡。 openEuler 64bit：openEuler 22.03 64bit：openEuler 20.03 AlmaLinux 64bit：AlmaLinux 9.0 64bit：AlmaLinux 8.4 64bit：AlmaLinux 8.3 Rocky Linux 64bit：Rocky Linux 9.0 64bit：Rocky Linux 8.5 64bit：Rocky Linux 8.4 表2 OS-支持版本 OS发行版本 支持版本 Windows Windows Server 2019 Datacenter Windows Server 2016 Standard/Datacenter Windows Server 2012 R2 Standard/Datacenter Windows Server 2008 R2 Enterprise/Datacenter/Web/Standard Windows Server Version 1709 Datacenter CentOS 64bit： CentOS 8 CentOS 7 CentOS 6 Ubuntu 64bit： Ubuntu 22.04 Server Ubuntu 20.04 Server Ubuntu 18.04 Server Ubuntu 16.04 Server Ubuntu 14.04 Server EulerOS 64bit： EulerOS 2.5 EulerOS 2.3 EulerOS 2.2 Red Hat 64bit： Red Hat 7 Red Hat 6 SUSE Linux Enterprise 64bit： SLES 12 SLES 11 Debian 64bit： Debian 9 Debian 8 openSUSE 64bit： openSUSE 15.1 openSUSE 15.0 Fedora 64bit： Fedora 2x openEuler 64bit： openEuler 20.03 表3 OS-支持版本 OS发行版本 支持版本 Huawei Cloud EulerOS 说明： 仅e6系列云服务器支持此操作系统。 Huawei Cloud EulerOS 2.0 标准版 Huawei Cloud EulerOS 2.0 等保2.0三级版 CentOS 64bit： CentOS 8 CentOS 7 CentOS 6 Ubuntu 64bit： Ubuntu 20.04 Server Ubuntu 18.04 Server Ubuntu 16.04 Server Ubuntu 14.04 Server EulerOS 64bit： EulerOS 2.5 EulerOS 2.3 EulerOS 2.2 Red Hat 64bit： Red Hat 7 Red Hat 6 SUSE Linux Enterprise 64bit： SLES 15 SLES 12 SLES 11 Debian 64bit： Debian 10 Debian 9 Debian 8 openSUSE 64bit： openSUSE 15.1 openSUSE 15.0 Fedora 64bit： Fedora 3x Fedora 2x openEuler 64bit： openEuler 20.03 表4 OS-支持版本 OS发行版本 支持版本 CentOS 64bit： CentOS 7 Ubuntu 64bit： Ubuntu 20.04 Server Ubuntu 18.04 Server Ubuntu 16.04 Server Ubuntu 14.04 Server EulerOS 64bit： EulerOS 2.3 EulerOS 2.2 SUSE Linux Enterprise 64bit： SLES 12 Debian 说明： ir3系列云服务器不支持Debian操作系统。 64bit： Debian 9 Debian 8

响应示例 状态码：200 正常返回 { "tasks" : [ { "task_id" : "As805BudhcH1lDs6gbn", "destination_type" : "OBS", "task_name" : "newtask", "create_time" : 1606554932552, "state" : "RUNNING", "last_transfer_timestamp" : 1606984428612 } ], "total_number" : 1 }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 total_number Integer 转储任务总数。 quota Integer 可创建的转储任务配额。 tasks Array of TransferTask objects 转储任务列表。 表4 TransferTask 参数 参数类型 描述 task_name String 转储任务名称。 state String 转储任务状态。 ERROR：错误。 STARTING：启动中。 PAUSED：已停止。 RUNNING：运行中。 DELETE：已删除。 ABNORMAL：异常。 destination_type String 转储任务类型。 OBS：转储到OBS。 create_time Long 转储任务创建时间。 last_transfer_timestamp Long 转储任务最近一次转储时间。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 tag 是 Tag object 标签对象。 表4 Tag 参数 是否必选 参数类型 描述 key 否 String 键。 不能为空。 对于同一资源键值唯一。 字符集：A-Z，a-z ， 0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 value 否 String 值。 长度不超过43个字符。 字符集：A-Z，a-z ， 0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 只能包含数字、字母、中划线“-”、下划线“_”。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 app_name 是 String APP的名称，用户数据消费程序的唯一标识符。 应用名称由字母、数字、下划线和中划线组成，长度为1～200个字符。

请求示例 给租户添加权限策略 POST https://{Endpoint}/v2/{project_id}/streams/{stream_name}/policies { "stream_id" : "CiFdELMr0401K9GGZlp", "principal_name" : "domainname1", "action_type" : "putRecords", "effect" : "accept" } 给子用户添加权限策略 POST https://{Endpoint}/v2/{project_id}/streams/{stream_name}/policies { "stream_id" : "CiFdELMr0401K9GGZlp", "principal_name" : "domainname1.username1", "action_type" : "putRecords", "effect" : "accept" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 stream_id 是 String 通道唯一标识符。 principal_name 是 String 授权用户。 如果授权给指定租户，格式为：domainName.*；如果授权给租户下的指定子用户，则格式为：domainName.userName； 支持多账号添加，用","隔开，比如：domainName1.userName1,domainName2.userName2； action_type 是 String 授权操作类型。 putRecords：上传数据。 getRecords：下载数据。 getStreamInfo：通道详情。 effect 是 String 授权影响类型。 accept：允许该授权操作。

URI DELETE /v2/{project_id}/checkpoints 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 stream_name 是 String 该Checkpoint所属的通道名称。 app_name 是 String 该Checkpoint关联App名称。 checkpoint_type 是 String Checkpoint类型。 LAST_READ：在数据库中只记录序列号。 partition_id 否 String 该Checkpoint所属的通道分区标识符。可定义为如下两种样式：- shardId-0000000000- 0比如一个通道有三个分区，那么分区标识符分别为0, 1, 2，或者shardId-0000000000, shardId-0000000001, shardId-0000000002

请求示例 提交Checkpoint POST https://{Endpoint}/v2/{project_id}/checkpoints { "stream_name" : "newstream", "app_name" : "newapp", "partition_id" : "0", "sequence_number" : "2", "checkpoint_type" : "LAST_READ" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 app_name 是 String APP的名称，用户数据消费程序的唯一标识符，需要先通过创建App接口创建。 checkpoint_type 是 String Checkpoint类型。 LAST_READ：在数据库中只记录序列号。 stream_name 是 String 已创建的通道名称。 partition_id 是 String 通道的分区标识符。可定义为如下两种样式：- shardId-0000000000- 0比如一个通道有三个分区，那么分区标识符分别为0, 1, 2，或者shardId-0000000000, shardId-0000000001, shardId-0000000002 sequence_number 是 String 需要提交的序列号，用来记录该通道的消费检查点，需要保证该序列号处于有效范围内。 metadata 否 String 用户消费程序端的元数据信息。 元数据信息的最大长度为1000个字符。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 操作标识：仅限于delete delete：批量删除 tags 是 Array of Tag objects 标签列表。 表4 Tag 参数 是否必选 参数类型 描述 key 否 String 键。 不能为空。 对于同一资源键值唯一。 字符集：A-Z，a-z ， 0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 value 否 String 值。 长度不超过43个字符。 字符集：A-Z，a-z ， 0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 只能包含数字、字母、中划线“-”、下划线“_”。

请求示例 批量删除资源标签 POST https://{Endpoint}/v2/{project_id}/stream/{stream_id}/tags/action { "action" : "delete", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value3" } ] }

请求示例 更新通道生命周期 PUT https://{Endpoint}/v3/{project_id}/streams/{stream_name} { "stream_name" : "stz_test", "data_duration" : 48 } 更新通道类型 PUT https://{Endpoint}/v3/{project_id}/streams/{stream_name} { "stream_name" : "stz_test", "data_type" : "JSON" }

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 stream_name 是 String 待更新的通道名称。 data_duration 否 Integer 数据保留时长。 取值范围：24~72。 单位：小时。 空表示使用缺省值。 data_type 否 String 源数据类型。 BLOB：存储在数据库管理系统中的一组二进制数据。 JSON：一种开放的文件格式，以易读的文字为基础，用来传输由属性值或者序列性的值组成的数据对象。 CS V：纯文本形式存储的表格数据，分隔符默认采用逗号。 缺省值：BLOB。 data_schema 否 String 用于描述用户JSON、CSV格式的源数据结构，采用Avro Schema的语法描述。 auto_scale_enabled 否 Boolean 是否开启自动扩缩容。 true：开启自动扩缩容。 false：关闭自动扩缩容。 默认不开启。 auto_scale_min_partition_count 否 Long 当自动扩缩容启用时，自动缩容的最小分片数。 auto_scale_max_partition_count 否 Long 当自动扩缩容启用时，自动扩容的最大分片数。

响应示例 状态码：200 正常返回 { "stream_id" : "8QM3Nt9YTLOwtUVYJhO", "stream_name" : "newstream", "create_time" : 1593569685875, "last_modified_time" : "1599050091026,", "retention_period" : 24, "status" : "RUNNING", "stream_type" : "COMMON", "data_type" : "BLOB", "writable_partition_count" : 1, "readable_partition_count" : 1, "tags" : [ ], "auto_scale_enabled" : false, "auto_scale_min_partition_count" : 0, "auto_scale_max_partition_count" : 0, "partitions" : [ { "status" : "ACTIVE", "partition_id" : "shardId-0000000000", "hash_range" : "[0 : 9223372036854775807]", "sequence_number_range" : "[289911 : 289927]" } ], "has_more_partitions" : false }

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 stream_name String 通道名称。 create_time Long 通道创建的时间，13位时间戳。 last_modified_time Long 通道最近一次修改的时间，13位时间戳。 status String 通道的当前状态。 CREATING：创建中 RUNNING：运行中 TERMINATING：删除中 TERMINATED：已删除 stream_type String 通道类型。 COMMON：普通通道，表示1MB带宽。 ADVANCED：高级通道，表示5MB带宽。 partitions Array of PartitionResult objects 通道的分区列表。 has_more_partitions Boolean 是否还有更多满足请求条件的分区。 是：true。 否：false。 retention_period Integer 数据保留时长，单位是小时。 stream_id String 通道唯一标识符。 data_type String 源数据类型。 BLOB：存储在数据库管理系统中的一组二进制数据。 JSON：一种开放的文件格式，以易读的文字为基础，用来传输由属性值或者序列性的值组成的数据对象。 CSV：纯文本形式存储的表格数据，分隔符默认采用逗号。 缺省值：BLOB。 data_schema String 用于描述用户JSON、CSV格式的源数据结构，采用Avro Schema的语法描述。Avro介绍您也可以点击这里查看。 compression_format String 数据的压缩类型，目前支持： snappy gzip zip 默认不压缩。 csv_properties CSVProperties object CSV 格式数据的相关属性，比如分隔符 delimiter writable_partition_count Integer 可写分区总数量（只包含ACTIVE状态的分区）。 readable_partition_count Integer 可读分区总数量（包含ACTIVE与DELETED状态的分区）。 update_partition_counts Array of UpdatePartitionCount objects 扩缩容操作记录列表。 tags Array of Tag objects 通道的标签列表。 sys_tags Array of SysTag objects 通道的企业项目。 auto_scale_enabled Boolean 是否开启自动扩缩容。 true：开启自动扩缩容。 false：关闭自动扩缩容。 默认不开启。 auto_scale_min_partition_count Integer 当自动扩缩容启用时，自动缩容的最小分片数。 auto_scale_max_partition_count Integer 当自动扩缩容启用时，自动扩容的最大分片数。 表5 PartitionResult 参数 参数类型 描述 status String 分区的当前状态。 CREATING：创建中 ACTIVE：可用 DELETED：删除中 EXPIRED：已过期 partition_id String 分区的唯一标识符。 hash_range String 分区的可能哈希键值范围。 sequence_number_range String 分区的序列号范围。 parent_partitions String 父分区。 表6 CSVProperties 参数 参数类型 描述 delimiter String 数据分隔符。 表7 UpdatePartitionCount 参数 参数类型 描述 create_timestamp Long 扩缩容操作执行时间戳，13位时间戳。 src_partition_count Integer 扩缩容操作前分区数量。 target_partition_count Integer 扩缩容操作后分区数量。 result_code Integer 扩缩容操作响应码。 result_msg Integer 扩缩容操作响应信息。 auto_scale Boolean 本次扩缩容操作是否为自动扩缩容。 true：自动扩缩容。 false：手动扩缩容。 表8 Tag 参数 参数类型 描述 key String 键。 不能为空。 对于同一资源键值唯一。 字符集：A-Z，a-z ， 0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 value String 值。 长度不超过43个字符。 字符集：A-Z，a-z ， 0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 只能包含数字、字母、中划线“-”、下划线“_”。 表9 SysTag 参数 参数类型 描述 key String 键。 不能为空。 值必须为_sys_enterprise_project_id。 value String 值。 对应的是企业项目ID，需要在企业管理页面获取。 36位UUID。

URI GET /v2/{project_id}/streams/{stream_name} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 stream_name 是 String 需要查询的通道名称。 表2 Query参数 参数 是否必选 参数类型 描述 start_partitionId 否 String 从该分区值开始返回分区列表，返回的分区列表不包括此分区。 必须将“start_partitionId”的值设置为“shardId-0000000xxx”格式，xxx为要查询的通道分区Id。 limit_partitions 否 Integer 单次请求返回的最大分区数。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 stream_name 是 String 通道名称。 通道名称由字母、数字、下划线和中划线组成，长度为1～64字符。 partition_count 是 Integer 分区数量。 分区是DIS数据通道的基本吞吐量单位。 stream_type 否 String 通道类型。 COMMON：普通通道，表示1MB带宽。 ADVANCED：高级通道，表示5MB带宽。 data_type 否 String 源数据类型。 BLOB：存储在数据库管理系统中的一组二进制数据。 JSON：一种开放的文件格式，以易读的文字为基础，用来传输由属性值或者序列性的值组成的数据对象。 CSV：纯文本形式存储的表格数据，分隔符默认采用逗号。 缺省值：BLOB。 data_duration 否 Integer 数据保留时长。 取值范围：24~72。 单位：小时。 空表示使用缺省值。 auto_scale_enabled 否 Boolean 是否开启自动扩缩容。 true：开启自动扩缩容。 false：关闭自动扩缩容。 默认不开启。 auto_scale_min_partition_count 否 Long 当自动扩缩容启用时，自动缩容的最小分片数。 auto_scale_max_partition_count 否 Integer 当自动扩缩容启用时，自动扩容的最大分片数。 data_schema 否 String 用于描述用户JSON、CSV格式的源数据结构，采用Avro Schema的语法描述。 csv_properties 否 CSVProperties object CSV 格式数据的相关属性，比如分隔符 delimiter compression_format 否 String 数据的压缩类型，目前支持： snappy gzip zip 默认不压缩。 tags 否 Array of Tag objects 通道标签列表。 sys_tags 否 Array of SysTag objects 通道企业项目列表。 表4 CSVProperties 参数 是否必选 参数类型 描述 delimiter 否 String 数据分隔符。 表5 Tag 参数 是否必选 参数类型 描述 key 否 String 键。 不能为空。 对于同一资源键值唯一。 字符集：A-Z，a-z ， 0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 value 否 String 值。 长度不超过43个字符。 字符集：A-Z，a-z ， 0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 只能包含数字、字母、中划线“-”、下划线“_”。 表6 SysTag 参数 是否必选 参数类型 描述 key 否 String 键。 不能为空。 值必须为_sys_enterprise_project_id。 value 否 String 值。 对应的是企业项目ID，需要在企业管理页面获取。 36位UUID。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 stream_id 是 String 通道唯一标识符。 principal_id 是 String 授权用户。 如果授权给指定租户，格式为：domainId；如果授权给租户下的指定子用户，则格式为：子用户的domainId； 支持多账号添加，用","隔开，比如：domainId1,domainId2； action_type 是 String 授权操作类型。 putRecords：上传数据。 getRecords：下载数据。 getStreamInfo：通道详情。 effect 是 String 授权影响类型。 accept：允许该授权操作。

请求示例 给租户添加权限策略 POST https://{Endpoint}/v3/{project_id}/streams/{streamName}/policies { "stream_id" : "CiFdELMr0401K9GGZlp", "principal_id" : "domainid1", "action_type" : "putRecords", "effect" : "accept" } 给子用户添加权限策略 POST https://{Endpoint}/v3/{project_id}/streams/{streamName}/policies { "stream_id" : "CiFdELMr0401K9GGZlp", "principal_id" : "domainid1", "action_type" : "putRecords", "effect" : "accept" }

添加转储到 对象存储服务 （OBS）的转储任务 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 CreateTransferTaskRequest request = new CreateTransferTaskRequest(); // 配置通道名称：用户在 数据接入服务 (简称DIS)控制台创建通道 request.setStreamName(streamName); // 添加OBS转储任务，并设置任务名称 OBSDestinationDescriptorRequest descriptor = new OBSDestinationDescriptorRequest(); descriptor.setTransferTaskName(taskName); // 转储至对象存储服务(简称OBS)：OBS桶名和子文件夹名，通过OBS控制台或客户端创建桶和文件夹 descriptor.setObsBucketPath("obs-dis"); descriptor.setFilePrefix("transfertask"); // 转储周期，单位s descriptor.setDeliverTimeInterval(900); // 可选：在DIS管理页面自动创建名称为“dis_admin_agency”的IAM委托，默认采用此委托，用于授权访问。如未创建过IAM委托，请用主账户登录DIS控制台并创建通道，点击“添加转储任务”，前往授权。 descriptor.setAgencyName("dis_admin_agency"); // 可选，转储OBS的目标文件格式：默认text，可配置parquet、carbon descriptor.setDestinationFileType(DestinationFileTypeEnum.TEXT.getType()); // 设置从DIS通道拉取数据时的初始偏移量: 默认LATEST，从通道内最新上传的记录开始读取; TRIM_HORIZON，从通道内最早的未过期记录开始读取 descriptor.setConsumerStrategy(PartitionCursorTypeEnum.LATEST.name()); request.setObsDestinationDescriptor(descriptor);