华为云用户手册

执行操作 当客户端请求匹配了触发条件中的规则时，将执行相关配置。当前规则引擎支持的配置详见表2。 表2 规则引擎支持的配置项 功能分类 功能名称 说明 基础配置 HTTP header响应头 与“高级配置”中的“HTTP header配置（跨域请求）”配置要求一致，生效范围不同： HTTP header响应头：仅对规则匹配的资源生效。 HTTP header配置（跨域请求）：对 域名 下所有资源生效。 高级回源 匹配了条件规则中触发条件的客户端请求，需要遵循该条件规则中的高级回源配置。 回源请求头 匹配了条件规则中触发条件的客户端请求，需要遵循该规则中回源请求头配置。 提升访问安全 访问控制 匹配了条件规则中触发条件的客户端请求，需要遵循该条件规则中的访问控制配置。当前可配置允许和拒绝。 允许：匹配条件的请求可正常访问资源。 拒绝：匹配条件的请求将被拦截，返回403状态码。 请求限速 匹配了条件规则中触发条件的客户端请求，需要遵循该规则中请求限速配置。 提升命中率 回源URL改写 匹配了条件规则中触发条件的客户端请求，需要遵循该条件规则中的回源URL改写配置。 改写方式：定义如何获取改写内容，支持配置精确改写和捕获改写。非规则引擎中的回源URL改写功能，匹配方式所有文件、URL路径对应精确改写，通配符对应捕获改写。 缓存规则 匹配了条件规则中触发条件的客户端请求，需要遵循该条件规则中的缓存规则配置。 访问URL重写 匹配了条件规则中触发条件的客户端请求，需要遵循该条件规则中的访问URL重写配置。

IP地址校验模式 规则引擎功能的“IP地址校验模式”分为两种，使用不同的“IP地址校验模式”会影响到CDN节点对客户端IP的判断： 建联 IP：该模式匹配的是客户端与CDN节点之间建连使用的IP，如果客户端与CDN节点之间有经过代理服务器，那么建联IP=代理服务器IP。 x-forwarded-for头：该模式匹配的是用户请求中x-forwarded-for请求头携带的左边第一个IP，不论客户端与CDN节点之间是否有经过代理服务器，x-forwarded-for头IP都=客户端真实IP。 示例：假设客户端真实IP为10.10.10.10，代理服务器IP为192.168.0.1。 没有经过代理服务器： 用户请求中x-forwarded-for请求头值：10.10.10.10。 客户端真实IP（即x-forwarded-for请求头携带的左边第一个IP）=客户端与CDN节点建连IP=10.10.10.10。 经过代理服务器： 用户请求中x-forwarded-for请求头值：10.10.10.10,192.168.0.1。 客户端真实IP（即x-forwarded-for请求头携带的左边第一个IP）=10.10.10.10。 客户端与CDN节点建连IP=代理服务器IP=192.168.0.1。 客户端真实IP（即x-forwarded-for请求头携带的左边第一个IP）≠客户端与CDN节点建连IP。

注意事项 如需使用规则引擎功能，请提交工单申请开通。 单域名最多可配置10条规则。 “业务类型”为“全站加速”的域名，暂不支持配置规则引擎。 后台有特殊配置的域名暂不支持配置规则引擎。 规则引擎功能和普通功能同时配置时，规则引擎优先级更高。 新增规则默认位于顶部，存在多条规则时顶部优先级大于底部，即如果同时匹配多条规则，高优先级的规则生效。 一个触发条件最多支持三级嵌套，最后一个层级的逻辑运算符只能是“并且”或“或者”，不能组合使用。

背景信息 HTTP Request Header中的Referer字段值代表了当前页面的请求来源，CDN节点可以通过Referer跟踪来源，对来源进行识别和判断。 用户访问加速域名网站内容时，访问请求到达CDN节点后，CDN节点会根据配置的Referer黑白名单，对访问者的身份进行识别和过滤，符合规则的可以顺利访问到该内容。如果不符合规则，该访问请求将会被禁止，返回403禁止访问的错误信息。 图1 referer原理图

配置示例 加速域名为www.example.com，该加速域名配置了referer白名单规则：包含空referer，白名单内容为www.test.com，如下图所示。 用户1：请求URL：https://www.example.com/file.html，该请求携带的referer字段值为空，CDN将会正常返回内容。 用户2：请求URL：https://www.example.com/file.html，该请求携带的referer字段值为：www.test.com，CDN将会正常返回内容。 用户3：请求URL：https://www.example.com/file.html，该请求携带的referer字段值为：www.abc.com，CDN节点将会返回403禁止访问的错误信息。 加速域名为www.example01.com，该加速域名配置了referer黑名单规则：包含空referer，黑名单内容为www.test01.com，如下图所示。 用户1：请求URL：https://www.example01.com/file.html，该请求携带的referer字段值为空，CDN节点将会返回403禁止访问的错误信息。 用户2：请求URL：https://www.example01.com/file.html，该请求携带的referer字段值为：www.test01.com，CDN节点将会返回403禁止访问的错误信息。 用户3：请求URL：https://www.example01.com/file.html，该请求携带的referer字段值为：www.bcd.com，CDN将会正常返回内容。

