华为云用户手册

会中聊天 会议中单击会控栏的“聊天”打开界面右侧的聊天面板，可支持文字聊天。 主持人可以设置允许自由聊天、仅允许公开聊天、仅允许私聊主持人、全员禁言。 允许自由聊天：与会者可以私聊所有与会者 仅允许公开聊天：只有主持人和联席主持人可以私聊 仅允许私聊主持人：与会者只能私聊主持人和联席主持人 全员禁言：与会者禁止聊天与私聊 与会者可通过以下方式开启私聊。 方法1：在聊天框中单击与会者用户名私聊 方法2：在与会者列表中选择与会者私聊 方法3：在聊天下拉框中选中与会者私聊 会中聊天时，Windows端可识别与会者发送的超链接。您可根据需要在会中界面右侧的聊天面板中访问超链接。

多画面设置 与会者会中可根据需要切换画面布局，会议观看体验更好。 目前仅Windows客户端支持设置悬浮视图和并排视图。 当会议中有2名或以上与会者时，会中界面右上角将显示“画面布局”按钮。 与会者切换画面视图时，对其他与会者无影响。 会中主持人广播多画面时，其他与会者桌面端将显示主持人设置的多画面，无法切换画面布局。如图1所示。 主持人广播多画面操作请参考广播多画面。 系统默认声控模式，声音大的会场高亮或者大画面显示该会场。 演讲者视图中上方的小窗口按照入会时间排序。 与会者进入会中界面，单击右上角“画面布局”即可进行选择。 画廊视图：单个屏幕同时显示多个与会者，如图2所示。 画中画视图：大画面显示最大发言人视频画面或共享内容，小画面显示自己的视频画面，如图3所示。 演讲者视图：大画面显示最大发言人视频画面或共享内容，界面上方小窗口显示其他与会者视频画面，如图4所示。 悬浮视图：大画面显示最大发言人视频画面或共享内容，右侧悬浮列表显示其他与会者视频画面，如图5所示。 并排视图： 单击“并排-画廊”，可选择“并排-画廊”或“并排-演讲者”视图。 设置后，按住左右画面中间的按钮并拖拽，可调整两侧画面大小。 并排-画廊：左侧画面显示最大发言人或共享画面，右侧画面显示其他与会者画面，如图6所示。 并排-演讲者：会中有共享时，左侧画面显示共享画面，右侧画面显示最大发言人视频画面。 会中无共享时，左侧画面显示最大发言人视频画面，右侧显示与会者自己的视频画面。如图7所示。 图1 广播多画面 图2 画廊视图 图3 画中画视图 图4 演讲者视图 图5 悬浮视图 图6 并排-画廊视图 图7 并排-演讲者视图

禁止截屏 禁止截屏功能暂未开放，如需体验请发送邮件至“hcmeeting@huaweicloud.com”或联系华为销售申请开通。 仅9.7.7及以上版本的客户端支持。 目前Windows、Mac、Android端预约会议时可设置禁止截屏。 设置禁止截屏后，新版本的Windows、Mac、Android、SmartRooms系列（含IdeaHub2代系列）会中禁止截屏，通过SIP方式入会的硬件终端无法禁止截屏，较低版本、iOS等其他端则禁止入会。 可防止截取会中共享内容，部分设备可防止截取会中画面和共享内容。 在对安全性要求较高的会议场景，预约会议时可设置禁止截屏。 设置后新版本的Windows、Mac、Android、SmartRooms系列（含IdeaHub2代系列）会中无法截屏。 登录华为云会议Android端后，在首页单击“预约会议”。 在“预约会议”界面中单击“信息安全”，将“禁止截屏”右侧的按钮切换至开启状态。 图6 信息安全 单击“预约会议”。

多画面设置 多画面设置，面对面交互更灵活。与会者可以左右滑动自由选择画面布局： “画中画视图”聚焦对方，一对一沟通。 “画廊视图”全场互动，气氛更活跃。 当会议中有2名或以上参会者时，您才能切换到画廊视图。 iOS客户端画廊视图支持3x3布局（仅iPhone 7及以上设备支持）。 画廊视图可根据参会人数，自动显示布局，安卓pad显示视频画面情况如下： 2GHz，4GB内存以上机型支持3x3布局，其他机型仅支持2x2布局。 搭载麒麟990芯片/麒麟9000芯片/麒麟9000E芯片的机型支持4x4布局。

