华为云用户手册

管理流水线 流水线管理是AppStage集成流水线CodeArts Pipeline服务的能力，提供可视化、可编排的CI/CD持续交付软件生产线，帮助企业快速转型，实现DevOps持续交付高效自动化，缩短应用TTM（Time to Market）交付周期，提升研发效率。 流水线服务本质上是一个可视化的自动化任务调度平台，需要配合软件开发生产线中编译构建、代码检查、测试计划、部署等服务的自动化任务使用。根据用户需要的场景，如开发测试环境应用部署、生产环境应用部署等，对这些自动化任务进行自定义编排，一次配置后就可以一键自动化触发调度执行，避免频繁低效的手工操作。 关于流水线的详细介绍文档可参见流水线CodeArts Pipeline。 父主题： 构建版本

相关说明 纳管成功后会在集群中新增一个ers-manager命名空间，并拉起一个名称为ers-cluster-agent-XXX的POD，用来定期向ERS上报数据，约占用0.5C2Gi的资源。安装的插件最小规格如下： ers-agent-register 500m/2Gi kube-rbac-proxy filebeat 100m/1Gi 上报数据维度不同，纳管后AppStage侧会为集群安装ERS monitoring插件，管理CCE集群并采集指标，插件安装会占用一定的集群资源。 集群纳管成功后，集群列表中不能马上看到集群信息。 因为ERS通过权限缓存机制查询集群列表，页面纳管成功后，后台需要进行权限缓存处理，因此需要稍等几分钟才能看到集群信息。 集群列表页面看到的集群名称和纳管录入的集群名称不一致。 集群列表显示的是ERS自定义资源名称，会在纳管集群名称前添加前缀。在集群详情中可以查看纳管集群名称。如图2所示。 图2 纳管集群名称

流水线管理 流水线管理是AppStage集成流水线CodeArts Pipeline服务的能力，提供可视化、可编排的CI/CD持续交付软件生产线，帮助企业快速转型，实现DevOps持续交付高效自动化，缩短应用TTM（Time to Market）交付周期，提升研发效率。 流水线服务本质上是一个可视化的自动化任务调度平台，需要配合软件开发生产线中编译构建、代码检查、测试计划、部署等服务的自动化任务使用。根据用户需要的场景，如开发测试环境应用部署、生产环境应用部署等，对这些自动化任务进行自定义编排，一次配置后就可以一键自动化触发调度执行，避免频繁低效的手工操作。 关于流水线的详细介绍文档可参见流水线CodeArts Pipeline。 父主题： 团队空间

维度 Key Value ga_accelerator_id 全球加速实例的ID ga_listener_id 全球加速监听器的ID ga_source_pop 全球加速实例的接入点 ga_source_area 全球加速实例的接入大区 ga_destination_region 全球加速实例的目的区域 ga_destination_area 全球加速实例的目的大区 ga_listener_region 全球加速监听器和目的区域 ga_pop_listener 全球加速接入点和监听器 ga_pop_region 全球加速接入点和目的区域 ga_pop_listener_region 全球加速接入点、监听器和目的区域 ga_source_destination_area 全球加速接入大区和目的大区 ga_outbound_region 全球加速实例的出云区域

监控指标 表1 全球加速支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期 m1_cps 并发连接数 从测量对象到后端服务器建立的所有TCP和UDP连接的数量。 单位：个 ≥ 0 全球加速实例 全球加速监听器 全球加速实例的接入大区 全球加速实例的目的区域 全球加速实例的接入点 全球加速实例的目的大区 60秒 m2_act_conn 活跃连接数 从测量对象到后端服务器建立的所有ESTABLISHED状态的TCP或UDP连接的数量。单位：个 ≥ 0 60秒 m3_inact_conn 非活跃连接数 从测量对象到所有后端服务器建立的所有除ESTABLISHED状态之外的TCP连接的数量。 单位：个 ≥ 0 60秒 m4_ncps 新建连接数 从客户端到测量对象每秒新建立的TCP和UDP连接数。 单位：个/秒 ≥ 0 60秒 m5_in_pps 流入数据包数 测量对象每秒接收到的数据包的个数。 单位：个/秒 ≥ 0 60秒 m6_out_pps 流出数据包数 测量对象每秒发出的数据包的个数。 单位：个/秒 ≥ 0 60秒 m7_in_Bps 网络流入速率 从外部访问测量对象所消耗的流量。 单位：Byte/s ≥ 0 60秒 m8_out_Bps 网络流出速率 测量对象访问外部所消耗的流量。 单位：Byte/s ≥ 0 60秒 m9_in_bandwidth 入网带宽 从外部访问测量对象所消耗的带宽。 单位：Bit/s ≥ 0 60秒 ma_out_bandwidth 出网带宽 测量对象访问外部所消耗的带宽。 单位：Bit/s ≥ 0 60秒