使用限制 如果您的后台存在特殊配置，暂不支持配置Content-Type、Cache-Control、Expires。 以下请求头仅支持修改响应头信息，不支持将“请求头操作”类型设置为“删除”： Expires Content-Disposition Content-Type Content-Language Cache-Control - 目前不支持添加/删除/编辑以下标准头部信息： a_dynamic cross-origin-embedder-policy origin strict-transport-security accept cross-origin-opener-policy ping-from te accept-ch cross-origin-resource-policy ping-to timing-allow-origin accept-charset date pragma tk accept-ch-lifetime device-memory proxy-authenticate trailer accept-push-policy dnt proxy-authorization transfer-encoding accept-ranges dpr public-key-pins upgrade accept-signature early-data public-key-pins-report-only upgrade-insecure-requests access-control-allow-credentials etag push-policy vary access-control-allow-headers expect range via access-control-allow-methods expect-ct referer-policy viewport-width access-control-allow-origin feature-policy report-to warning access-control-expose-headers forwarded retry-after width access-control-max-age from save-data www-authenticate access-control-request-headers host sec-fetch-dest x-client-ip access-control-request-method if-match sec-fetch-mode x-content-type-options age if-modified-since sec-fetch-site x-dns-prefetch-control allow if-none-match sec-fetch-user x-download-options alt-svc if-range sec-websocket-accept x-firefox-spdy authorization if-unmodified-since sec-websocket-extensions x-forwarded-for clear-site-data keep-alive sec-websocket-key x-forwarded-host connection large-allocation sec-websocket-protocol x-frame-options(xfo) content-dpr last-event-id sec-websocket-version x-permitted-cross-domain-policies content-encoding last-modified server x-pingback content-length link server-timing x-powered-by content-location location service-worker-allowed x-requested-with content-range max-age signature x-robots-tag content-security-policy max-forwards signed-headers x-ua-compatible content-security-policy-report-only nel sourcemap x-xss-protection

注意事项 证书和加速域名需要匹配，您需要配置域名或泛域名对应的证书，泛域名证书配置请参见如何配置泛域名证书。 配置项停用后证书配置信息将会被清除，再次开启HTTPS配置需要重新配置证书相关信息。 如果您的证书发生了变更，需及时同步更新CDN控制台HTTPS配置项里面的证书信息。 自有证书请参考更新HTTPS证书完成证书更新。 SCM证书请参考配置HTTPS证书为域名配置最新的证书。 如果您需要实现全链路HTTPS加密，还需要将修改回源协议配置为HTTPS（源站服务器需要支持HTTPS协议）。 关闭HTTPS证书后，客户端HTTPS请求的SSL握手会失败，从而导致所有客户端HTTPS请求失败。

背景信息 CDN支持HTTPS安全加速，您可以通过在CDN控制台配置加速域名的HTTPS证书，启用HTTPS加速服务，证书配置成功后，客户端可以使用HTTPS协议请求CDN节点。HTTP和HTTPS协议的区别如下： HTTP：HTTP协议以明文方式发送内容，不提供任何方式的 数据加密 ，如果攻击者截取了Web浏览器和网站服务器之间的传输报文，就可以直接读取其中的信息。 HTTPS：为了数据传输的安全，HTTPS在HTTP的基础上加入了SSL协议，SSL依靠证书来验证服务器的身份，并为浏览器和服务器之间的通信加密。

注意事项 带宽告警阈值小于100Mbit/s时可能频繁触发告警，请根据业务情况合理配置带宽告警阈值。 配置突发带宽告警后，如遇到重大活动可预期偶发高带宽时，请注意调整阈值（活动后请注意调回正常阈值）或临时关闭突发带宽告警。 由于监控数据存在时延，告警信息可能存在10分钟左右延时。 达到告警阈值后，将分别以短信、邮件的形式向当前账号绑定的手机号和邮箱发送提醒，修改手机号和邮箱请参考修改华为账号手机号和修改华为账号邮件地址。如果您修改了当前账号的消息接收人信息，可参考这里查看接收人中的手机号和邮件地址。

Exchange 表3 Exchange约束与限制 限制项 约束和限制 默认Exchange RabbitMQ 3.x.x版本在创建Vhost后会创建7个默认Exchange：(AMQP default)、amq.direct、amq.fanout、amq.headers、amq.match、amq.rabbitmq.trace、amq.topic。 绑定Exchange RabbitMQ 3.x.x版本中，名为“(AMQP default)”的Exchange不能绑定任何Exchange。 “Internal”为“是”的Exchange只能绑定Exchange，不能绑定Queue。 RabbitMQ AMQP-0-9-1版本的Exchange不支持绑定Exchange，只支持绑定Queue。 删除Exchange RabbitMQ 3.x.x版本中，默认Exchange不支持删除。

Queue 表4 Queue约束与限制 限制项 约束和限制 绑定Queue RabbitMQ 3.x.x版本中，名为“(AMQP default)”的Exchange不能绑定任何Queue。 “Internal”为“是”的Exchange只能绑定Exchange，不能绑定Queue。 惰性队列 RabbitMQ 3.8.35及以上版本支持惰性队列。 仲裁队列 RabbitMQ 3.8.35及以上版本支持仲裁队列。 单一活跃消费者 RabbitMQ 3.8.35及以上版本支持单一活跃消费者特性。

RabbitMQ版本差异 RabbitMQ 3.x.x版本和AMQP-0-9-1版本有部分的功能差异，具体如表1所示。 表1 版本功能差异 功能项 3.x.x AMQP-0-9-1 SSL √ × 公网访问 在RabbitMQ控制台开启公网 × 仲裁队列 √ × 镜像队列 √ × 优先级队列 √ √ 插件 √ × Web UI √ × 重置实例密码 √ × 变更实例规格 √ √ 用户管理 在Web UI设置 在RabbitMQ控制台设置 消息查询 × √

新老规格对应关系 2种RabbitMQ实例规格对比，新老规格的对应关系如所示。 表3 RabbitMQ实例新老规格对应关系 老规格 对应的新规格 规格类型 TPS参考值 规格类型 TPS参考值 4核 | 8GB * 3 3000 rabbitmq.4u8g.cluster * 3 6000 8核 | 16GB * 3 6000 rabbitmq.8u16g.cluster * 3 12000 16核 | 32GB * 3 24000 rabbitmq.16u32g.cluster * 3 48000 新老规格区别如下： 新规格性能更好，同等价格下性价比更优。 老规格使用的非独享资源，在高负载情况下容易出现资源抢占情况。新规格使用的独占资源，性能更优、稳定性更好。 新规格支持灵活的水平/垂直动态扩容，能更好的应对复杂的业务变化情况。 新规格支持更大规格的，最大可以支持rabbitmq.32u64g.cluster。 新规格除了原有的磁盘类型，还支持通用型SSD、极速型SSD等多种磁盘类型，客户选择更加灵活。