注意事项 讨论组人数暂无限制，主会场+讨论组人数需在会议上限人数规格内。 讨论组内支持本地录制，暂不支持云录制。 讨论组内与会者共享、本地录制、改名、聊天的权限均与主会场设置同步；解除静音、开启视频权限不受主会场设置影响，讨论组内与会者可自由发言和开启视频。 讨论组内的与会者返回主会场，不受锁定会议、等候室设置的影响；但讨论组内与会者离会后再次入会，将受到影响。 网络研讨会暂不支持分组讨论。 除Windows、Mac、Android和iOS客户端，其他终端暂不支持分组讨论，会议中可停留在主会场，无法进入讨论组。

结束分组讨论 主持人可根据需要主动结束分组讨论，结束后讨论组中的与会者将返回主会场。 单击会中界面右上角图标打开讨论组弹窗。 单击弹窗下方“结束分组讨论”即可。 当主持人设置了“X分钟后自动结束分组讨论”，分组讨论将在开始X分钟后自动结束。 当主持人设置了“X分钟后自动结束分组讨论”并勾选了“时间到了提醒我”，分组讨论开始X分钟后将提示主持人，由主持人选择是否结束分组讨论。 当主持人设置了“分组讨论结束后倒计时”，倒计时开始与会者将收到提示。 单击“返回主会场”可立即退出分组讨论。 单击“稍后”，倒计时期间与会者仍可停留在讨论组，倒计时结束后与会者将自动返回主会场。

注意事项 讨论组人数暂无限制，主会场+讨论组人数需在会议上限人数规格内。 讨论组内支持本地录制，暂不支持云录制。 讨论组内与会者共享、本地录制、改名、聊天的权限均与主会场设置同步；解除静音、开启视频权限不受主会场设置影响，讨论组内与会者可自由发言和开启视频。 讨论组内的与会者返回主会场，不受锁定会议、等候室设置的影响；但讨论组内与会者离会后再次入会，将受到影响。 网络研讨会暂不支持分组讨论。 除Windows、Mac、Android和iOS客户端，其他终端暂不支持分组讨论，会议中可停留在主会场，无法进入讨论组。

注意事项 付费企业已支持1080P超高清视频功能，企业管理员可登录华为云会议管理平台启用1080P超高清视频功能，详细操作请参见开启1080P超高清视频。 开启后，企业下的用户在华为云会议管理平台创建会议时，可开启该次会议的1080P超高清视频。详细操作请参见立即/预约会议。 当主持人创建会议时开启了当前会议的1080P超高清视频，与会者硬件设备满足的情况下即可生效。 企业内部入会最高支持1080P；跨企业和匿名企业入会最高支持720P。 开启功能后，客户端最高支持1080P，30帧的编码发送/接收；不开启功能，客户端最高支持720P，30帧的编码发送/接收。 会议中使用1080P超清视频功能时需要全屏/窗口最大化，单个大画面支持1080P（画廊视图下多个画面时不支持）。

步骤五：用户登录并访问资源 组织管理账号单击左侧导航栏的“总览”，在总览页面可获取用户门户URL，并将该URL传递给用户Alice。 管理员在创建用户时，在向用户发送的密码设置邮件中或者生成的一次性密码页面中也可以获取用户门户URL。 图16 获取用户门户URL 用户Alice使用浏览器打开用户门户URL，输入用户名Alice并单击“下一步”。 用于登录的密码在创建用户时获取。如果忘记密码或需要修改密码，管理员可以使用重置密码功能，重新向用户发送密码设置邮件或生成一次性密码。 图17 用户登录 输入登录密码，单击“登录”。 单击操作列的“访问控制台”，即可访问此账号下对应权限集PolicySet控制的E CS 资源。 图18 访问资源

