华为云用户手册

计费构成分析-按需计费的iDME商品 按需计费iDME资源变更配置后，会产生一个新订单并开始按新配置的价格计费，旧订单自动失效。您可以将服务的使用阶段按照计费信息条数分为多个计费周期。 第一个计费周期为9:00:00 ~ 10:00:00，在9:00:00 ~ 10:00:00间产生费用，该计费周期内的计费时长为3600秒。 第二个计费周期为10:00:00 ~ 11:00:00，在10:00:00 ~ 10:45:46间产生费用，该计费周期内的计费时长为2746秒。 您需要为每个计费周期付费，数字主线引擎各服务能力的计费公式如表1所示。产品价格详情中标出了单位MCU的每小时价格，您需要将每小时价格除以3600，得到每秒价格。 表1 计费公式 服务能力类型 计费公式 数字主线模型 MCU单价*MCU数量*计费时长 数字主线算力 MCU单价*MCU数量*计费时长 数字主线容量 MCU单价*MCU数量*计费时长 图1给出了上述示例配置的费用计算过程。 图中价格仅供参考。 图1 按需计费的iDME费用计算示例

计费周期 按需计费iDME商品按秒计费，每一个小时整点结算一次费用（以GMT+8时间为准），结算完毕后进入新的计费周期。计费的起点以iDME资源创建成功的时间点为准，终点以资源开始删除时间为准。 iDME从下单到资源创建成功需要一定时长，计费的起点是资源创建成功的时间点，而非下单时间。 例如，您在8:45:30创建成功一个按需计费的数字主线引擎，然后在8:55:30将其删除，则计费周期为8:00:00 ~ 9:00:00，在8:45:30 ~ 8:55:30间产生费用，该计费周期内的计费时长为600秒。

变更配置后对计费的影响 当前按需计费的iDME商品规格不满足您的业务需要时，您可以在iDME控制台发起变更操作。按需计费的iDME商品仅支持资源升配，不支持资源降配。 如果您在购买按需计费iDME资源后变更了配置，会产生一个新订单并开始按新配置的价格计费，旧订单自动失效。 如果您在一个小时内变更了配置，将会产生多条计费信息。每条计费信息的开始时间和结束时间对应不同配置在该小时内的生效时间。 这里以资源升配且无任何优惠的场景为例，计算价格仅作示例用，非官网实际价格。 例如，您在9:00:00购买了一台按需计费的数字主线引擎，MCU分配规格为数字主线模型3MCU、数字主线算力3MCU和数字主线容量1MCU，并在9:30:00升配规格为数字主线模型3MCU、数字主线算力3MCU和数字主线容量2MCU，那么在9:00:00 ~ 10:00:00间会产生两条计费信息。 第一条对应9:00:00 ~ 9:30:00，规格按照数字主线模型3MCU、数字主线算力3MCU和数字主线容量1MCU计费。 第二条对应9:30:00 ~ 10:00:00，规格按照数字主线模型3MCU、数字主线算力3MCU和数字主线容量2MCU计费。

适用计费项 数字主线引擎只有为各服务能力，即数字主线模型、数字主线容量和数字主线算力进行MCU分配后，才能确定一个数字主线引擎的具体服务规格。以下计费项支持按需计费。 表1 适用计费项 计费项 说明 数字主线引擎 MCU 随按需计费的数字主线引擎进行MCU分配的各服务能力，其计费模式也为按需计费。 假设您计划购买一个数字主线引擎，并同时进行MCU分配，规格如数字主线模型3MCU、数字主线算力3MCU和数字主线容量2MCU。在购买iDME服务页面底部，您将看到所需的费用，如图1所示。 图1 配置费用示例

使用限制 随基础版数据建模引擎购买时所配置的节点、增量包（可选）和用户资源不支持转移，后续变更规格或扩容时仅支持资源升配，不支持资源降配。即变更规格或扩容时，节点、增量包和用户数量可以增加，不可以减少。 此处以部署在公有云上为例，某用户依次购买了两套基础版数据建模引擎，分别命名为测试运行服务和生产运行服务。其中，测试运行服务在购买时配置了一个节点和一个用户，生产运行服务配置了三个节点、每种类型增量包各一个和三个用户。在使用过程中，用户发现测试运行服务的规格无法满足业务需要。此时，仅支持用户通过变更规格或扩容进行资源升配，增加测试运行服务中的节点、增量包和用户数量。但不支持将生产运行服务中的节点、增量包和用户资源转移到测试运行服务。