RabbitMQ实例的存储空间估算参考 在集群模式中，RabbitMQ需要对消息持久化写入到磁盘中，因此，您在创建RabbitMQ实例选择存储空间时，建议根据业务消息体积预估以及镜像队列副本数量选择合适的存储空间。镜像队列副本数最大为集群的代理数。 例如：业务消息体积预估100GB，则磁盘容量最少应为100GB*镜像队列副本数+预留磁盘大小100GB。 如果是单机实例，则是计算业务消息体积+预留磁盘大小即可。 当前RabbitMQ实例支持修改集群实例的代理个数，您可以根据业务情况，随时更改集群代理个数。单机实例暂不支持变更规格。

RabbitMQ实例规格 RabbitMQ实例兼容开源RabbitMQ 3.8.35/3.12.13和自研RabbitMQ AMQP-0-9-1，实例类型包括单机和集群，实例规格请参考表1和表2。 表1 RabbitMQ集群实例规格（3.x.x版本） 型号 代理数 存储空间范围（GB） TPS参考值 单个代理最大消费者数 单个代理建议队列数 单个代理最大连接数 rabbitmq.2u4g.cluster 3 300~90000 3000 4000 100 1000 5 500~150000 5000 4000 100 1000 7 700~210000 7000 4000 100 1000 rabbitmq.4u8g.cluster 3 300~90000 6000 8000 200 2000 5 500~150000 10000 8000 200 2000 7 700~210000 14000 8000 200 2000 rabbitmq.8u16g.cluster 3 300~90000 12000 16000 400 4000 5 500~150000 20000 16000 400 4000 7 700~210000 28000 16000 400 4000 rabbitmq.12u24g.cluster 3 300~90000 24000 24000 600 6000 5 500~150000 40000 24000 600 6000 7 700~210000 56000 24000 600 6000 rabbitmq.16u32g.cluster 3 300~90000 48000 32000 800 8000 5 500~150000 80000 32000 800 8000 7 700~210000 112000 32000 800 8000 rabbitmq.24u48g.cluster 3 300~90000 60000 40000 1000 10000 5 500~150000 100000 40000 1000 10000 7 700~210000 140000 40000 1000 10000 rabbitmq.32u64g.cluster 3 300~90000 72000 40000 1000 10000 5 500~150000 120000 40000 1000 10000 7 700~210000 168000 40000 1000 10000 上表中TPS（即生产+消费的TPS）是指以2K大小的消息为例的每秒处理消息条数，测试场景为不开启持久化的非镜像队列，实时生产实时消费，队列无积压。此数据仅供参考，生产使用需要以实际压测性能为准。 服务端的性能主要跟以下因素相关：队列数、消息堆积、连接数、channel、消费者数、镜像队列、优先级队列、消息持久化和exchange类型等，在选择实例规格时，请根据业务模型压测结果选择。 一条连接最多可以开启2047个channel。 单机版实例可用于测试场景，不建议用于生产业务，暂不提供单机版实例的产品规格。 RabbitMQ 3.x.x版本实例单个代理支持的最大连接数如上表所示，整个集群支持的最大连接数不超过30000。 表2 RabbitMQ集群实例规格（AMQP-0-9-1专业版） 型号 存储空间范围（GB） TPS参考值 实例最大连接数 实例最大队列数 amqp.p2.large.6 200~60000 3000 1000 500 amqp.p2.large.10 200~60000 5000 1000 500 amqp.p2.large.14 200~60000 7000 2000 1000 amqp.p2.large.20 200~60000 10000 2000 1000 amqp.p2.large.28 200~60000 14000 2000 1000 amqp.p2.large.40 200~60000 20000 3000 1500 amqp.p2.large.56 400~120000 28000 4000 2000 amqp.p2.large.80 400~120000 40000 6000 3000 amqp.p2.large.112 400~120000 56000 8000 4000 amqp.p2.large.144 600~180000 72000 10000 5000 amqp.p2.large.200 600~180000 100000 12000 6000 amqp.p2.large.240 800~240000 120000 16000 8000 amqp.p2.large.280 1200~360000 140000 16000 8000 上表中TPS，是指以4K大小的消息为例的每秒处理消息条数，测试场景为实时生产实时消费，队列无积压。此数据仅供参考，生产使用需要以实际压测性能为准。 服务端的性能主要跟以下因素相关：队列数、消息堆积、连接数、channel、消费者数和Exchange类型等，在选择实例规格时，请根据业务模型压测结果选择。 一条连接最多可以开启2000个channel。 单机版实例可用于测试场景，不建议用于生产业务，暂不提供单机版实例的产品规格。