开通组织云服务并创建组织 IAM 身份中心依赖组织云服务定义的组织来获取成员账号信息，所以使用IAM身份中心之前，必须先开通组织云服务并创建组织，以组织管理账号登录并使用IAM身份中心。 使用组织云服务之前，需要先开通企业中心功能，且只能使用企业中心的主账号创建组织，请参考以下步骤执行。 进入企业中心控制台。 单击“免费开通”，进入申请开通企业中心页面。 勾选“我已阅读并同意《华为云企业管理服务使用声明》”，并单击“免费开通”。开通后您将自动成为企业主账号，具体请参见：开通企业中心功能。 进入组织云服务控制台。 开通组织云服务。进入开通页，单击“立即开通”。 开通组织云服务后，系统会自动创建组织和根组织单元，并将开通服务的账号设置为管理账号。具体请参见：创建组织。 邀请账号加入组织，具体请参见：邀请账号加入组织。

通过访问控制，保护数据安全性 正确的使用DCS提供的访问控制能力，可以有效预防您的数据被异常窃取或者破坏。 建议对不同角色的IAM用户仅设置最小权限，避免权限过大导致数据泄露或被误操作。 为了更好的进行权限隔离和管理，建议您配置独立的IAM管理员，授予IAM管理员IAM策略的管理权限。IAM管理员可以根据您业务的实际诉求创建不同的用户组，用户组对应不同的数据访问场景，通过将用户添加到用户组并将IAM策略绑定到对应用户组，IAM管理员可以为不同职能部门的员工按照最小权限原则授予不同的数据访问权限，详情请参见DCS权限管理。 建议配置白名单或安全组访问控制，保护您的数据不被异常读取和操作。 租户创建DCS实例后，可以通过配置白名单或安全组的方式进行访问控制。租户配置IP白名单或安全组的入方向、出方向规则限制，可以控制连接实例的网络范围，避免DCS暴露给不可信第三方。 Redis 4.0、Redis 5.0和Redis 6.0基础版通过白名单控制，请参考配置白名单。 Redis 6.0企业版通过配置安全组访问规则控制，请参考配置安全组。安全组入方向规则的“源地址”应避免设置为0.0.0.0/0。 建议不使用高危命令，避免攻击者直接对Redis进行致命性破坏。 为避免攻击者直接对Redis进行致命性破坏，如果业务没有使用场景，建议通过命令重命名的方式对其进行禁用, 相关列表请参见默认禁用的命令列表，支持重命名的命令列表。 建议使用非默认端口，避免端口被扫描攻击。 Redis Server监听的端口默认为6379，容易被扫描攻击，建议将端口设置为非默认端口。支持修改的端口范围：1~65535之间的其它端口号。详情请参见自定义或修改端口。 建议限制Redis客户端最大连接数，通过限制使用的资源，降低资源耗尽和拒绝服务风险。 Redis的maxclients参数决定了实例最大支持同时连接的客户端个数，默认值为10000，设置范围为1000～50000。如果超过自定义的连接数阈值，新的连接请求将被拒绝。 建议根据应用的具体使用场景设置合适的客户端最大连接数，限制资源耗尽和拒绝服务的可能性。修改maxclients参数请参见修改配置参数。 建议限制Redis连接闲置等待时间，根据业务实际场景来设置具体时间。 为避免client空闲连接长时间占用资源，可在控制台界面配置闲置等待时间（timeout参数），设置超时阈值后，将在连接空闲指定的秒数后关闭客户端连接。timeout默认值为0，表示服务端不会主动断开客户端的空闲连接。设置范围为0~7200，单位：秒。 建议根据应用的具体使用场景设置实际闲置等待时间，不建议将timeout设置为0。例如，可以将timeout设置为3600秒。避免出现资源耗尽和拒绝服务的可能性。修改timeout参数请参见修改配置参数。 建议将访问DCS实例方式设置为密码访问，防止未经认证的客户端误操作实例。达到对客户端进行认证访问的目的，提高实例使用的安全性。 您可以在购买Redis实例时进行设置访问密码，也可以对已创建的免密实例进行密码重置。 建议为DCS实例配置ACL访问控制权限。 DCS管理员可以为实例创建只读账号或者读写账号，用于不同业务场景下访问DCS的精细管控。 建议不同的业务使用不同的DCS实例，避免实例故障影响多个业务。