计费项 全球加速计费项由加速实例费用、数据传输费用两部分组成。具体请参见计费项。 表1 全球加速计费项 计费项 计费项说明 适用的计费模式 计费公式 加速实例 按照每个全球加速实例的创建时长收费。 按小时计费，创建时长不满1小时按1小时收费。 按需计费 实例费=实例单价*创建时长 数据传输 通过全球加速服务转发的流量费用，按GB收费。 从一个全球加速接入点到一个应用部署区域之间的流量，定义流量大的方向为主方向，按照每条流量的主方向收费。 按需计费 数据传输费=流量单价*使用量

适用计费项 全球加速包含两个计费项：加速实例、数据传输。 表1 适用计费项 计费项 说明 加速实例 按照每个全球加速实例的创建时长收费。 按小时计费，创建时长不满1小时按1小时收费。 实例费=实例单价*创建时长 数据传输 通过全球加速服务转发的流量费用，按GB收费。 从一个全球加速接入点到一个应用部署区域之间的流量，定义流量大的方向为主方向，按照每条流量的主方向收费。 数据传输费=流量单价*使用量

计费示例 假设您在2023/07/01 9:29:30购买了一个全球加速实例，然后在2023/07/01 10:45:46将其删除，则： 第一个计费周期为9:00:00 ~ 10:00:00，计费时长1小时。 第二个计费周期为10:00:00 ~ 11:00:00，计费时长1小时。 您需要为每个计费周期付费，产品价格详情中标出了资源的每小时价格。 计费公式如表2所示。 表2 计费公式 资源类型 计费公式 资源单价 加速实例 实例规格单价 * 计费时长 请参见全球加速价格详情。 数据传输 数据传输单价*数据传输量

注册华为云并实名认证 如果企业已注册华为云，可直接登录管理控制台，访问全球加速服务。如果企业没有登录管理控制台的帐号，请先注册华为云。 全球加速服务仅支持企业帐号实名认证并开通企业项目后使用。 登录网站https://www.huaweicloud.com/。 单击“注册”。 进入注册页面，根据提示信息完成注册，详细操作请参见如何注册华为云管理控制台的用户？ 注册成功后，系统会自动跳转至您的个人信息界面。 企业帐号实名认证，详细请参考企业账号如何完成实名认证。 开通企业项目，详细请参考如何开通企业项目。 注册成功后，该帐号可访问华为云的所有服务，包括全球加速服务。

计费样例 客户的1个应用部署在广州区域，终端用户从香港和菲律宾接入，客户需要配置1个加速实例。1小时内，客户实际产生的流量： 香港-广州 ，从用户到应用方向流量1G，从应用到用户方向流量20G，则主方向为应用到用户方向，流量为20G； 菲律宾-广州，同理算出主方向流量为5G。 则1小时内产生的总费用：加速实例费+数据传输费 = 2.26元/小时*1小时+6.98元/GB*20GB+6.98元/GB*5GB = 176.76元

计费项 表1 全球加速计费项 计费项 基础计费 价格 加速实例费 按照每个全球加速实例的创建时长收费。 按小时计费，创建时长不满1小时按1小时收费。 实例费=实例单价*创建时长 2.26 元/小时 数据传输费 通过全球加速服务转发的流量费用，按GB收费。 从一个全球加速接入点到一个应用部署区域之间的流量，定义流量大的方向为主方向，按照每条流量的主方向收费。 数据传输费=流量单价*使用量 具体请参见图1 说明： 接入点和Region部分正在部署中，实际支持的加速区域请参见支持的加速区域。 实际支持的终端节点组所在区域以管理控制台可选配置为准。 图1 数据传输费（单位：元/GB）

URI URI格式 GET /v3/{project_id}/instances/{instance_id}/major-version/available-version 参数说明 表1 参数说明 名称 参数类型 是否必选 说明 project_id String 是 租户在某一region下的project ID。 获取方法请参见获取项目ID。 instance_id String 是 实例ID。

请求示例 POST https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/hba-info [ { "type" : "host", "database" : "all", "user" : "all", "address" : "0.0.0.0/0", "mask" : "", "method" : "md5", "priority" : 0 } ]