与Kafka、RocketMQ的差异 表1 功能差异 功能项 RocketMQ Kafka RabbitMQ 优先级队列 不支持 不支持 3.x.x版本：支持。建议优先级大小设置在0-10之间。 AMQP-0-9-1版本：支持。优先级大小设置在1-9之间。 延迟队列 支持 不支持 3.x.x版本：不支持。 AMQP-0-9-1版本：支持。 死信队列 支持 不支持 支持 消息重试 支持 不支持 3.x.x版本：不支持。 AMQP-0-9-1版本：支持。 消费模式 支持客户端主动拉取和服务端推送两种方式。 客户端主动拉取。 支持客户端主动拉取和服务端推送两种模式。 广播消费 支持 支持 支持 消息回溯 支持 支持。Kafka支持按照offset和timestamp两种维度进行消息回溯。 3.x.x版本：不支持。RabbitMQ中消息一旦被确认消费就会被标记删除。 AMQP-0-9-1版本：支持。 消息堆积 支持 支持。考虑吞吐因素，Kafka的堆积效率比RabbitMQ总体上要高。 支持 持久化 支持 支持 支持 消息追踪 支持 不支持 3.x.x版本：不支持。 AMQP-0-9-1版本：支持。 消息过滤 支持 支持 3.x.x版本：不支持，但可以自行封装。 AMQP-0-9-1版本：支持。 多租户 支持 支持 支持 多协议支持 兼容RocketMQ协议。 只支持Kafka自定义协议。 RabbitMQ基于AMQP协议实现。 跨语言支持 支持多语言的客户端。 采用Scala和Java编写，支持多种语言的客户端。 支持多种语言的客户端。 流量控制 RocketMQ 5.x支持基于实例规格的流量控制。 支持client、user和Topic级别，通过主动设置可将流控作用于生产者或消费者。 RabbitMQ的流控基于Credit-Based算法，是内部被动触发的保护机制，作用于生产者层面。 消息顺序性 单队列（queue）内有序。 支持单分区（partition）级别的顺序性。 单线程发送、单线程消费并且不采用延迟队列、优先级队列等一些高级功能时，才能实现消息有序。 安全机制 支持SSL认证。 支持SSL、SASL身份认证和读写权限控制。 3.x.x版本：支持SSL认证。 AMQP-0-9-1版本：支持ACL访问控制。 事务性消息 支持 支持 支持

产品优势 华为云分布式消息服务RabbitMQ版完全兼容开源社区版本，旨在为您提供便捷高效的消息队列。业务无需改动即可快速迁移上云，为您节省维护和使用成本。 一键式部署，免去集群搭建烦恼 只需要在实例管理界面选好规格配置，提交订单，后台将自动创建部署完成一整套RabbitMQ实例。 兼容开源，业务零改动迁移上云 兼容社区版RabbitMQ的API，具备原生RabbitMQ的所有消息处理特性。 业务系统基于开源的RabbitMQ进行开发，只需加入少量认证安全配置，即可使用华为云分布式消息服务RabbitMQ版，做到无缝迁移。 RabbitMQ实例兼容开源社区RabbitMQ 3.8.35和3.12.13版本。 独占式体验 RabbitMQ实例采用物理隔离的方式部署，租户独占RabbitMQ实例，每个RabbitMQ之间互不影响。 高性能 单队列性能最高可达10万TPS（默认配置），增加队列可获得更高性能。 数据安全 独有的安全加固体系，提供业务操作云端审计，消息存储加密等有效安全措施。 在网络通信方面，除了提供SSL认证，还借助虚拟私有云（VPC）和安全组等加强网络访问控制。 无忧运维 华为云提供一整套完整的监控告警等运维服务，故障自动发现和告警，避免7*24小时人工值守。RabbitMQ实例自动上报相关监控指标，如分区数、主题数、堆积消息数等，并支持配置监控数据发送规则，您可以在第一时间通过短信、邮件等获得业务消息队列的运行使用和负载状态。 支持多语言客户端 RabbitMQ是一款基于AMQP协议的开源服务，用于在分布式系统中存储转发消息，服务器端用Erlang语言（支持高并发、分布式以及健壮的容错能力等特点）编写，支持多种语言的客户端，如：Python、Ruby、.NET、Java、JMS、C、PHP、ActionScript、XMPP、STOMP和AJAX等。

计费示例（包含扩容包） 假设您在2023年11月01日，购买了AstroFlow专业版有效期1年，同时订购了3个单元的人数扩容包和2个单元的资源扩容包。那么1年的费用计算过程如下： 套餐费用：4980元 * 1年 = 4980元 人数扩容包费用：3000元 * 3单元 * 1年 = 9000元 资源扩容包费用：47760元 * 2单元 * 1年 = 95520元 综上，1年的费用 = 4980 + 9000 + 95520 = 109500元

计费说明 根据您选择的版本规格进行计费。当购买专业版和企业版套餐时，计费项还包括人数扩容包和资源扩容包。如您需要快速了解Astro工作流服务的具体价格，请参见Astro工作流价格详情。 表1 AstroFlow计费项 计费项 计费项说明 适用的计费模式 计费公式 套餐规格 AstroFlow提供了不同的规格套餐，请根据自身需求，购买相应的规格套餐。 基础版：满足个人及创业团队的基础需求，用户能够低门槛入门使用该产品。 专业版：满足中大企业搭建复杂业务场景的需求，提供了更多定制和集成的功能。 企业版：满足大企业搭建高性能复杂场景的需求，支持高级流程和表单的设计。 各套餐详细介绍，请参见计费模式。 包年/包月 基础版：免费。 专业版和企业版：套餐版本单价 * 购买时长。 说明： 购买一年套餐享受优化价，例如，购买时长为1年时，实付10个月。 购买时长 购买AstroFlow套餐包的时长。 基础版支持购买1~12个月。 专业版和企业版支持购买1~9个月或者1年。 人数扩容包 AstroFlow移专业版和企业版提供了人数扩容包，请根据业务需求，购买相应数量的扩容包。 人数扩容包（人数扩容50人/单元）：用于新增更多的组织用户数。不可单独购买和退订，专业版和企业版套餐到期后，扩容包将不可使用。 包年/包月 扩容包单价 * 购买时长（以主套餐有效时间折算）。 资源扩容包 AstroFlow专业版及企业版提供了资源扩容包，请根据业务需求，购买相应数量的扩容包。 资源扩容包（总数据调用次数20万/单元/每月）：提供更多的数据调用次数。不可单独购买和退订，专业版和企业版套餐到期后，扩容包将不可使用。 包年/包月 扩容包单价 * 购买时长（以主套餐有效时间折算）。