审计是否存在异常数据访问 开启 云审计 服务，记录DCS的所有访问操作，便于事后审查。 云审计服务（Cloud Trace Service， CTS ），是华为 云安全 解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。 您开通云审计服务并创建和配置追踪器后，CTS可记录DCS的管理事件和数据事件用于审计。详情请参见查看DCS审计日志。 使用 云监控服务 对安全事件进行实时监控和告警。 您在使用DCS的过程中会也可能会遇到服务端返回的错误响应，为使您更好地掌握DCS实例状态，华为云提供了 云监控 服务（Cloud Eye）。您可使用该服务监控自己的DCS实例，执行自动实时监控、告警和通知操作，帮助您实时掌握DCS实例中所产生的请求、流量和错误响应等信息。 云监控服务不需要开通，会在用户创建DCS实例后自动启动。相关文档请参见DCS支持的监控指标、配置DCS监控告警。

构建数据的恢复和容灾能力 预先构建数据的容灾和恢复能力，可以有效避免异常数据处理场景下数据误删、破坏的问题。 建议开启实例自动备份，获得异常场景数据快速恢复能力。 DCS提供自动备份和手动备份两种备份操作。自动备份默认未开启，需要租户选择是否开启，备份存储期限最多7天。同时，开启自动备份后，允许对实例执行备份文件的恢复。自动备份请参见设置备份策略。 说明：手动备份是租户手动触发的实例全量备份，这些备份数据存储在华为云OBS桶中，当租户删除实例时，会同步删除OBS桶中的快照。 建议使用跨AZ复制构建数据容灾能力。 DCS的主备和集群实例支持部署高可用实例，租户可选择在单可用区或多可用区中部署实例。当租户选择跨AZ实例时，DCS实例会主动建立和维护Redis同步复制。在实例主节点故障的情况下，缓存实例会自动将备实例升为主节点，从而达到高可用的目的。如果租户使用缓存实例时，业务中读取数据比例大，可以选择4.0以上版本的读写分离实例或者集群多副本实例，缓存实例会自动维护主节点和多个备节点之间的数据同步复制，租户可以根据业务需要连接不同的地址进行读写分离。 当租户选择跨AZ实例时，DCS实例会主动建立和维护Redis同步复制。在实例主节点故障的情况下，缓存实例会自动将备实例升为主节点，从而达到高可用的目的。

步骤 登录事件网格控制台。 在左侧导航栏选择“事件订阅”，进入“事件订阅”页面。 单击“创建事件订阅”，进入订阅详情页。 单击订阅名称旁的，弹出“修改订阅”弹窗。 输入订阅名称和描述信息，单击“确定”，完成订阅名称和描述信息输入。 配置事件源。 表1 参数配置说明 参数 说明 选择提供方 请选择“华为云”。 事件源 请选择“OBS应用事件源”。 桶 请选择“选择OBS桶”。 事件类型 下拉框中事件类型根据用户需求勾选。 对象名前缀 若填写，符合规范才能触发事件。 对象名后缀 若填写，符合规范才能触发事件。 对象名编码 选择“开启”。 过滤规则 根据默认值配置，无需修改。配置过滤规则请参考过滤规则参数说明。 配置事件目标。 表2 参数配置说明 参数 说明 选择提供方 请选择“华为云”。 事件目标 请选择“FunctionGraph（函数计算）”。 函数 选择创建的OBS数据同步的函数。 版本 按需选择。 执行方式 按需选择。 委托 选择委托。如无委托，可单击旁边的“创建委托”进行创建，将会创建名为“EG_TARGET_AGENCY”委托。 类型 按需选择。

创建OBS源桶和目标桶 登录OBS控制台。 单击“创建桶”，进入“创建桶”页面。 设置桶参数。关于桶参数的详细介绍，请参考创建桶。 表1 桶参数配置 参数 说明 区域 事件网格与所在区域保持一致。 桶名称 输入示例如“eg-test”。 默认存储类别 按需选择。 桶策略 按需选择。 默认加密 按需选择。 归档数据直读 按需选择。 企业项目 按需选择。 配置完成后，单击“立即创建”，根据提示信息完成桶的创建。 以上述流程构建源桶与目标桶。 父主题： 实施步骤