适用计费项 基础版数据建模引擎只有同时配置节点、增量包（可选）和用户，才能确定一个数据建模引擎的具体服务形态。以下计费项支持包年/包月。 表1 适用计费项 计费项 说明 基础版 数据建模引擎 节点 随包年/包月的数据建模引擎配置的节点，部署在公有云上，其计费模式也为包年/包月。 价格随购买节点数量增加而倍数递增。 基础版 数据建模引擎 用户 随包年/包月的数据建模引擎配置的用户，部署在公有云上，其计费模式也为包年/包月。 价格随购买用户数量增加而倍数递增。 结构化数据增量包(20GB） 随包年/包月的“基础版 数据建模引擎 节点”扩容使用的结构化数据增量包，其计费模式也为包年/包月。 价格随购买结构化数据增量包数量增加而倍数递增。 文件数据增量包(500GB) 随包年/包月的“基础版 数据建模引擎 节点”扩容使用的文件数据增量包，其计费模式也为包年/包月。 价格随购买文件数据增量包数量增加而倍数递增。 基线数据增量包(20GB*2) 随包年/包月的“基础版 数据建模引擎 节点”扩容使用的基线数据增量包，其计费模式也为包年/包月。 价格随购买基线数据增量包数量增加而倍数递增。 基础版 数据建模引擎 边缘节点 随包年/包月的数据建模引擎配置的边缘节点，部署在边缘云上，其计费模式也为包年/包月。 价格随购买节点数量增加而倍数递增。 基础版 数据建模引擎 边缘用户 随包年/包月的数据建模引擎配置的边缘用户，部署在边缘云上，其计费模式也为包年/包月。 价格随购买用户数量增加而倍数递增。 假设您计划购买一个用于部署在公有云上的基础版数据建模引擎，并同时购买一个基础版节点、每种类型的增量包各一个和一个基础版用户。在购买iDME服务页面底部，您将看到所需费用的明细，如图1所示。 图1 配置费用示例 配置费用将包括以下部分： 基础版节点：根据所选服务对应的节点类型计算的费用。 基础版读写用户：根据所选服务对应的用户类型计算的费用。 增量包：根据所选服务对应的增量包类型分别计算的费用。

变更配置后对计费的影响 当前包年/包月的iDME商品规格不满足您的业务需要时，您可以在iDME控制台发起变更或扩容操作。包年/包月的iDME商品仅支持资源升配，不支持资源降配。 资源升配的计算公式： 升配费用 =（新配置价格 - 旧配置价格）* 剩余周期 其中，剩余周期 = 每个自然月的剩余天数 / 对应自然月的最大天数。 这里以资源升配且无任何优惠的场景为例，计算价格仅作示例用，非官网实际价格，实际价格请参考工业数字模型驱动引擎价格详情。 假设您在2023/04/08购买了一个包年/包月的用于部署在公有云上的基础版数据建模引擎，并同时购买节点*1和读写用户*1，购买时长为1个月。在2023/04/18变更规格为节点*2和读写用户*2。旧配置价格为12,750.00元/月，新配置价格为25,500.00元/月。 剩余周期 = 12 / 30 + 8 / 31 = 0.6581（月） 其中，12表示4月份剩余天数，30表示4月份最大天数；8表示5月份剩余天数，31表示5月份最大天数。 升配费用 = (25,500 - 12,750) * 0.6581 = 8,392.78（元） 更多信息请参见变更资源规格费用说明。

适用场景 包年/包月的iDME商品当前是指用于运行iDME应用的基础版数据建模引擎。一套基础版数据建模引擎中至少需要同时包含节点和用户资源，以保证应用能正常运行和被用户操作。 节点：表示应用运行所需的一组固定规格的底层云服务组合（包含计算资源、数据库等）。 用户：表示使用您的应用程序的个人。 当公有云场景下的“基础版 数据建模引擎 节点”提供的规格无法满足使用需求时，您可选择变更或扩容。变更节点数量可同时增加节点的计算资源和数据容量，如果仅需增加节点的数据容量，您可使用增量包灵活扩容对应类型的数据容量。 结构化数据增量包(20GB)：此类型增量包可对节点的结构化数据容量进行扩容。单个结构化数据增量包可提供20GB的结构化数据容量。 文件数据增量包(500GB)：此类型增量包可对节点的文件数据容量进行扩容。单个文件数据增量包可提供500GB的文件数据容量。 基线数据增量包(20GB*2)：此类型增量包可对节点的基线数据容量进行扩容。单个基线数据增量包可提供40GB的基线数据容量。

到期后影响 图2描述了包年/包月的iDME商品各个阶段的状态。购买后，在计费周期内正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 图2 包年/包月的iDME商品生命周期 到期预警 包年/包月的iDME商品在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为账号的创建者。 到期后影响 当您的包年/包月的iDME商品到期未续费，首先会进入宽限期，宽限期内您可以正常访问iDME的对应资源。 如果您在宽限期内仍未续费包年/包月的iDME商品，那么就会进入保留期。保留期内，数据仍予以保留，但是您将无法访问处在保留期的商品，介时将影响使用。 保留期到期后，如果包年/包月的iDME商品仍未续费，对应的iDME商品将终止服务，系统中的数据也将被永久删除且无法恢复。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费概述。

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 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 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 1 2 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

调用API获取项目ID 您还能通过调用查询指定条件下的项目信息API获取项目ID。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "region01", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息，与路径参数中的项目ID相同。

URI GET /v1/{project_id}/rtc/rooms 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 app 是 String 应用标识 room_id 否 String 房间id state 否 String 房间状态，取值如下： RUNNING：开启中 CLOSED：已关闭 start_time 否 String 查询起始时间。UTC时间，格式：YYYY-MM-DDThh:mm:ssZ，如2020-04-23T06:00:00Z，不写默认读取过去1小时数据数据。 end_time 否 String 查询结束时间。UTC时间，格式：YYYY-MM-DDThh:mm:ssZ，如2020-04-23T07:00:00Z，不写默认为当前时间。 limit 否 Integer 查询结果条数 offset 否 Integer 查询偏移量

响应示例 状态码： 200 查询成功返回。 { "total" : 1, "room_info_list" : [ { "domain" : "603f71bdfa163e500aff1106c8xxxxxx.sparkrtc.myhuaweicloud.com", "app" : "603f71bdfa163e500aff1106c8xxxxxx", "room_id" : "ac146d0f2779916191716070xxxxxx", "state" : "RUNNING", "start_time" : "2021-04-23T09:55:30Z", "end_time" : "-" } ], "offset" : 0, "limit" : 2 } 状态码： 400 查询失败返回 { "error_code" : "DATA.100011001", "error_msg" : "Required String parameter 'app' is not present" }

响应参数 状态码： 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识 表5 响应Body参数 参数 参数类型 描述 total Integer 总数 limit Integer 查询结果限制 offset Integer 查询偏移量 room_info_list Array of RtcServerRoomInfo objects 房间列表信息 表6 RtcServerRoomInfo 参数 参数类型 描述 domain String 域名 app String 应用标识 room_id String 房间ID state String 房间状态，取值如下： RUNNING：开启中 CLOSED：已关闭 duration Integer 房间持续时长，单位：秒 start_time String 房间开始时间，即第一个用户加入房间时间，UTC时间，格式：YYYY-MM-DDThh:mm:ssZ，如2020-04-23T07:00:00Z end_time String 房间关闭时间，即最后一个room_uuid关闭的时间，UTC时间，格式：YYYY-MM-DDThh:mm:ssZ，如2020-04-23T07:00:00Z，若房间未关闭，则返回 “-” 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

状态码 调用实时音视频API时，可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。 400 Bad Request 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 Not Found 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 Method Not Allowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Timeout 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 500 Internal Server Error 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 Service Unavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 Gateway Timeout 网关超时。 父主题： 附录

数据统计分析接口 表9 数据统计分析接口 接口 说明 GET /v1/{project_id}/rtc/rooms 查询房间列表 GET /v1/{project_id}/rtc/users 查询用户列表 GET /v1/{project_id}/rtc/realtime/scale 查询实时规模 GET /v1/{project_id}/rtc/realtime/scale/dimension 查询实时规模分布 GET /v1/{project_id}/rtc/realtime/quality 查询实时质量数据 GET /v1/{project_id}/rtc/realtime/network 查询实时网络 GET /v1/{project_id}/rtc/history/usage 查询用量 GET /v1/{project_id}/rtc/history/scale 查询历史规模 GET /v1/{project_id}/rtc/history/quality 查询历史质量 GET /v1/{project_id}/rtc/client/qos/details 查询用户通话指标 GET /v1/{project_id}/rtc/client/event 查询详情事件 GET /v1/{project_id}/rtc/client/abnormalevent 查询指定项目用户异常体验事件 GET /v1/rtc/data/abnormal-events 查询用户异常体验事件 GET /v1/rtc/data/abnormal-event/dimension 查询异常事件用户分布

录制规则管理接口 表2 录制规则管理接口 接口 说明 POST /v2/apps/{app_id}/record-rules 创建或更新录制规则 GET /v2/apps/{app_id}/record-rules 查询录制规则列表 GET /v2/apps/{app_id}/record-rules/{rule_id} 查询录制规则 PUT /v2/apps/{app_id}/record-rules/{rule_id} 更新录制规则 DELETE /v2/apps/{app_id}/record-rules/{rule_id} 删除录制规则

单流任务管理接口 表6 单流任务管理接口 接口 说明 POST /v2/apps/{app_id}/individual-stream-jobs 启动单流任务 GET /v2/apps/{app_id}/individual-stream-jobs/{job_id} 查询单流任务状态 DELETE /v2/apps/{app_id}/individual-stream-jobs/{job_id} 停止单流任务 PUT /v2/apps/{app_id}/individual-stream-jobs/{job_id} 更新单流任务

合流任务管理接口 表5 合流任务管理接口 接口 说明 POST /v2/apps/{app_id}/mix-stream-jobs 启动合流任务 GET /v2/apps/{app_id}/mix-stream-jobs/{job_id} 查询合流任务 PUT /v2/apps/{app_id}/mix-stream-jobs/{job_id} 修改合流任务 DELETE /v2/apps/{app_id}/mix-stream-jobs/{job_id} 停止合流任务

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 RTC.00001001 OperationUnauthorized: get DomainID fail please check X-Auth-Token or AK/SK SparkRTC服务收到的token中解析不到domainID，无法确认租户身份 检查调用API时使用的账号是否正确：如使用了错误的token 400 RTC.00001002 MalformedRequestBody: json parsing failed 请求体(json)解析错误 查看API文档，检查参数值填写是否符合规则 400 RTC.00001003 InvalidParameterValue 参数校验异常 查看API文档，检查参数值填写是否符合规则 400 RTC.00001004 InvalidParameterCombination 字段的组合错误 查看API文档，检查参数值填写是否符合规则 400 RTC.00001005 MissingParameter 参数未携带 查看API文档，检查参数值填写是否符合规则 400 RTC.00001006 JobRunning: job exists and is not over 任务存在且并未结束，外部携带的job_uniq_id重复 等待任务结束 400 RTC.00001007 JobExceed 任务数超过限制 请提交工单申请提升任务数上限 400 RTC.00001009 JobDone: task canceled or completed 任务已取消或者已完成 请检查携带参数是否正确 400 RTC.00001010 LayoutTemplateNotExist: layout template not exist under your app 合流的模板在该appid下不存在 请携带的布局模板ID是否正确 400 RTC.00001012 UnsupportRegion: rtc does not provide services in the region SparkRTC增值业务在该region不提供服务 请填写正确的region 400 RTC.00001013 RuleForbidenDelete: rule is associated with backup rule 该录制规则被关联了备份规则，禁止删除 请先提交工单申请解除备份规则的关联关系 400 RTC.00001016 AppDeactivation: app is stopped 应用已经被停止 请确认使用的RTC服务是否欠费 400 RTC.00001017 AppsExceed: app num exceed 可创建的应用数已达上限，默认最大支持20个应用 请提交工单申请提升应用数目上限 400 RTC.00001018 UrlUnaviailable: callback url is unaviailable URL地址不通，如租户设置的回调地址等 请携带正确的回调URL地址 400 RTC.00001019 RecordRuleExist: record rule of the app exists 录制规则已经存在 需要删除相关录制规则再进行后续操作 400 RTC.00001020 AppExist: app exists 此应用名已存在 账号下已存在此应用名的app，修改app_name创建新的应用 400 RTC.00001021 NoPermission: policy doesn't allow action to be performed 没有权限调用此API 请检查生成鉴权信息的账号是否配置了访问此API的权限 400 RTC.00001022 job is not initialized 任务未完成初始化，无法进行操作 请等待任务初始化完成 404 RTC.00001008 JobNotExist: job does not exist 任务不存在 请检查携带参数是否正确 404 RTC.00001011 RecordRuleNotExist: record rule not exist under your app 录制规则在该appid下不存在 请检查携带参数是否正确 404 RTC.00001014 BucketNotExisted: bucket does not exist 桶不存在 请检查携带参数是否正确 404 RTC.00001015 AppNotExist：app does not exist under your account 应用ID在该账号下不存在 请检查调用API时使用的账号是否正确；如使用了错误的token。 500 RTC.00002001 InternalError.GeneratorIDError ID生成组件故障 请提交工单联系运维人员处理 500 RTC.00002002 InternalError.DbErr 数据库操作故障 请提交工单联系运维人员处理 500 RTC.00002003 InternalError.Transcode4xxError 媒体处理组件输入故障 请提交工单联系运维人员处理 500 RTC.00002004 InternalError.Transcode5xxError 媒体处理组件内部故障 请提交工单联系运维人员处理 500 RTC.00002005 InternalError.Live4xxError 录制组件输入故障 请提交工单联系运维人员处理 500 RTC.00002006 InternalError.Live5xxError 录制组件内部故障 请提交工单联系运维人员处理 父主题： 附录

AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //IAM用户名 "password": "********", //IAM用户密码 "domain": { "name": "domainname" //IAM用户所属账号名 } } } }, "scope": { "project": { "name": "xxxxxxxx" //项目名称 } } } } 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

约束与限制 华为云实时音视频服务设置了API流控，避免出现因短时间内重复调用API，服务中断的情况。API流控说明如表1所示。 表1 API流控说明 接口分类 接口名称 接口流控 应用管理 创建应用 查询应用列表 查询单个应用 删除应用 启用应用 停用应用 60次/分钟 录制规则管理 创建或更新录制规则 查询录制规则列表 查询录制规则 更新录制规则 删除录制规则 自动录制配置 更新自动录制配置 查询自动录制配置 应用回调管理 RTC增值（录制）事件回调配置 查询增值（录制）事件回调配置 合流任务管理 启动合流任务 查询合流任务 修改合流任务 停止合流任务 10次/秒 单流任务管理 启动单流任务 查询单流任务状态 停止单流任务 更新单流任务 房间管理 踢除在线用户 解散房间 60次/分钟 OBS桶管理 查询OBS桶列表 查询OBS桶下对象列表 OBS桶授权及取消授权 2次/秒 数据统计分析 查询房间列表 查询用户列表 查询实时规模 查询实时规模分布 查询实时质量数据 查询实时网络 查询用量 查询历史规模 查询历史质量 查询用户通话指标 查询详情事件 查询指定项目用户异常体验事件 查询用户异常体验事件 查询异常事件用户分布 30次/分钟 父主题： 使用前必读

概述 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。 您可以使用本文档提供的API对华为云实时音视频服务进行相关操作，如应用管理、合流任务管理等。支持的全部操作请参见API概览。 在调用华为云实时音视频服务的API之前，请确保已经充分了解华为云实时音视频服务的相关概念，详细信息请参见产品介绍。 父主题： 使用前必读

加密过程与加密套件 OBS Java SDK 提供了两个不同的加密套件生成器，分别是基于 AES-CTR 加密方法的 CTRCipherGenerator 与基于 RSA + AES-CTR 加密的 CtrRSACipherGenerator。 使用 CTRCipherGenerator 上传对象时，用户需要提供一个用来加密数据的数据密钥，SDK 将会针对每个对象随机生成一个初始值，并使用数据密钥与初始值加密对象，加密完成后将加密后文件上传至 OBS，并将对应的初始值存储至对象元数据中。下载该对象时，用户需要提供对应的数据密钥，SDK 会自动获取保存在对象元数据中的初始值，使用数据密钥与初始值解密对象并返回。下载时如若提供了与加密时不同的数据密钥，SDK 也将返回不可用的解密后文件。 使用 CtrRSACipherGenerator 上传对象时，用户需要提供一个 RSA 公钥，SDK 会针对每个对象随机生成一个数据密钥和初始值，并使用数据密钥与初始值加密对象，加密完成后将加密后文件上传至 OBS，随后会使用 RSA 密钥加密数据密钥，并将加密后的数据密钥与初始值存储至对象元数据中。下载该对象时，用户需要提供对应的 RSA 私钥，SDK 会自动获取保存在对象元数据中的数据密钥与初始值，并使用私钥解密数据密钥，如若提供的私钥与上传时使用的密钥不匹配，将会抛出异常。解密成功后，SDK 将会使用解密后的数据密钥与初始值解密对象并返回。

元数据中的解密信息 SDK 会将解密所需的必要信息存至对象的对象自定义元数据，并且不会有其他备份，如若您对这些数据进行了修改，将会造成数据无法解密，需要保存的信息及其含义如下表： 表2 参数名 约束 说明 encrypted-algorithm 必选 加密套件的信息 encrypted-object-key 必选（使用 RSA 加密套件时) 使用 RSA 密钥加密后的数据密钥 encrypted-start 必选 加密该对象所使用的初始值经 Base64 编码后的字符串 master-key-info 可选 加密密钥的信息 plaintext-sha256 可选 加密前对象的 sha256，流式上传不计算sha256 plaintext-content-length 可选 加密前对象的长度，流对象在上传之前无法获取长度 encrypted-sha256 可选 加密后对象的 sha256，流式上传不计算sha256