计费示例（无扩容包） 假设您在2023年11月01日，购买了AstroFlow专业版有效期1年，并在到期前手动续费1年，则： 第一个计费周期为：2023/11/01 15:50:04 ~ 2024/11/01 23:59:59 第二个计费周期为：2024/11/01 23:59:59 ~ 2025/11/01 23:59:59 续费时需支付的费用为AstroFlow规格套餐包年/包月的费用（费用以官网实际费用为准）。

入门指引 首次使用SparkRTC，您需要完成如下操作： 注册华为账号 ：单击进入注册页面。 完成实名认证：单击进入实名认证。 账户充值：为确保正常使用SparkRTC，您需要进行账户充值（超过1元）。 提交工单联系华为云技术客服，进行业务咨询。 图1 入门流程 SparkRTC的入门操作流程说明如表1所示。 表1 入门流程说明 序号 操作方法 操作说明 1 获取App ID和域名 在SparkRTC控制台中创建应用后获取App ID和域名。 2 获取SparkRTC SDK 目前产品已转维，不再对外开放提供SDK开发包，如有疑问，请提交工单处理。 3 集成SparkRTC SDK 集成Android SDK 集成iOS SDK 集成MAC SDK 集成Windows SDK 集成Web SDK SparkRTC提供了Android、iOS、MAC、Windows和Web版本的SDK，您可以根据实际需求进行SDK的集成和开发。 4 实现SparkRTC基本功能 Android SDK功能开发 iOS SDK功能开发 MAC SDK功能开发 Windows SDK功能开发 Web SDK功能开发 集成SDK后，您需要实现SparkRTC的基本功能，如加入房间、发布和订阅流、离开房间等。 5 验证SparkRTC功能 SparkRTC基本功能开发完成后，您可以进行编译验证，其中roomId和userId可以自行定义。

客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUC CES S 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001 sdk internal error SDK内部错误，请联系技术支持。 RTC_ERR_CODE_WAIT_RSP_TIMEOUT 90000004 message response timeout 消息响应超时，请联系技术支持。 RTC_ERR_CODE_INVALID_PA RAM ETER 90000005 invalid parameter 参数传递错误，请参照API文档排查。 RTC_ERR_CODE_INVALID_OPERATION 90100001 illegal operation 非法操作，用户状态不正确。 RTC_ERR_CODE_NOT_SUPPORT_MEDIA_DEVICES 90100002 not support enumerate devices 浏览器不支持enumerateDevices方法。 RTC_ERR_CODE_NO_AVAILABLE_DEVICES 90100003 no available devices 没有找到可用设备，请排查设备是否就绪。 RTC_ERR_CODE_NO_AVAILABLE_VIDEO_INPUT_DEVICES 90100004 no available video input devices 没有找到可用摄像头设备，请排查视频采集设备是否就绪。 RTC_ERR_CODE_NO_AVAILABLE_AUDIO_INPUT_DEVICES 90100005 no available audio input devices 没有找到音频输入设备，请排查音频采集设备是否就绪。 RTC_ERR_CODE_NO_AVAILABLE_AUDIO_OUTPUT_DEVICES 90100006 no available audio output devices 没有找到音频输出设备。 RTC_ERR_CODE_STATUS_ERROR 90100007 room status error 房间状态不正确，检查是否入会成功。 RTC_ERR_CODE_WEBSOCKET_NOT_CONNECTED 90100008 websocket connection state is not "CONNECTED" websocket 链接未成功，检查链接情况。 RTC_ERR_CODE_WAIT_CONFIG_FAIL 90100009 wait server config fail 获取下发配置失败，请联系技术支持。 RTC_ERR_CODE_PUBLISH_RESPONSE_FAIL 90100010 publish response fail 发布流响应失败，请联系技术支持。 RTC_ERR_CODE_REGION_NOT_COVERED 90100011 current region is not covered, service unavailable 没有找到服务端地址，请联系技术支持。 RTC_ERR_CODE_WEBSOCKET_CONNECT_TIMEOUT 90100012 websocket connect timeout websocket建链超时，请联系技术支持。 RTC_ERR_CODE_WEBSOCKET_RECONNECT_TIMEOUT 90100013 websocket reconnect timeout websocket重连超时，请联系技术支持。 RTC_ERR_CODE_WEBSOCKET_NOT_OPEN 90100014 websocket is not open websocket链接未打开，请联系技术支持。 RTC_ERR_CODE_WEBSOCKET_INTERRUPTED 90100015 websocket connection state is idle, interrupt operation websocket链接被强制关闭，一般为离会或者重连。 RTC_ERR_CODE_WEBSOCKET_CONNECT_ERROR 90100016 websocket connect error websocket监听onerror，服务端主动断链。 RTC_ERR_CODE_CAPTURE_PERMISSION_DENIED 90100017 capture failed, permission denied 采集失败，音视频设备采集权限未被授权。建议提示用户授权摄像头/麦克风访问权限。 RTC_ERR_CODE_CAPTURE_OVER_CONSTRAINED 90100018 capture failed, Constraint parameter invalid 采集失败，音视频采集设备不支持设置的采集约束。 RTC_ERR_CODE_CAPTURE_DEVICE_NOT_FOUND 90100019 capture failed, requested device not found 采集失败，设备未找到。建议在通话开始前引导用户检查通话所需的摄像头或麦克风等设备是够就绪。 RTC_ERR_CODE_CAPTURE_DEVICE_NOT_READABLE 90100020 capture failed, maybe device is occupied by other application 采集失败，设备被占用，请检查使用状态。建议提示用户“暂时无法访问摄像头/麦克风，请确保当前没有其他应用请求访问摄像头/麦克风，并重试”。 RTC_ERR_CODE_PLAY_NOT_ALLOW 90100021 the user didn't interact with the document first, please trigger by gesture 不允许播放。 RTC_ERR_CODE_ROLE_NO_PERMISSION 90100022 the user role have no permission to operate 用户角色没有权限，请检查用户角色。 RTC_ERR_CODE_ANSWER_SDP_INVALID 90100023 the answer sdp is invalid SDP协商错误，请联系技术支持。 RTC_ERR_CODE_MEDIA_UPSTREAM_UNSUPPORTED 90100024 the upstream media is not supported 浏览器不支持媒体采集。 RTC_ERR_CODE_MEDIA_NETWORK_ERROR 90100026 media connection establish failed, please switch network or try again later 媒体建链失败，请切换网络重试。 RTC_ERR_CODE_CLIENT_RELAY_ROOM_OVER_MAXNUM 90100027 relay room number over maximum number 跨房数量超过最大值。 RTC_ERR_CODE_CLIENT_RELAY_JOINER_OVER_MAXNUM 90100028 joiner already exist in relay rooms 跨房内主播人数超过最大值。 RTC_ERR_CODE_ROOM_STREAM_STATUS_PAUSED 90100029 room stream status paused 房间音视频暂停。 RTC_ERR_CODE_SIGNATURE_EXPIRED 90100030 signature expired 签名过期。 RTC_ERR_CODE_SIGNATURE_INVALID 90100031 signature invalid 签名非法。 RTC_ERR_CODE_WINDOW_OR_NAVIGATOR_UNSUPPORTED 90100032 window or navigator error 浏览器window或者navigator异常，请升级或更换浏览器。 RTC_ERR_CODE_CHROME_VERSION_UNSUPPORTED 90100033 the kernel Chrome version is earlier than 67. 浏览器chrome内核版本低于67，请升级或更换浏览器。 RTC_ERR_CODE_WEBSOCKET_UNSUPPORTED 90100034 the websocket component is missing 浏览器websocket能力不支持，请升级或更换浏览器 RTC_ERR_CODE_WEBRTC_AVC_ENCODE_UNSUPPORTED 90100035 RTCPeerConnection unsupport AVC encoders. WebRTC不支持远端画面渲染，请升级或更换浏览器。 RTC_ERR_CODE_WEBRTC_AVC_DECODE_UNSUPPORTED 90100036 RTCPeerConnection unsupport AVC decoders. WebRTC不支持本地画面传输，请升级或更换浏览器。 RTC_ERR_CODE_WEBRTC_WECHAT_UNSUPPORTED 90100037 browser not support, the model is not in the trustlist. 该机型不支持微信浏览器。 RTC_ERR_CODE_RTC_A CS 90100100 server internal exception 服务端内部错误，请联系技术支持。 RTC_ERR_CODE_RTC_CONTROL_ERROR 90100200 server internal exception 服务端内部错误，请联系技术支持。 RTC_ERR_CODE_SFU_ERROR 90100600 server internal exception 服务端内部错误，请联系技术支持。 父主题： 接口参考