目标端配置操作步骤 配置事件目标。 单击“事件目标”，右侧弹出“事件目标”弹窗。 目标服务选择“分布式消息服务 Kafka版”。 设置事件目标参数。 图2 分布式消息服务 Kafka版 表2 分布式消息服务Kafka版参数说明 参数名称 说明 目标连接 选择目标连接。如果还未创建目标连接，请先创建分布式消息服务Kafka版目标连接。 Topic 选择Topic。先选目标连接以加载Topic选项。 消息Key配置 关闭 不启用消息Key。 开启 变量：从CloudEvents标准事件中获取变量值，将变量值作为Key值。 常量：将指定的常量作为key值。若选择常量，所有消息将发送至同一分区。 规则配置 类型 变量：data.value 如果需要了解更多转换类型的信息，请参考事件内容转换。 消息推送 批量推送 配置是否开启批量推送，批量推送可帮您批量聚合多个事件。 批量推送条数 推送间隔 开启批量推送可见，每次批量推送的最大聚合条数，默认值100，输入值范围1~10000。 开启批量推送可见，输入批量推送间隔，默认值1，输入值范围0~15，单位：秒。 表3 批量推送示例 批量推送条数 推送间隔 实际发送效果 100条 1s 每隔1s批量推送100条消息 200条 5s 每隔5s批量推送500条消息 配置完成后，单击“确定”。 单击“事件流列表”操作列的“启用”，待状态列显示为“运行中”则代表整个链路创建成功。

前提条件 已开通事件网格服务并授权。 已购买Kafka实例。 已创建分布式消息Kafka版类型的目标连接，具体方式请参考目标连接。 单条消息不超过256KB。 公测期间无商用SLA承诺。 当前暂不支持跨Region、Kafka-OBS（规划中）。 云上云下、跨云厂商需用户侧拉专线。 相关监控指标 2023年9月30日上线。 父主题： 基于Serverless版事件流实现Kafka实例之间的数据同步

查看事件消息 登录分布式消息服务Kafka版控制台，选择Kafka实例所在的区域。 在“Kafka专享版”页面，单击Kafka实例的名称“eg-kafka”，进入实例详情页面。 选择“消息查询”页签，在消息页签页面，设置查询的Topic名称“topic-eg”、分区以及查询方式。 单击“搜索”，查询消息。 单击“查看消息正文”，弹出“查看消息正文”对话框，查看消息的具体内容。 图1 事件消息 父主题： 实施步骤

步骤 登录事件网格控制台。 在左侧导航栏选择“事件订阅”，进入“事件订阅”页面。 单击“创建事件订阅”，进入订阅详情页。 单击订阅名称旁的，弹出“修改订阅”弹窗。 输入订阅名称和描述信息，单击“确定”，完成订阅名称和描述信息输入。 配置事件源。 配置如下事件源参数： 选择提供方：华为云 事件源：OBS应用事件源 桶：选择OBS桶 事件类型：下拉框中事件类型根据用户需求勾选 对象名前缀：若填写，符合规范才能触发事件。默认不填写，表示全匹配。 对象名后缀：若填写，符合规范才能触发事件。默认不填写，表示全匹配。 对象名编码：开启 过滤规则：根据默认值配置，无需修改。配置过滤规则请参考过滤规则参数说明。 配置事件目标。 配置如下事件目标参数： 选择提供方：华为云 事件目标：分布式消息服务 Kafka版 目标连接：选择“kafka-connect” Topic：选择“topic-eg” 启用消息Key：关闭 规则配置类型：透传。配置转换规则请参考事件内容转换 单击“保存”，完成订阅的配置。