请求消息 请求参数 表2 请求参数 参数 是否必选 参数类型 描述 数组元素 否 Array of objects 修改参数。 详情请参见表3。 表3 参数说明 参数 是否必选 参数类型 描述 type 是 String 连接类型。枚举值：host、hostssl、hostnossl database 是 String 数据库名。除template0，template1的数据库名，多个以逗号隔开。 user 是 String 除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。 值为all：表示当前实例的所有数据库用户。 值为具体的用户名，多个以逗号隔开。 address 是 String 客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。 mask 否 String 掩码，默认为空字符串。 method 是 String 认证方式。枚举值：reject、md5、scram-sha-256 priority 是 Integer 优先级，表示配置的先后。

响应消息 正常响应要素说明 表3 要素说明 参数 参数类型 描述 数组元素 Array of objects 参数列表。 详情请参见表4。 表4 参数说明 名称 参数类型 说明 status String 修改结果。 success：已生效 failed：未生效 setting：设置中 time String 修改时间。 fail_reason String 修改失败原因。 before_confs Array of objects 修改之前的值。 详情请参见表5。 after_confs Array of objects 修改之后的值。 详情请参见表6。 表5 before_confs字段说明 参数 参数类型 描述 type String 连接类型。枚举值：host、hostssl、hostnossl database String 数据库名。除template0，template1的数据库名，多个以逗号隔开。 user String 除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。 值为all：表示当前实例的所有数据库用户。 值为具体的用户名，多个以逗号隔开。 address String 客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。 mask String 掩码，默认为空字符串。 method String 认证方式。枚举值：reject、md5、scram-sha-256 priority Integer 优先级，表示配置的先后。 表6 after_confs字段说明 参数 参数类型 描述 type String 连接类型。枚举值：host、hostssl、hostnossl database String 数据库名。除template0，template1的数据库名，多个以逗号隔开。 user String 除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。 值为all：表示当前实例的所有数据库用户。 值为具体的用户名，多个以逗号隔开。 address String 客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。 mask String 掩码，默认为空字符串。 method String 认证方式。枚举值：reject、md5、scram-sha-256 priority Integer 优先级，表示配置的先后。 正常响应样例 [ { "status" : "success", "time" : "2023-08-01 09:00:00", "fail_reason" : "", "before_confs" : [ { "type" : "host", "database" : "all", "user" : "all", "address" : "0.0.0.0/0", "mask" : "", "method" : "md5", "priority" : 0 } ], "after_confs" : [ { "type" : "hostssl", "database" : "all", "user" : "all", "address" : "0.0.0.0/0", "mask" : "", "method" : "md5", "priority" : 0 } ] } ]

请求消息 请求参数 无。 URI样例 GET https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/hba-info/history?start_time=2023-08-01 00:00:00&end_time=2023-08-03 00:00:00

请求消息 请求参数 表2 请求参数 参数 是否必选 参数类型 描述 数组元素 否 Array of objects 修改参数。 详情请参见表3。 表3 参数说明 参数 是否必选 参数类型 描述 type 是 String 连接类型。枚举值：host、hostssl、hostnossl database 是 String 数据库名。除template0，template1的数据库名，多个以逗号隔开。 user 是 String 除内置用户（rdsAdmin, rdsMetric, rdsBackup, rdsRepl, rdsProxy）以外的用户名。 值为all：表示当前实例的所有数据库用户。 值为具体的用户名，多个以逗号隔开。 address 是 String 客户端IP地址。0.0.0.0/0表示允许用户从任意IP地址访问数据库。 mask 否 String 掩码，默认为空字符串。 method 是 String 认证方式。枚举值：reject、md5、scram-sha-256 priority 是 Integer 优先级，表示配置的先后。 修改或新增pg_hba.conf文件配置，以priority作为唯一标识。 priority不存在，表示新增文件配置。 priority存在，表示修改文件配置。

请求示例 PUT https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/e28979107ed04d3b8b2f1b819b8d2be3in03/hba-info [ { "type" : "host", "database" : "all", "user" : "all", "address" : "0.0.0.0/0", "mask" : "", "method" : "md5", "priority" : 0 } ]

setProxyServer setProxyServer(server: string): void 【功能说明】 设置信令代理服务器。用于企业内部部署反向代理服务器（如 nginx ）的场景。该方法为2.0.3版本新增。 【请求参数】 server：必选，string类型，反向代理服务器的列表。一个代理服务器的格式，比如：http://ip:port / https://domain:port。 【返回参数】 无 setProxyServer和setTurnServer方法需在join之前调用。