SDK介绍 媒体处理 SDK提供了创建转码任务、取消转码任务、查询转码任务、创建转码配置模板、删除转码配置模板、更新转码配置模板、查询转码配置模板等。 目前暂提供了JAVA、Python和Go三种语言SDK，若您有其它开发语言的需求，建议您通过媒体处理API进行调用。 媒体处理SDK代码不支持转义。 如果无法正常打开GitHub仓库，请检查您所使用的网络是否可以正常访问公网。由于GitHub的服务器部署在国外，国内用户访问时容易遇到无法打开的情况，请切换网络后再尝试打开。 表1 服务端SDK 语言 Github地址 参考文档 JAVA huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导

SDK列表 目前MetaStudio提供了Java、Python和Go语言SDK供开发者使用，如表1所示。您可以在GitHub仓库查看SDK更新历史、获取安装包以及查看指导文档。 SDK已知安全漏洞及修复版本、规避方案，请单击表1中的SDK对应语言的Github地址进行查看。 如果无法正常打开GitHub仓库，请检查您所使用的网络是否可以正常访问公网。由于GitHub的服务器部署在国外，国内用户访问时容易遇到无法打开的情况，请切换网络后再尝试打开。 表1 服务端SDK 语言 Github地址 参考文档 JAVA huaweicloud-sdk-java-v3 Java SDK使用指导 Python huaweicloud-sdk-python-v3 Python SDK使用指导 Go huaweicloud-sdk-go-v3 Go SDK使用指导 PHP huaweicloud-sdk-php-v3 PHP SDK使用指导 Node.js huaweicloud-sdk-nodejs-v3 Node.js SDK使用指导

订阅消息示例 { "sequence": "000000000000000001702459164879", "action": "Subscribe", "data": "{\"subscribeType\":[\"ConfBasicInfoNotify\",\"ConfDynamicInfoNotify\",\"ParticipantsNotify\",\"AttendeesNotify\",\"SpeakerChangeNotify\",\"CustomMultiPicNotify\",\"InviteResultNotify\",\"InterpreterGroupNotify\",\"NetworkQualityNotify\",\"WaitingListNotify\"],\"confToken\":\"Basic c3RiZjYyMjZlZWU4YjQ4YjllNThmNGRkYWYzMGVlMWE5YzdlZjJhZTU4ZTkzMDI0MzRh\"}" }