购买实例 登录分布式消息服务Kafka版控制台，单击页面右上方的“购买Kafka实例”。 配置如下实例参数。更多购买实例参数的详细介绍，请参考购买Kafka实例。 计费模式：按需计费 区域：与事件网格所在区域保持一致 项目：选择默认项目 可用区：根据默认项配置 实例名称：输入“eg-kafka” 企业项目：选择“default” 规格类型：默认 版本：3.x CPU架构：x86计算 代理规格：kafka.2u4g.cluster.small 代理数量：配置为“3” 存储空间：高I/O，100GB 磁盘加密：关闭 容量阈值策略：自动删除 虚拟私有云：vpc-default/subnet-default，此处选择前提条件中已准备好的vpc-default 安全组：default，此处选择前提条件中已准备好的安全组default “更多配置”中配置如下参数： Kafka SASL_SSL：开启 kafka安全协议：SASL_SSL SASL PLAIN 机制：开启 用户名：kafka-name 密码：填写密码 默认密码：确认密码 单击“立即购买”，完成Kafka实例的创建。

创建Topic 登录分布式消息服务Kafka版控制台，选择Kafka实例所在的区域。 在“Kafka专享版”页面，单击已创建的Kafka实例的名称，进入实例详情页面。 在“Topic管理”页签，单击“创建Topic”，弹出“创建Topic”对话框。 参考图1配置Topic参数，Topic名称配置为“topic-eg”，其他参数保持默认即可。更多创建Topic参数的详细介绍，请参考创建Topic。 图1 创建Topic 单击“确定”，完成创建Topic。

创建OBS桶 登录OBS控制台。 单击“创建桶”，进入“创建桶”页面。 参考图1，设置桶参数。关于桶参数的详细介绍，请参考创建桶。 区域：与事件网格所在区域保持一致 桶名称：输入示例如“eg-obs” 默认存储类别：选择“标准存储” 桶策略：选择“私有” 默认加密：不勾选 归档数据直读：选择“关闭” 企业项目：选择“default” 图1 创建桶 配置完成后，单击“立即创建”，根据提示信息完成桶的创建。 父主题： 实施步骤

资源和成本规划 本实践涉及到的资源和成本规划，如下表所示。 表1 资源和成本规划 资源 资源说明 数量 费用（元） 虚拟私有云VPC 创建一个虚拟私有云VPC。 1 00.00 虚拟私有云子网 创建一个虚拟私有云子网。 1 00.00 安全组 创建一个安全组。 1 00.00 对象存储服务 OBS 创建一个OBS桶。 说明： 创建OBS桶免费，使用阶段请参考OBS计费说明。 1 00.00 分布式消息服务 Kafka版 购买一个Kafka实例，按需计费。 1 例如：kafka.2u4g.cluster 4.35元/小时 事件网格EventGrid 创建一个事件订阅，事件源为OBS应用事件源，事件目标为分布式消息服务Kafka版。 创建一个目标连接，类型为“分布式消息服务 Kafka版”。 1 00.00 本文提供的成本预估费用仅供参考，资源的实际费用以华为云管理控制台显示为准。 父主题： 基于事件订阅将OBS应用事件源消息路由至分布式消息服务Kafka版

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 has_more_app Boolean 是否还有更多满足条件的App。 true：是。 false：否。 apps Array of DescribeAppResult objects AppEntry list that meets the current request. total_number Integer 满足条件的App总数。 表5 DescribeAppResult 参数 参数类型 描述 app_name String App的名称。 app_id String App的唯一标识符。 create_time Long App创建的时间，单位毫秒。 commit_checkpoint_stream_names Array of strings 关联通道列表。

URI GET /v2/{project_id}/apps 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 单次请求返回APP列表的最大数量。 start_app_name 否 String 从该app名称开始返回app列表，返回的app列表不包括此app名称。 stream_name 否 String 返回该通道下的app列表。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 stream_name 是 String 已创建的通道名称。 stream_id 否 String 通道唯一标识符。 当使用stream_name没有找到对应通道且stream_id不为空时，会使用stream_id去查找通道。 说明： 上传数据到被授权的通道时，必须配置此参数。 records 是 Array of PutRecordsRequestEntry objects 待上传的记录列表。 表4 PutRecordsRequestEntry 参数 是否必选 参数类型 描述 data 是 String 需要上传的数据。 上传的数据为序列化之后的二进制数据（Base64编码后的字符串）。 比如需要上传字符串“data”，“data”经过Base64编码之后是“ZGF0YQ==”。 explicit_hash_key 否 String 用于明确数据需要写入分区的哈希值，此哈希值将覆盖“partition_key”的哈希值。 取值范围：0~long.max partition_id 否 String 通道的分区标识符。可定义为如下两种样式：- shardId-0000000000- 0比如一个通道有三个分区，那么分区标识符分别为0, 1, 2，或者shardId-0000000000, shardId-0000000001, shardId-0000000002 partition_key 否 String 数据将写入的分区。说明：如果传了partition_id参数，则优先使用partition_id参数。如果partition_id没有传，则使用partition_key。