setTurnServer setTurnServer(turnServerConfig: TurnServerConfig): void 【功能说明】 设置代理服务器配置信息。用于企业内部部署反向代理服务器（如nginx）的场景。该方法为2.0.3版本新增。 【请求参数】 turnServerConfig：代理服务器配置信息。必选，TurnServerConfig类型。 TurnServerConfig 类型定义如下：{ turnServers：反向代理服务器地址。必选，string[]类型。 udpPort：UDP端口。可选，number类型。 userName：反向代理服务器用户名。可选，string类型。 credential：反向代理服务器密码。可选，string类型。 } 【返回参数】 无

getConnectionState getConnectionState(): ConnectionState 【功能说明】 获取客户端连接状态。 【请求参数】 无 【返回参数】 ConnectionState：webSocket的连接状态，string类型，取值如下： CONNECTING：连接建立中。 CONNECTED：连接已建立。 RECONNECTING：重新连接中。 DISCONNECTED：连接已断开。

setNetworkBandwidth setNetworkBandwidth(bandwidthParam: NetworkBandwidth): void 【功能说明】 设置媒体最大带宽。该方法为2.0.5版本新增。 【请求参数】 NetworkBandwidth类型定义如下：{ maxBandwidth：必选，number类型，媒体最大总带宽，取值范围为[3072, 51200]，单位为kbps。 } 【返回参数】 无

muteAudio4TopThree muteAudio4TopThree(enable: boolean): void 【功能说明】 开启音频TopN模式（最大三方模式）后，开启/禁用音频TopN模式的音轨。 【请求参数】 enable：必选，boolean类型，true表示禁用音频TopN模式的音轨，false表示开启音频TopN模式的音轨。默认为false。 【返回参数】 无 该接口需要在enableTopThreeAudioMode后设置，1.4.0版本新增。

renewSignature renewSignature(ctime: string, signature: string): boolean 【功能说明】 更新签名。 【请求参数】 ctime：签名鉴权的过期时间，是系统当前UTC时间（unix时间戳）加上鉴权过期时间（推荐2小时，最长需要小于12小时）。单位：秒。必选，string类型。 signature：签名，签名的具体生成方法请参见接入鉴权。必选，string类型，string[512]类型。 【返回参数】 boolean：返回一个boolean值，说明更新签名是否成功。 该接口2.0.8版本新增。

修订记录 表1 修订记录 修改时间 修改说明 2023-11-30 第十三次正式发布 本次变更如下： 客户端对象（Client）新增旁路推流接口：startLiveStreaming、updateLiveStreaming和stopLiveStreaming。 2022-06-29 第十二次正式发布 本次变更如下： 主入口（HRTC）createClient接口的countryCode入参修改为可选参数。 2022-06-21 第十一次正式发布 本次变更如下： 客户端对象（Client）新增setNetworkBandwidth接口。 优化部分文档描述。 2022-03-24 第十次正式发布 本次变更如下： 修改appid获取方式的相关描述。 2022-02-25 第九次正式发布 本次变更如下： 主入口（HRTC）createClient接口增加countryCode必选入参。客户端须修改代码，否则使用2.0.3 SDK创建客户端会失败。参数domain由必选修改为可选。 客户端对象（Client）subscribe、unsubscribe接口增加autoAdjustResolution可选入参。 客户端对象（Client）删除getLocalVideoStats、getRemoteVideoStats的入参。 客户端对象（Client）新增接口：setProxyServer、setTurnServer、enableRtcStats。 客户端事件通知（ClientEvent）新增事件：rtc-stats。 流对象（Stream）getStreamInfo接口返回参数中新增RTCAudioProfile类型。 本地流对象（LocalStream）addResolution接口新增audio可选入参。 客户端事件通知（ClientEvent）删除事件：live-streaming-stopped、live-streaming-started。 流事件通知（R TCS treamEvent）新增事件：audio-mixing-played、audio-mixing-finished。 新增客户端错误码。 优化部分文档描述。 2021-12-02 第八次正式发布 本次变更如下： 增加常见问题列表及处理手段。 增加浏览器支持的列表及使用限制。 优化部分文档描述。 2021-11-22 第七次正式发布 本次变更如下： 支持Firefox、Safari 11/12等浏览器适配。 优化部分文档描述。 2021-10-09 第六次正式发布 本次变更如下： 支持Safari 13+浏览器适配。 支持移动端浏览器适配。 优化部分文档描述。 2021-06-04 第五次正式发布 本次变更如下： 增加双流能力，相关接口变更包括： 流对象（Stream）新增接口：getStreamInfo增加分辨率入参。 本地流对象（LocalStream）新增接口：addResolution 和 removeResolution，增加分辨率入参。 支持端口收敛。 支持Unified-plan模式。 getRemoteVideoStats接口返回数据变更：mainStream属性对应的值，修改为RemoteVideoStats[]。 2021-01-28 第四次正式发布 本次变更如下： 客户端对象（Client）新增接口：enableTopThreeAudioMode、setVolume4TopThree、muteAudio4TopThree、enableStreamStateDetection。 客户端事件通知（ClientEvent）新增事件：stream-interrupted、stream-recovered。 本地流对象（LocalStream）新增接口：bindScreenAudio2RelatedStream。 流事件通知（RT CS treamEvent）新增事件：screen-sharing-stopped。 2020-12-25 第三次正式发布 本次变更如下： 增加本地流LocalStream的混音相关接口。 增加客户端事件ClientEvent的设备列表变更相关事件。 优化部分文档描述。 2020-11-26 第二次正式发布 本次变更如下： 新增TypeScript版本限制。 新增RTC 接入鉴权方法说明。 2020-11-18 第一次正式发布 父主题： Web SDK