响应消息示例 HTTP/1.1 200 Date: Wed, 18 Dec 2019 06:20:40 GMT Content-Type: application/json;charset=UTF-8 Content-Length: 1157 Connection: keep-alive http_proxy_id: 462abfcfa8a41c2c5450eb7648bf5ad2 Server: api-gateway X-Request-Id: 7ba6f742610c03a64262b126fb336a5d [ { "conferenceID": "914673889", "mediaTypes": "Data,Voice,HDVideo", "subject": "例行会议", "size": 1, "timeZoneID": "56", "startTime": "2022-08-30 12:00", "endTime": "2022-08-30 13:00", "conferenceState": "Schedule", "accessNumber": "+991117", "language": "zh-CN", "passwordEntry": [ { "conferenceRole": "chair", "password": "******" }, { "conferenceRole": "general", "password": "******" } ], "userUUID": "ff80808167ef1edf0167f339533d05a6", "scheduserName": "金秘书", "conferenceType": 0, "confType": "FUTURE", "isAutoMute": 1, "isAutoRecord": 0, "chairJoinUri": "https://c.meeting.huaweicloud.com/#/j/914673889/6a30b8b5a325105da031442627828e496f91021ece36405f", "guestJoinUri": "https://c.meeting.huaweicloud.com/#/j/914673889/9505dc3349228b1ce0db8165590cc977bcff89785130fe0d", "recordType": 2, "confConfigInfo": { "isSendNotify": false, "isSendSms": false, "isAutoMute": true }, "vmrFlag": 0, "partAttendeeInfo": [ { "phone": "+99111********4158", "name": "张三", "type": "normal" } ], "terminlCount": 0, "normalCount": 1, "deptName": "企业协同云服务项目群" } ]

请求消息示例 PUT /v1/mmc/management/conferences?conferenceID=914087436 Connection: keep-alive X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC Content-Type: application/json user-agent: WeLink -desktop Content-Length: 372 Host: api.meeting.huaweicloud.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "mediaTypes": "HDVideo", "startTime": "2022-08-30 12:00", "length": 120, "attendees": [ { "accountId": "zhangshan@huawei.com", "appId": "caaab5a3e584497990f6a9b582a0ae42" } ], "subject": "例行会议" }

CURL命令示例 curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -d '{"mediaTypes": "Voice","attendees": [{"name": "user02","role": 1,"phone": "+8657*******"}],"conferenceType": "0","subject": "user02 conference"}' 'https://api.meeting.huaweicloud.com/v1/mmc/management/conferences?conferenceID=914087436'

请求参数 表2 参数说明 参数 是否必须 类型 位置 描述 conferenceID 是 String Query 会议ID。 说明： 创建会议时返回的conferenceID。不是vmrConferenceID。 userUUID 否 String Query 用户的UUID。 说明： 该参数将废弃，请勿使用。 X-Access-Token 是 String Header 授权令牌。获取“执行App ID鉴权”响应的accessToken。 X-Authorization-Type 否 String Header 标识是否为第三方portal过来的请求。 说明： 该参数将废弃，请勿使用。 X-Site-Id 否 String Header 用于区分到哪个HCSO站点鉴权。 说明： 该参数将废弃，请勿使用。 startTime 否 String Body 会议开始时间（UTC时间）。格式：yyyy-MM-dd HH:mm。 说明： 如果没有指定开始时间或填空串，则表示会议马上开始 时间是UTC时间，即0时区的时间 length 否 Integer Body 会议持续时长，单位分钟。默认30分钟。 最大1440分钟（24小时），最小15分钟。 subject 否 String Body 会议主题。长度限制为128个字符。 mediaTypes 是 String Body 会议的媒体类型。 Voice：语音会议 HDVideo：视频会议 groupuri 否 String Body 软终端创建即时会议时在当前字段带临时群组ID，由服务器在邀请其他与会者时在或者conference-info头域中携带。 长度限制为31个字符。 attendees 否 Array of Attendee objects Body 与会者列表。 cycleParams 否 CycleParams object Body 周期会议的参数，当会议是周期会议的时候该参数必须填写。 isAutoRecord 否 Integer Body 会议是否自动启动录制，在录播类型为：录播、录播+直播时才生效。默认为不自动启动。 1：自动启动录制 0：不自动启动录制 encryptMode 否 Integer Body 会议媒体加密模式。默认值由企业级的配置填充。 0：自适应加密 1 : 强制加密 2 : 不加密 language 否 String Body 会议通知短信或邮件的语言。默认中文。 zh-CN：中文 en-US：英文 timeZoneID 否 String Body 会议通知中会议时间的时区信息。时区信息，参考时区映射关系。 说明： 举例：“timeZoneID”:"26"，则通过华为云会议发送的会议通知中的时间将会标记为如“2021/11/11 星期四 00:00 - 02:00 (GMT) 格林威治标准时间:都柏林, 爱丁堡, 里斯本, 伦敦”。 非周期会议，如果会议通知是通过第三方系统发送，则这个字段不用填写。 recordType 否 Integer Body 录播类型。默认为禁用。 0: 禁用 1: 直播 2: 录播 3: 直播+录播 liveAddress 否 String Body 主流直播推流地址，在录播类型为 :直播、直播+录播时有效。最大不超过255个字符。 auxAddress 否 String Body 辅流直播推流地址，在录播类型为 :直播、直播+录播时有效。最大不超过255个字符。 recordAuxStream 否 Integer Body 是否录制辅流，在录播类型为：录播、录播+直播时有效。默认只录制视频主流，不录制辅流。 0：不录制 1：录制 confConfigInfo 否 ConfConfigInfo object Body 会议其他配置信息。 recordAuthType 否 Integer Body 录播观看鉴权方式，在录播类型为:录播、直播+录播时有效。 0：可通过链接观看/下载 1：企业用户可观看/下载 2：与会者可观看/下载 vmrFlag 否 Integer Body 是否使用云会议室召开预约会议。默认不使用云会议室。 0：不使用云会议室 1：使用云会议室 说明： vmrFlag不支持修改。 vmrID 否 String Body 绑定给当前创会账号的VMR ID。通过查询云会议室及个人会议ID接口获取。 说明： vmrID不支持修改。 concurrentParticipants 否 Integer Body 会议方数，会议最大与会人数限制。 0：无限制 大于0：会议最大与会人数 supportSimultaneousInterpretation 否 Boolean Body 会议是否支持同声传译 true：支持 false：不支持 confResType 否 Integer Body 会议资源类型,此参数创建后不支持修改: 0: 并发 1: 云会议室 2: 网络研讨会 3: 预留模式,暂未开放