响应参数 状态码：200 表5 响应Body参数 参数 参数类型 描述 failed_record_count Integer 上传失败的数据数量。 records Array of PutRecordsResultEntry objects 上传结果列表。 表6 PutRecordsResultEntry 参数 参数类型 描述 partition_id String 数据上传到的分区ID。 sequence_number String 数据上传到的序列号。序列号是每个记录的唯一标识符。序列号由DIS在数据生产者调用PutRecords操作以添加数据到DIS数据通道时DIS服务自动分配的。同一分区键的序列号通常会随时间变化增加。PutRecords请求之间的时间段越长，序列号越大。 error_code String 错误码。 error_message String 错误消息。

响应示例 状态码：200 正常返回 { "partition_cursor" : "eyJnZXRJdGVyYXRvclBhcmFtIjp7InN0cmVhbS1uYW1lIjoianpjIiwicGFydGl0aW9uLWlkIjoiMCIsImN1cnNvci10eXBlIjoiQVRfU0VRVUVOQ0VfTlVNQkVSIiwic3RhcnRpbmctc2VxdWVuY2UtbnVtYmVyIjoiMTAifSwiZ2VuZXJhdGVUaW1lc3RhbXAiOjE1MDYxNTk1NjM0MDV9" }

URI GET /v2/{project_id}/cursors 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 stream-name 是 String 已创建的通道名称。 partition-id 是 String 通道的分区标识符。可定义为如下两种样式：- shardId-0000000000- 0比如一个通道有三个分区，那么分区标识符分别为0, 1, 2，或者shardId-0000000000, shardId-0000000001, shardId-0000000002 cursor-type 否 String 游标类型。- AT_SEQUENCE_NUMBER：从特定序列号（即starting-sequence-number定义的序列号）所在的记录开始读取数据。此类型为默认游标类型。- AFTER_SEQUENCE_NUMBER：从特定序列号（即starting-sequence-number定义的序列号）后的记录开始读取数据。- TRIM_HORIZON：从最早被存储至分区的有效记录开始读取。例如，某租户使用DIS的通道，分别上传了三条数据A1，A2，A3。N天后（设定A1已过期，A2和A3仍在有效期范围内），该租户需要下载此三条数据，并选择了TRIM_HORIZON这种下载方式。那么用户可下载的数据将从A2开始读取。- LATEST：从分区中的最新记录开始读取，此设置可以保证你总是读到分区中最新记录。- AT_TIMESTAMP：从特定时间戳（即timestamp定义的时间戳）开始读取。 starting-sequence-number 否 String 序列号。序列号是每个记录的唯一标识符。序列号由DIS在数据生产者调用PutRecords操作以添加数据到DIS数据通道时DIS服务自动分配的。同一分区键的序列号通常会随时间变化增加。PutRecords请求之间的时间段越长，序列号越大。序列号与游标类型AT_SEQUENCE_NUMBER和AFTER_SEQUENCE_NUMBER强相关，二者共同确定读取数据的位置。取值范围：0~9223372036854775807。 timestamp 否 Long 开始读取数据记录的时间戳，与游标类型AT_TIMESTAMP强相关，二者共同确定读取数据的位置。 说明： 此时间戳精确到毫秒。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 使用Token前请确保Token离过期有足够的时间，防止调用API的过程中Token过期导致调用API失败。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "id": "xxxxxxxxxxxxxxxxxx" } } } } 获取Token 后，再调用其他接口时（以数据开发组件的“查询连接列表”接口为例），您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFG....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iam.cn-north-4.myhuaweicloud.com/v1/{project_id}/connections Content-Type: application/json X-Auth-Token: ABCDEFG....