URI URI格式 GET https://{Endpoint}/v3/{project_id}/instances/logs/lts-configs URI样例 https://dds.ap-southeast-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/logs/lts-configs?offset=0&limit=10 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从 IAM 服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 limit 否 Integer 查询记录数。取值范围：0~50。不传该参数时，默认查询前50条实例的云服务日志配置信息。

响应消息 参数说明 表3 响应Body参数 参数 参数类型 说明 instance_lts_configs Array of 表4 objects 每个实例的LTS日志配置信息和实例简要信息。 total_count Integer 全部可查询的云服务日志配置结果个数，等于所有DDS实例的个数。 表4 instance_lts_configs 参数 参数类型 说明 instance 表5 object 实例的简要信息。 lts_configs Array of 表 lts_configs objects LTS日志配置明细。从未设置LTS日志流，不返回该字段。 表5 instance 参数 参数类型 说明 id String 实例ID。 name String 实例名字。 mode String 实例类型，对应单节点，副本集，集群三种。 枚举值： Single Replica Sharding datastore 表6 object 实例的数据库引擎和版本。 status String 实例状态。 enterprise_project_id String 实例归属的企业项目ID，如果是default企业项目，值为0，如果是其他企业项目，请参考企业项目相关内容。 actions Array of strings 实例所有正在执行的动作。 表6 datastore 参数 参数类型 说明 type String 数据库引擎，值为mongodb。 枚举值： mongodb version String 数据库大版本。 表7 lts_configs 参数 参数类型 说明 log_type String LTS日志类型，不能为空，具有以下日志类型。 audit_log 枚举值： audit_log lts_group_id String 云日志服务LTS 日志组ID。 lts_stream_id String 云日志 服务LTS日志流ID。 enabled Boolean 是否上传。 响应示例 { "total_count" : 1, "instance_lts_configs" : [ { "instance" : { "id" : "520c58ba00a3497e97ce0b9604874dd6in02", "name" : "dds-1f84", "mode" : "Single", "datastore" : { "type" : "mongodb", "version" : 4.0 }, "status" : "normal", "enterprise_project_id" : "0", "actions" : [ "OPS_AUDIT_ LOG " ] }, "lts_configs" : [ { "log_type" : "audit_log", "lts_group_id" : "ec6dc499-1a63-4229-a0c2-a2afa8bcfc95", "lts_stream_id" : "cae69d2e-378b-41dd-b3c9-3ca1cd5335bc", "enabled" : true } ] } ] }

请求消息 参数说明 表2 请求Body参数 名称 参数类型 是否必选 描述 lts_configs Array of 表3 objects 是 需要解除的LTS配置列表，一个实例解除多种日志配置需要填写多个item。 表3 lts_configs 名称 参数类型 是否必选 描述 instance_id String 否 实例ID。 log_type String 否 LTS日志类型，不能为空，具有以下日志类型。 audit_log 枚举值： audit_log 请求示例 为实例审计日志取消LTS服务。 DELETE https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/logs/lts-configs { "lts_configs" : [ { "instance_id" : "520c58ba00a3497e97ce0b9604874dd6in02", "log_type" : "audit_log" } ] }

URI URI格式 DELETE https://{Endpoint}/v3/{project_id}/instances/logs/lts-configs URI样例 https://dds.ap-southeast-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/logs/lts-configs 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。

URI URI格式 POST https://{Endpoint}/v3/{project_id}/instances/logs/lts-configs URI样例 https://dds.ap-southeast-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/logs/lts-configs 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。