手机号所属的国家 表1 手机号所属的国家 国家 国家码 chinaPR +86(中国大陆) chinaHKG +852（中国香港） chinaOMA +853(中国澳门) chinaTPE +886(中国台湾地区) BVl +1284 (英属维尔京群岛) Bolivia +591(玻利维亚) CZ +420(捷克共和国) GB +245(几内亚比绍) SVGrenadines +1784(圣文森特和格林纳丁斯) TAT +1868(特立尼达和多巴哥) UK +44(英国) afghanistan +93(阿富汗) albania +355(阿尔巴尼亚) algeria +213(阿尔及利亚) andorra +376(安道尔共和国) angola +244(安哥拉) argentina +54(阿根廷) armenia +374(亚美尼亚) australia +61(澳大利亚) austria +43(奥地利) azerbaijan +994(阿塞拜疆) bahamas +1242(巴哈马) bahrain +973(巴林) bangladesh +880(孟加拉国) belarus +375(白俄罗斯) belgium +32(比利时) belize +501(伯利兹) benin +229(贝宁) bosniaAndHerzegovina +387(波斯尼亚和黑塞哥维那) botswana +267(博茨瓦纳) brazil +55(巴西) brunei +673(文莱) bulgaria +359(保加利亚) burkinaFaso +226(布基纳法索) burundi +257(布隆迪) cambodia +855(柬埔寨) cameroon +237(喀麦隆) canada +1(加拿大) capeVerde +238(佛得角) caymanIslands +1345(开曼群岛) centralAfrican +236(中非) chad +235(乍得) chile +56(智利) colombia +57(哥伦比亚) comoros +269(科摩罗) congoB +242(刚果.布) congoJ +243(刚果.金) costarica +506(哥斯达黎加) croatia +385(克罗地亚) curacao +599(库拉索岛) cyprus +357(塞浦路斯) denmark +45(丹麦) djibouti +253(吉布提) dominica +1809(多米尼加共和国) ecuador +593(厄瓜多尔) egypt +20(埃及) equatorialGuinea +240(赤道几内亚) estonia +372(爱沙尼亚) finland +358(芬兰) france +33(法国) gabon +241(加蓬) gambia +220(冈比亚) georgia +995(格鲁吉亚) germany +49(德国) ghana +233(加纳) greece +30(希腊) grenada +1473(格林纳达) guatemala +502(危地马拉) guinea +224(几内亚) guyana +592(圭亚那) honduras +504(洪都拉斯) hungary +36(匈牙利) india +91(印度) indonesia +62(印度尼西亚) iraq +964(伊拉克) ireland +353(爱尔兰) israel +972( 以色列) italy +39(意大利) ivoryCoast +225(科特迪瓦) jamaica +1876(牙买加) japan +81(日本) jordan +962(约旦) kazakhstan +7(哈萨克斯坦) kenya +254(肯尼亚) kuwait +965(科威特) kyrgyzstan +996(吉尔吉斯斯坦) laos +856(老挝) latvia +371(拉脱维亚) lebanon +961(黎巴嫩) lesotho +266(莱索托) liberia +231(利比里亚) libya +218(利比亚) lithuania +370(立陶宛) luxembourg +352(卢森堡) macedonia +389(北马其顿) madagascar +261(马达加斯加) malawi +265(马拉维) malaysia +60(马来西亚) maldives +960(马尔代夫) mali +223(马里) malta +356(马耳他) mauritania +222(毛里塔尼亚) mauritius +230(毛里求斯) mexico +52(墨西哥) moldova +373(摩尔多瓦) mongolia +976(蒙古) montenegro +382 (黑山共和国) morocco +212(摩洛哥) mozambique +258(莫桑比克) myanmar +95(缅甸) namibia +264(纳米比亚) nepal +977(尼泊尔) netherlands +31(荷兰) newZealand +64(新西兰) nicaragua +505(尼加拉瓜) niger +227(尼日尔) nigeria +234(尼日利亚) norway +47(挪威) oman +968(阿曼) pakistan +92(巴基斯坦) palestine +970(巴勒斯坦) panama +507(巴拿马) papuaNewGuinea +675(巴布亚新几内亚) peru +51(秘鲁) philippines +63(菲律宾) poland +48(波兰) portugal +351(葡萄牙) puertoRico +1787(波多黎各) qatar +974(卡塔尔) romania +40(罗马尼亚) russia +7(俄罗斯) rwanda +250(卢旺达) saintMartin +590(圣马丁) salvatore +503(萨尔瓦多) saudiArabia +966(沙特阿拉伯) senegal +221(塞内加尔) serbia +381(塞尔维亚) seychelles +248(塞舌尔) sierraLeone +232(塞拉利昂) singapore +65(新加坡) slovakia +421(斯洛伐克) slovenia +386(斯洛文尼亚) somalia +252(索马里) southAfrica +27(南非) southKorea +82(韩国) spain +34(西班牙) sriLanka +94(斯里兰卡) suriname +597(苏里南) swaziland +268(斯威士兰) sweden +46(瑞典) switzerland +41(瑞士) tajikistan +992(塔吉克斯坦) tanzania +255(坦桑尼亚) thailand +66(泰国) togo +228(多哥) tunisia +216(突尼斯) turkey +90(土耳其) turkmenistan +993(土库曼斯坦) uae +971(阿联酋) uganda +256(乌干达) ukraine +380(乌克兰) uruguay +598(乌拉圭) usa +1(美国) uzbekistan +998(乌兹别克斯坦) venezuela +58(委内瑞拉) vietNam +84(越南) yemen +967(也门) zambia +260(赞比亚) zimbabwe +263(津巴布韦) 父主题： 附录