华为云用户手册

  • 约束与限制 数字化制造基础服务使用限制如表1所示。除此之外,数字化制造基础服务使用了数据建模引擎服务,同时需要注意数据建模引擎服务的约束与限制。 表1 数字化制造基础服务使用限制说明 指标项 限制说明 组织和用户数量 1个数字化制造基础服务-站点只能绑定1个组织。 单个组织下最大用户数量为10000。 浏览器 推荐使用的浏览器如下: Chrome浏览器:最新的3个稳定版本。 Firefox浏览器:最新的3个稳定版本。 Microsoft Edge浏览器:最新的3个稳定版本。 分辨率 推荐使用1280*1024及以上。 父主题: 数字化制造基础服务简介
  • 应用场景 在传统制造行业的应用构建过程中,由于采用的是“弱产品+强定制”的设计理念,客户可能每隔3~5年就要将原有的应用推倒重来。数字化制造基础服务使用“平台+行业包”的设计理念,平台部分能够在数据模型、业务模板组件等方面为行业包的构建提供有力支撑,行业包也能够通过不同的行业定制,吸收通用、可复用的内容沉淀至平台,由此相互促进,形成可持续迭代的服务构建。 联合生态伙伴构建行业应用的场景:提供制造数据模型、相关业务API、业务模板组件给生态伙伴,生态伙伴基于平台及行业特征就客户需求构建上层行业应用与定制。 面向制造企业提供开箱即用服务的场景:制造企业能够直接将数字化制造基础服务投入到生产现场的全流程使用中。 父主题: 数字化制造基础服务简介
  • 操作场景 该任务指导用户如何配置域名解析,实现华为云“DDoS高防+WAF(Web应用防火墙)”联动。 DDoS高防和云模式WAF联动后,流量会先经过DDoS高防,再转发至WAF,实现联动防御。 图1 联动原理 如果您在DDoS高防防护的多个WAF CNAME使用的是同一个高防IP和端口。后续您在WAF控制台将该域名工作模式切换为“Bypass”模式时,会导致DDoS高防所有绑定相同高防IP和端口的域名不可用。
  • GAUSSDB_MYSQL慢日志结构化模板日志详情 GAUSSDB_MYSQL慢日志示例 表1 结构化模板示例 模板名称 示例日志 GAUSSDB_MYSQL慢日志 {"start_time":"2022-07-27T02:49:19.000","user":"commerce","host":"100.*.*.222","query_time":"1.461583","lock_time":"0.000050","rows_sent":"500","rows_examined":"581000","command_text":"SELECT DN_N.record_id \"a.id\",DN_N.name \"a.name\",DN_N.valueN \"a.ExternalCode\",DN_N.valueN a.DeviceName\",DN_N.valueN \"a.DeviceDef\",DN_N.created_date \"a.createdDate\",DN_N.last_modified_date \"a.lastModifiedDate\",DN_N.valueN \"a.DeviceProduct\",DN_N.valueN \"a.Channel\",DN_N.valueN \"a.Status\",CN_N.valueN \"a.Remark\",DN_N.valueN \"a.NodeId\",DN_N.valueN \"a.ConnectStatus\",CAST(DN_N.valueN AS CHAR(N)) \"a.GatewayId\",CAST(DN_N.valueN AS CHAR(N)) \"a.HMI\",DN_N.valueN \"a.SerialNo\",CAST(DN_N.valueN AS DECIMAL(N,N)) \"a.TelemetryPeriod\",DN_N.valueN \"a.ConnectStatusChgTime\",DN_N.valueN \"a.DeviceNumber\",CAST(DN_N.valueN AS CHAR(N)) \"a.ControllerType\",CAST(DN_N.valueN AS CHAR(N)) \"a.ProjectId\",DN_N.valueN \"a.RegisterStatus\",DN_N.created_date ORD_FN FROM dataN DN_N,clobs CN_N WHERE (DN_N.tenant_id= N AND DN_N.obj_id= N AND DN_N.tenant_id= CN_N.tenant_id AND DN_N.obj_id= CN_N.obj_id AND DN_N.record_id= CN_N.record_id) AND ((DN_N.valueN = N)) ORDER BY DN_N.created_date DESC limit N,N;","database":"saas_perf","log_type":"slow_log","log_time":"1658890159","operate_type":"SELECT"} 结构化字段及字段说明 表2 结构化字段 字段 示例 描述 类型 start_time 2022-07-27T02:49:19.000 sql开始执行时间 string user commerce 用户名 string host 100.*.*.222 连接IP string query_time 1.461583 sql执行时间 string lock_time 0.000050 等待锁时间 string rows_sent 500 查询返回行数 string rows_examined 581000 查询扫描行数 string command_text SELECT DN_N.record_id \"a.id\",DN_N.name \"a.name\",DN_N.valueN \"a.ExternalCode\",DN_N.valueN \"a.DeviceName\",DN_N.valueN \"a.DeviceDef\",DN_N.created_date \"a.createdDate\",DN_N.last_modified_date \"a.lastModifiedDate\",DN_N.valueN \"a.DeviceProduct\",DN_N.valueN \"a.Channel\",DN_N.valueN \"a.Status\",CN_N.valueN \"a.Remark\",DN_N.valueN \"a.NodeId\",DN_N.valueN \"a.ConnectStatus\",CAST(DN_N.valueN AS CHAR(N)) \"a.GatewayId\",CAST(DN_N.valueN AS CHAR(N)) \"a.HMI\",DN_N.valueN \"a.SerialNo\",CAST(DN_N.valueN AS DECIMAL(N,N)) \"a.TelemetryPeriod\",DN_N.valueN \"a.ConnectStatusChgTime\",DN_N.valueN \"a.DeviceNumber\",CAST(DN_N.valueN AS CHAR(N)) \"a.ControllerType\",CAST(DN_N.valueN AS CHAR(N)) \"a.ProjectId\",DN_N.valueN \"a.RegisterStatus\",DN_N.created_date ORD_FN FROM dataN DN_N,clobs CN_N WHERE (DN_N.tenant_id= N AND DN_N.obj_id= N AND DN_N.tenant_id= CN_N.tenant_id AND DN_N.obj_id= CN_N.obj_id AND DN_N.record_id= CN_N.record_id) AND ((DN_N.valueN = N)) ORDER BY DN_N.created_date DESC limit N,N; 执行的SQL语句 string database saas_perf 使用的数据库 string log_type slow_log 日志类型 string log_time 1658890159 日志执行时间戳 string operate_type SELECT sql操作类型,例如select,update,insert等 string
  • GAUSSDB_MYSQL错误日志结构化模板日志详情 GAUSSDB_MYSQL错误日志示例 表3 结构化模板示例 模板名称 示例日志 GAUSSDB_MYSQL错误日志 {"log_type":"error_log","severity":"WARNING","log_time":"2022-08-22T06:52:08Z","raw_message":"Occur error when reading bytes from a network handler. Client actively closes the connection."} 结构化字段及字段说明 表4 结构化字段 字段 示例 描述 类型 log_type error_log 日志类型 string severity WARNING 日志级别 string log_time 2022-08-22T06:52:08Z 错误日志产生时间 string raw_message Occur error when reading bytes from a network handler. Client actively closes the connection. 日志内容 string
  • GeminiDB Cassandra慢日志结构化模板日志详情 GeminiDB Cassandra慢日志示例 表1 结构化模板示例 模板名称 示例日志 GeminiDB Cassandra慢日志 {"instance_id":"32eaaf6c5a0142e3a6d80740cd5b3803in12","node_id":"597a15b9f2ef4436811c5edcc67c013cno12","keyspace":"test","table":"test","log_type":"slow_log","operate_type":"select","log_time":"2022-10-12T07:42:21.253484Z","cost_time":1277.47,"whole_message":"0g1Oxct"} 结构化字段及字段说明 表2 结构化字段 字段 示例 描述 类型 instance_id 32eaaf6c5a0142e3a6d80740cd5b3803in12 实例Id string node_id 597a15b9f2ef4436811c5edcc67c013cno12 节点Id string keyspace test 键空间 string table test 数据库表名 string log_type slow_log 日志类型 string operate_type select 操作类型 string log_time 2022-10-12T07:42:21.253484Z 慢日志产生的时间 string cost_time 1277.47 操作花费的时间 float whole_message 0g1Oxct 原始日志信息 string
  • 结构化模板日志详情 GeminiDB Redis慢日志示例日志 表1 结构化模板示例 模板名称 示例日志 GeminiDB Redis慢日志 { "instance_id": "32eaaf6c5a0142e3a6d80740cd5b3803in12", "node_id": "597a15b9f2ef4436811c5edcc67c013cno12", "database": "0", "log_type": "slow_log", "operate_type": "sismember", "log_time": "2022-10-12T07:42:21.253484Z", "cost_time": 1277.47, "whole_message": "0g1Oxct"} 结构化字段及字段说明 表2 结构化字段 字段 示例 描述 类型 instance_id 32eaaf6c5a0142e3a6d80740cd5b3803in12 实例Id string node_id 597a15b9f2ef4436811c5edcc67c013cno12 节点Id string database 0 库名称 string log_type slow_log 日志类型 string operate_type sismember 操作类型 string log_time 2022-10-12T07:42:21.253484Z 慢日志产生时间 string cost_time 1277.47 操作花费的时间 float whole_message 0g1Oxct 原始日志信息 string
  • 分隔符 分隔符是使用分隔符(例如:逗号、空格或字符)提取字段。 选择示例日志:应选择一条比较典型的日志作为示例日志。在“步骤1 选择示例日志”中,可单击“从已有日志中选择”,在弹出框中根据业务需求选择待操作的日志,也可以直接在输入框中输入待操作的日志,单击“确定”。通过选择不同时间段筛选日志。 时间范围有三种方式,分别是相对时间、整点时间和自定义。您可以根据自己的实际需求,选择时间范围。 相对时间:表示查询距离当前时间1分钟、5分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置相对时间1小时,表示查询18:20:31~19:20:31的日志数据。 整点时间:表示查询最近整点1分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置整点时间1小时,表示查询18:00:00~19:00:00的日志数据。 自定义:表示查询指定时间范围的日志数据 在“步骤2 指定分隔符”需要根据原始日志内容选择分隔符,或自定义其他需要的特殊字符作为分隔符。 不可见字符需要输入0x开头的16进制字符,长度为0-4个字符,总共32个不可见字符。 自定义字符支持输入1-10个字符,每个字符都作为独立的分隔符。 自定义字符串支持输入1-30个字符,字符串整体作为一个分隔符。 字段提取。可将输入或选择的日志自动提取为以一个示例字段对应一个字段名称的格式的日志解析结果。 在“步骤3字段提取”下单击“智能提取”。以如下原始日志为例进行分析: 将以下原始日志输入待操作框中。 1 5f67944957444bd6bb4fe3b367de8f3d 1d515d18-1b36-47dc-a983-bd6512aed4bd 192.168.0.154 192.168.3.25 38929 53 17 1 96 1548752136 1548752736 ACCEPT OK 图3 智能提取结果 当日志提取字段的类型为float时,精确度为7位有效数字。 如果超过7位有效数字的话,则会导致提取字段内容不准确,从而影响可视化查看和快速分析,因此建议将字段类型修改为String。 在字段提取完成后,可对日志模板进行设置。结构化字段设置规则请参考设置结构化字段。 单击“保存”,完成日志结构化配置,初次设置完成后将不能对字段类型编辑修改。
  • JSON JSON是通过提取JSON字段将其拆分为键值对。 选择示例日志:应选择一条比较典型的日志作为示例日志。在“步骤1 选择示例日志”中,可单击“从已有日志中选择”,在弹出框中根据业务需求选择待操作的日志,也可以直接在输入框中输入待操作的日志,单击“确定”。通过选择不同时间段筛选日志。 时间范围有三种方式,分别是相对时间、整点时间和自定义。您可以根据自己的实际需求,选择时间范围。 相对时间:表示查询距离当前时间1分钟、5分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置相对时间1小时,表示查询18:20:31~19:20:31的日志数据。 整点时间:表示查询最近整点1分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置整点时间1小时,表示查询18:00:00~19:00:00的日志数据。 自定义:表示查询指定时间范围的日志数据 字段提取。可将输入或选择的日志自动提取为以一个示例字段对应一个字段名称的格式的日志解析结果。 在“步骤2 字段提取”下单击“智能提取”。以如下原始日志为例进行分析: 将以下原始日志输入待操作框中。 {"a1": "a1", "b1": "b1", "c1": "c1", "d1": "d1"} 图2 提取结果 当日志提取字段的类型为float时,精度为16位有效数字。如果超过16位有效数字,则会导致提取字段内容不准确,从而影响可视化查看和快速分析,因此建议将字段类型修改为String。 当日志提取字段的类型为long时,日志内容超过16位有效数字,只会精确显示前16位有效数字,后面的数字会变为0。 当日志提取字段的类型为long时,日志内容超过21位有效数字,则会识别为float类型,建议将字段类型修改为String。 在字段提取完成后,可对日志模板进行设置。结构化字段设置规则请参考设置结构化字段。 单击“保存”,完成日志结构化配置,初次设置完成后将不能对字段类型编辑修改。
  • Nginx Nginx是通过log_format指令来自定义访问日志的格式。 选择示例日志:应选择一条比较典型的日志作为示例日志。在“步骤1 选择示例日志”中,可单击“从已有日志中选择”,在弹出框中根据业务需求选择待操作的日志,也可以直接在输入框中输入待操作的日志,单击“确定”。通过选择不同时间段筛选日志。 时间范围有三种方式,分别是相对时间、整点时间和自定义。您可以根据自己的实际需求,选择时间范围。 相对时间:表示查询距离当前时间1分钟、5分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置相对时间1小时,表示查询18:20:31~19:20:31的日志数据。 整点时间:表示查询最近整点1分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置整点时间1小时,表示查询18:00:00~19:00:00的日志数据。 自定义:表示查询指定时间范围的日志数据 在“步骤2 输入Nginx日志配置”中需要输入Nginx日志配置,根据输入或选择的日志进行配置。其中有默认配置可使用,单击“默认Nginx配置”即可。 标准Nginx配置文件中,日志配置的部分通常以log_format开头。 日志格式 默认配置如下所示。 log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"'; 用户也可进行自定义配置,具体配置格式要求如下所示。 使用Nginx配置,不可为空 以log_format开头,并且包含(')和字段名称 长度最大限制为5000 需要与示例日志内容匹配 log_format字段之间的间隔,除大小字母、数字、下划线及中划线外,可使用其他任意字符 以(')或者(';)结尾 字段提取。可将输入或选择的日志自动提取为以一个示例字段对应一个字段名称的格式的日志解析结果。 在“步骤3 字段提取”下单击“智能提取”。以如下原始日志为例进行分析: 将以下原始日志输入待操作框中。 39.149.31.187 - - [12/Mar/2020:12:24:02 +0800] "GET / HTTP/1.1" 304 0 "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.132 Safari/537.36" "-" 并使用如下Nginx日志配置。 log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"'; 图4 智能提取结果 当日志提取字段的类型为float时,精确度为7位有效数字。 如果超过7位有效数字的话,则会导致提取字段内容不准确,从而影响可视化查看和快速分析,因此建议将字段类型修改为String。 在字段提取完成后,可对日志模板进行设置。结构化字段设置规则请参考设置结构化字段。 单击“保存”,完成日志结构化配置,初次设置完成后将不能对字段类型编辑修改。
  • GeminiDB Mongo错误日志结构化模板日志详情 GeminiDB Mongo错误日志示例 表1 结构化模板示例 模板名称 示例日志 GeminiDB Mongo错误日志 {"log_type":"error_log","severity":"Error","log_time":"2022-08-22T09:33:15.142+0000","raw_message":"E QUERY [ClusterDisasterBackupChangeJob] Get global setting disasterBackup failed.","instance_id": "5b67dc63ba824145aae1f12ff51e58b8in02","node_id": "686a791e690e4db3af591ec4b6f72916no02"} 结构化字段及字段说明 表2 结构化字段 字段 示例 描述 类型 log_type error_log 日志类型 string severity Error 日志级别 string log_time 2022-08-22T09:33:15.142+0000 日志产生时间 string raw_message E QUERY [ClusterDisasterBackupChangeJob] Get global setting disasterBackup failed. 日志内容 string instance_id 5b67dc63ba824145aae1f12ff51e58b8in02 实例Id string node_id 686a791e690e4db3af591ec4b6f72916no02 节点Id string
  • GeminiDB Mongo慢日志结构化模板日志详情 GeminiDB Mongo慢日志示例 表3 结构化模板示例 模板名称 示例日志 GeminiDB Mongo慢日志 {"log_type":"slow_log","log_time":"2022-08-20T10:04:03.204000Z","namespace":"data0820.table","database":"data0820","collection":"table","operate_type":"insert","docs_scanned":0,"docs_returned":0,"n_deleted":0,"n_matched":0,"n_modified":0,"n_inserted":10,"cost_time":555,"lock_time":0,"whole_message":{"op":"insert","ns":"data0820.usrtable","command":"{N}","ninserted":1,"keysInserted":1,"numYield":0,"locks":{"Global":{"acquireCount":{"r":5,"w":5}},"Database":{"acquireCount":{"w":4,"W":1}},"Collection":{"acquireCount":{"w":2}},"oplog":{"acquireCount":{"w":2}}},"responseLength":230,"protocol":"op_msg","millis":555,"ts":{"$date":1660989843204},"client":"192.168.0.64","appName":"MongoDBShell","allUsers":[{"user":"rwuser","db":"admin"}],"user":"rwuser@admin"},"instance_id":"5b67dc63ba824145aae1f12ff51e58b8in02","node_id":"686a791e690e4db3af591ec4b6f72916no02"} 结构化字段及字段说明 表4 结构化字段 字段 示例 描述 类型 log_type slow_log 日志类型 string log_time 2022-08-20T10:04:03.204000Z 慢日志产生的时间 string namespace data0820.table 命名空间 string database data0820 库名称 string collection table 表名称 string operate_type insert 操作类型 string docs_scanned 0 数据库扫描行数 long docs_returned 0 查询返回结果行数 long n_deleted 0 删除行数 long n_matched 0 更新匹配行数 long n_modified 0 实际更新行数 long n_inserted 10 插入行数 long cost_time 555 操作花费的时间 long lock_time 0 wait_lock的时间 long whole_message {"op":"insert","ns":"data0820.usrtable","command":"{N}","ninserted":1,"keysInserted":1,"numYield":0,"locks":{"Global":{"acquireCount":{"r":5,"w":5}},"Database":{"acquireCount":{"w":4,"W":1}},"Collection":{"acquireCount":{"w":2}},"oplog":{"acquireCount":{"w":2}}},"responseLength":230,"protocol":"op_msg","millis":555,"ts":{"$date":1660989843204},"client":"192.168.0.64","appName":"MongoDBShell","allUsers":[{"user":"rwuser","db":"admin"}],"user":"rwuser@admin"} 原始日志信息 string instance_id 5b67dc63ba824145aae1f12ff51e58b8in02 实例ID string node_id 686a791e690e4db3af591ec4b6f72916no02 节点ID string
  • 设置tag字段 设置结构化配置时,可以对日志维度信息进行tag字段设置,设置完成后可以在可视化界面对设置字段进行SQL查询。 在字段提取步骤中选择“tag字段”页签。 单击“添加字段”。 在tag字段列表中“字段名称”,输入需要设置 tag字段名称,例如hostIP。 tag字段功能上线前设置的结构化配置,在修改结构化配置进行tag字段设置时,系统tag不会带出示例字段。 如需添加多个字段可单击“添加字段”,继续添加。 设置完成后单击“保存”。 tag支持的系统字段包括:category、clusterId、clusterName、containerName、hostIP、hostId、hostName、nameSpace、pathFile、podName。 tag不支持的系统字段包括:groupName、logStream、lineNum、content、logContent、logContentSize、collectTime。 日志提取字段和tag字段可以同时设置。
  • 设置结构化字段 在进行结构化配置字段提取之后,可对结构化字段进行设置,具体设置规则如下表。 表1 结构化字段设置规则 日志提取方式 字段名称 字段类型是否可修改 字段是否可删除 正则分析(自动生成) 用户自定义。 名称必须以字母开始,且仅包含字母和数字。 是 是 正则分析(手动输入) 支持在输入正则表达式时进行命名。 支持使用系统默认命名field1、field2、field3……,或对其修改后的名称。 是 是 JSON格式 智能提取字段名称,可定义别名。 是 是 分隔符 默认名称field1、field2、field3……,可进行修改。 是 是 Nginx 根据Nginx配置生成,可定义别名。 是 是 ELB模板 根据ELB资料中提供的日志字段被定义。 否 否 VPC模板 根据VPC资料中提供的日志字段被定义。 否 否 CTS模板 字段名称为json日志中的key。 否 否 APIG模板 根据APIG资料中提供的日志字段被定义。 否 否 DCS审计日志 根据DCS资料中提供的日志字段被定义。 否 否 TOMCAT 根据TOMCAT官网提供的字段名称进行nginx解析的名称 否 否 NGINX 根据NGINX资料中提供的日志字段被定义。 否 否 GAUSSV5审计日志 根据GAUSSV5资料中提供的日志字段被定义。 否 否 DDS审计日志 根据DDS资料中提供的日志字段被定义。 否 否 DDS错误日志 根据DDS资料中提供的日志字段被定义。 否 否 DDS慢日志 根据DDS资料中提供的日志字段被定义。 否 否 CFW访问控制日志 根据CFW资料中提供的日志字段被定义。 否 否 CFW攻击日志 根据CFW资料中提供的日志字段被定义。 否 否 CFW流量日志 根据CFW资料中提供的日志字段被定义。 否 否 MYSQL错误日志 根据MYSQL资料中提供的日志字段被定义。 否 否 MYSQL慢日志 根据MYSQL资料中提供的日志字段被定义。 否 否 POSTGRESQL错误日志 根据POSTGRESQL资料中提供的日志字段被定义。 否 否 SQLSERVER错误日志 根据SQLSERVER资料中提供的日志字段被定义。 否 否 GeminiDB Redis慢日志 根据GeminiDB Redis资料中提供的日志字段被定义。 否 否 CDN 根据CDN资料中提供的日志字段被定义。 否 否 SMN 根据SMN资料中提供的日志字段被定义。 否 否 GAUSSDB_MYSQL错误日志 根据GAUSSDB_MYSQL资料中提供的日志字段被定义。 否 否 GAUSSDB_MYSQL慢日志 根据GAUSSDB_MYSQL资料中提供的日志字段被定义。 否 否 ER企业路由器 根据ER企业路由器资料中提供的日志字段被定义。 否 否 MYSQL审计日志 根据MYSQL审计日志资料中提供的日志字段被定义。 否 否 GeminiDB Cassandra慢日志 根据GeminiDB Cassandra慢日志资料中提供的日志字段被定义。 否 否 GeminiDB Mongo慢日志 根据GeminiDB Mongo慢日志资料中提供的日志字段被定义。 否 否 GeminiDB Mongo错误日志 根据GeminiDB Mongo错误日志资料中提供的日志字段被定义。 否 否 WAF访问日志 根据WAF访问日志资料中提供的日志字段被定义。 否 否 WAF攻击日志 根据WAF攻击日志资料中提供的日志字段被定义。 否 否 DMS重平衡日志 根据DMS重平衡日志资料中提供的日志字段被定义。 否 否 CCE审计日志 根据CCE审计日志资料中提供的日志字段被定义。 否 否 CCE事件日志 根据CCE事件日志资料中提供的日志字段被定义。 否 否 GeminiDB Redis审计日志 根据GeminiDB Redis审计日志资料中提供的日志字段被定义。 否 否 自定义模板 用户自定义。 是 是 正则分析(手动输入)、JSON格式、分隔符、Nginx和自定义模板的字段名称需要满足如下要求: 只支持输入英文、数字、中划线、下划线及小数点。 不能以小数点、下划线开头或以小数点结尾。 长度为1-64个字符。
  • 响应示例 状态码: 200 处理成功返回。 { "job_id" : "efc5300ecdba4ea48d1ff13a9d907bc0", "name" : "测试名字", "state" : "MANUAL_VERIFYING", "project_id" : "***", "cover_download_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_cover?param1=XXX¶m2=YYY", "create_time" : "2023-12-09T07:31:37Z", "contact" : "1**********", "model_version" : "V3", "matting_type" : "AI", "model_resolution" : "1080P", "training_video_download_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_trainingVideo?param1=XXX¶m2=YYY", "id_card_image1_download_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage1?param1=XXX¶m2=YYY", "id_card_image2_download_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_idCardImage2?param1=XXX¶m2=YYY", "grant_file_download_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_grantFile?param1=XXX¶m2=YYY", "operation_logs" : [ { "operate_time" : "2023-12-09T07:31:37Z", "log_type" : "USER_CREATE_JOD", "operate_user" : "USER" }, { "operate_time" : "2023-12-09T07:31:43Z", "log_type" : "SYSTEM_MARKABLE_VIDEO", "operate_user" : "SYSTEM" }, { "operate_time" : "2023-12-09T07:31:43Z", "log_type" : "USER_VERIFYING_SUBMITTED", "operate_user" : "USER" }, { "operate_time" : "2023-12-09T07:31:43Z", "log_type" : "SYSTEM_VERIFY_SUCCESS", "operate_user" : "SYSTEM" }, { "operate_time" : "2023-12-09T07:32:45Z", "log_type" : "SYSTEM_MARKABLE_VIDEO_SUCCESS", "operate_user" : "SYSTEM" } ], "comment_logs" : [ ], "is_mask_file_uploaded" : false, "verify_video_download_url" : "null", "markable_video_download_url" : "https://xxx.com/efc5300ecdba4ea48d1ff13a9d907bc0_markableData?param1=XXX¶m2=YYY", "is_background_replacement" : true } 状态码: 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码: 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }
  • 响应参数 状态码: 200 表3 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表4 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 name String 分身数字人模型名称。该名称会作为资产库中分身数字人模型资产名称。 state String 任务的状态。 WAIT_FILE_UPLOAD: 待上传文件 AUTO_VERIFYING: 自动审核中 AUTO_VERIFY_FAILED: 自动审核失败 MANUAL_VERIFYING: 人工审核中 MANUAL_VERIFY_FAILED: 人工审核失败 MANUAL_VERIFY_SUCCESS: 审核通过,等待预处理资源 TRAINING_DATA_PREPROCESSING:训练数据预处理中 TRAINING_DATA_PREPROCESS_FAILED: 训练数据预处理失败 TRAINING_DATA_PREPROCESS_SUCCESS: 训练数据预处理完成,等待训练资源中 TRAINING: 训练中 TRAIN_FAILED: 训练失败 TRAIN_SUCCESS: 训练完成,等待预处理资源 INFERENCE_DATA_PREPROCESSING: 推理数据预处理中 INFERENCE_DATA_PREPROCESS_FAILED: 推理数据预处理失败 WAIT_MAIN_FILE_UPLOAD:等待主文件上传 JOB_SUCCESS: 完成 WAIT_USER_CONFIRM:等待用户确认训练效果 JOB_REJECT:驳回 JOB_PENDING:挂起 JOB_FINISH:结束,最终状态,不可再做改变 asset_id String 模型资产ID。 project_id String 模型资产所属项目ID。 cover_download_url String 分身数字人模型封面下载URL。URL有效期24小时。 last_update_time String 用户最近一次更新任务的时间(包括租户创建或者重新提交),格式遵循:RFC 3339。 例 “2020-07-30T10:43:17Z” create_time String 创建时间,格式遵循:RFC 3339。 例 “2020-07-30T10:43:17Z” contact String 分身数字人训练任务创建者联系方式,如手机或邮箱等。 batch_name String 分身数字人训练任务的批次名称。 tags Array of strings 分身数字人训练任务标签。 model_version String 分身数字人模型版本。默认是V3版本模型。 V2: V2版本模型 V3:V3版本模型 matting_type String 抠图类型。默认是AI。 AI:AI抠图 MANUAL:人工抠图 training_video_download_url String 分身数字人训练视频下载URL。24小时内有效。 id_card_image1_download_url String 身份证正面照片下载URL。24小时内有效。 id_card_image2_download_url String 身份证反面照片下载URL。24小时内有效。 grant_file_download_url String 授权书下载URL。24小时内有效。 operation_logs Array of OperationLogInfo objects 操作日志列表。 comment_logs Array of CommentLogInfo objects 评论记录列表。 is_mask_file_uploaded Boolean 遮罩文件是否已上传。 mask_file_download_url String 遮罩下载URL。24小时内有效。 verify_video_download_url String 制作审核视频 markable_video_download_url String 标注视频url下载链接。24小时内有效。 inference_data_process_video_mark_info InferenceVideoMarkInfo object 分身数字人推理预处理视频标记信息。 inference_data_process_action_mark_info InferenceActionMarkInfo object 分身数字人推理预处理动作标记信息。 is_background_replacement Boolean 分身数字人是否需要背景替换。需要背景替换的分身数字人训练视频需要绿幕拍摄。 model_resolution String 分身数字人模型分辨率。默认是1080P。 1080P:1080P。支持1080P及720P的视频输出。 4K:4K。支持4K、1080P及720P的视频输出。 表5 OperationLogInfo 参数 参数类型 描述 operate_time String 操作时间,格式遵循:RFC 3339。 例 “2020-07-30T10:43:17Z” log_type String 命令执行结果。 USER_CREATE_JOD:用户开始分身数字人定制 USER_VERIFYING_SUBMITTED:用户提交审核 SYSTEM_VERIFY_FAILED:自动审核失败 SYSTEM_VERIFY_SUCCESS:自动审核成功 ADMIN_VERIFY_SUCCESS:人工审核通过 ADMIN_VERIFY_FAILED:人工审核不通过 SYSTEM_TRAIN_DATA_PREPROCESSING:训练数据预处理中 SYSTEM_TRAIN_DATA_PREPROCESS_FAILED:训练数据预处理失 SYSTEM_TRAIN_DATA_PREPROCESS_SUCCESS:训练数据预处理成功 SYSTEM_TRAINING:开始训练 ADMIN_STOP_TRAIN:人工终止训练 SYSTEM_TRAIN_FAILED:训练失败 SYSTEM_TRAIN_SUCCESS:训练成功 SYSTEM_INFERENCE_DATA_PREPROCESSING:推理数据预处理中 SYSTEM_INFERENCE_DATA_PREPROCESS_FAILED:推理数据预处理失败 SYSTEM_INFERENCE_DATA_PREPROCESS_SUCCESS:推理数据预处理成功 SYSTEM_JOB_SUCCESS:任务处理完成 SYSTEM_MARKABLE_VIDEO: 标定视频生成任务 SYSTEM_MASK_VERIFY_VIDEO: 校验视频生成任务 SYSTEM_MASK_VERIFY_VIDEO_SUCCESS:校验视频生成成功 SYSTEM_MASK_VERIFY_VIDEO_FAILED:校验视频生成失败 SYSTEM_MARKABLE_VIDEO_SUCCESS:标定视频生成成功 SYSTEM_MARKABLE_VIDEO_FAILED:标定视频生成失败 SYSTEM_MASK_VIDEO_AND_ACTION_TIME_SUCCESS:自动标定成功 SYSTEM_MASK_VIDEO_AND_ACTION_TIME_FAILED:自动标定失败 ADMIN_MASK_UPLOADED:遮罩文件上传完成 ADMIN_UPDATE_VIDEO:管理员更换视频 USER_UPDATE_VIDEO:用户更换视频 ADMIN_MASK_ACTION_TIME:管理员标定 log_description String 日志描述。用于记录人工审核不通过时的审核意见和DHTS、DHPS上报的错误信息。 operate_user String 操作人员。 USER:用户 ADMIN:管理员 SYSTEM:系统 表6 CommentLogInfo 参数 参数类型 描述 operate_time String 操作时间,格式遵循:RFC 3339。 例 “2020-07-30T10:43:17Z” comment_type String USER_REJECT:用户驳回 USER_COMMENT:用户评论 ADMIN_COMMENT:管理员评论 comment_title String 标题。 comment_message String 消息。 attachment_download_url Array of strings 附件下载地址 表7 InferenceVideoMarkInfo 参数 参数类型 描述 video_start_time String 选取推理数据预处理视频起始时间。格式:“HH:MM:SS.mmm”。 video_end_time String 选取推理数据预处理视频结束时间。格式:“HH:MM:SS.mmm”。 表8 InferenceActionMarkInfo 参数 参数类型 描述 action_info Array of ActionMarkItem objects 动作列表。 表9 ActionMarkItem 参数 参数类型 描述 action_start_time String 选取推理数据预处理视频起始时间。格式:“HH:MM:SS.mmm”。 action_end_time String 选取推理数据预处理视频结束时间。格式:“HH:MM:SS.mmm”。 action_type String 动作类型。 SILENCE: 静默 ACTION:动作 状态码: 400 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码: 500 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取。 响应消息头中X-Subject-Token的值。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 格式为(YYYYMMDD'T'HHMMSS'Z')。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息。 X-App-UserId 否 String 第三方用户ID。 说明: *不允许输入中文。
  • 请求示例 POST https://metastudio.cn-east-3.myhuaweicloud.com/v1/6a6a1f8354f64dd9b9a614def7b59d83/digital-assets/summarys { "asset_ids" : [ "8cb2f48a2cb006154794741933421100", "e2ba8314ebaab34d368711d118fcecba" ] }
  • 响应示例 状态码: 200 成功。 { "asset_list" : [ { "asset_id" : "93769b5a-c8c6-4692-9c95-53933a1f0c93", "asset_name" : "男教师", "asset_type" : "HUMAN_MODEL", "cover_url" : "https://vr-dac-gamma.obs.cn-north-6.myhuaweicloud.com:443/05a8ae5925000fb72f83c0091083231a/ca40212e1cdb64ab5f74446bcddb8eb9/model/image/6dd0c018-7b8e-46aa-8a45-3075c161c500.png?AccessKeyId=F8DE4LGO7EOYY0CM9ERJ&Expires=1657527524&Signature=BWgSQpc4lMFFrtj2ae67fw679%2Bc%3D" } ] } 状态码: 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid Parameter" }
  • 响应参数 状态码: 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表5 响应Body参数 参数 参数类型 描述 asset_list Array of DigitalAssetSummary objects 资产列表。 表6 DigitalAssetSummary 参数 参数类型 描述 asset_id String 资产ID。 asset_name String 资产名称。 asset_type String 资产类型。 公共资产类型: VOICE_MODEL:音色模型(仅系统管理员可上传,普通租户仅可查询) VIDEO:视频文件 IMAGE:图片文件 PPT:幻灯片文件 MUSIC: 音乐 AUDIO: 音频 COMMON_FILE:通用文件 分身数字人资产: HUMAN_MODEL_2D: 分身数字人模型 BUSINESS_CARD_TEMPLET: 数字人名片模板 3D数字人资产: HUMAN_MODEL:3D数字人模型 SCENE:场景模型 ANIMATION:动作动画 MATERIAL:风格化素材 NORMAL_MODEL: 普通模型 cover_url String 封面图片路径。 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取。 响应消息头中X-Subject-Token的值。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 格式为(YYYYMMDD'T'HHMMSS'Z')。 表3 请求Body参数 参数 是否必选 参数类型 描述 asset_ids 是 Array of strings 需要查询的资产ID。
  • URI GET /v1/{project_id}/digital-assets 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页显示的条目数量。 offset 否 Integer 偏移量,表示从此偏移量开始查询。 name 否 String 按名称模糊查询。 tag 否 String 按标签模糊查询。 start_time 否 String 起始时间。格式遵循:RFC 3339 如"2021-01-10T08:43:17Z"。 end_time 否 String 结束时间。格式遵循:RFC 3339 如"2021-01-10T10:43:17Z"。 asset_type 否 String 资产类型。多个类型使用英文逗号分割。 HUMAN_MODEL:数字人模型 VOICE_MODEL:音色模型(仅系统管理员可上传) SCENE:场景模型 ANIMATION:动作动画 VIDEO:视频文件 IMAGE:图片文件 PPT:幻灯片文件 MATERIAL:风格化素材 HUMAN_MODEL_2D: 2D数字人网络模型 BUSINESS_CARD_TEMPLET: 数字人名片模板 MUSIC: 音乐 AUDIO: 音频 sort_key 否 String 排序字段,目前只支持create_time。 sort_dir 否 String 排序方式。 asc:升序 desc:降序 默认asc升序。 asset_source 否 String 资产来源。 SYSTEM:系统资产 CUSTOMIZATION:租户资产 ALL:所有资产 默认查询租户资产。 asset_state 否 String 资产状态。多个资产状态使用英文逗号分割。 CREATING:资产创建中,主文件尚未上传 FAILED:主文件上传失败 UNACTIVED:主文件上传成功,资产未激活,资产不可用于其他业务(用户可更新状态) ACTIVED:主文件上传成功,资产激活,资产可用于其他业务(用户可更新状态) DELETING:资产删除中,资产不可用,资产可恢复 DELETED:资产文件已删除,资产不可用,资产不可恢复 BLOCK:资产被冻结,资产不可用,不可查看文件。 默认查询所有状态的资产。 style_id 否 String 基于风格化ID查询关联资产。 system_male_001:男性风格01 system_female_001:女性风格01 system_male_002:男性风格02 system_female_002:女性风格02 render_engine 否 String 可用引擎。 UE:UE引擎 MetaEngine:MetaEngine引擎 说明: 该字段当前只对MetaEngine白名单用户生效 sex 否 String 性别。多选使用英文逗号分隔。 language 否 String 语言。多选使用英文逗号分隔。 system_property 否 String 系统属性。 key和value间用":"分隔,多个key之间用","分隔。 如system_property=BACKGROUND_IMG:Yes,RENDER_ENGINE:MetaEngine。 不同Key对应Value取值如下: 公共资产属性: BACKGROUND_IMG:视频制作的2D背景图片,可取值Yes CREATED_BY_PLATFORM:是否平台生成,可取值Yes 分身数字人资产属性: MATERIAL_IMG:素材图片,用作前景。可取值Yes MATERIAL_VIDEO:素材视频,用作前景。可取值Yes TO_BE_TRANSLATED_VIDEO: 视频翻译的源视频。可取值Yes 3D数字人资产属性: STYLE_ID:风格Id RENDER_ENGINE:引擎类型,可取值UE或MetaEngine BACKGROUND_SCENE:视频制作的2D背景场景,可取值Horizontal(横屏)或者Vertical(竖屏) action_editable 否 Boolean 动作是否可编辑。仅在分身数字人模型查询时有效。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取。 响应消息头中X-Subject-Token的值。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 格式为(YYYYMMDD'T'HHMMSS'Z')。 X-App-UserId 否 String 第三方用户ID。 说明: *不允许输入中文。
  • 响应示例 状态码: 200 成功。 { "count" : 2, "assets" : [ { "asset_id" : "24bad716-87b1-45e5-8912-6102f7693265", "asset_name" : "云笙模型", "asset_description" : "云笙模型", "create_time" : "2021-10-30T12:30:35Z", "asset_type" : "HUMAN_MODEL", "asset_state" : "CREATING", "files" : [ null ] }, { "asset_id" : "93769b5a-c8c6-4692-9c95-53933a1f0c93", "asset_name" : "男教师", "asset_description" : "男教师模型", "create_time" : "2021-10-30T12:30:35Z", "asset_type" : "HUMAN_MODEL", "asset_state" : "ACTIVED", "files" : [ { "file_id" : "24bad716-87b1-45e5-8912-6102f7693265", "file_name" : "male001.bin", "file_md5" : "Hu8/Fjd5+Ra1oo2MZsZjbg==", "file_size" : 31032142, "file_type" : "bin", "asset_file_category" : "MAIN", "download_url" : "https://vr-dac-gamma.obs.cn-north-6.myhuaweicloud.com:443/05a8ae5925000fb72f83c0091083231a/ca40212e1cdb64ab5f74446bcddb8eb9/model/image/24bad716-87b1-45e5-8912-6102f7693265.bin?AccessKeyId=F8DE4LGO7EOYY0CM9ERJ&Expires=1657527524&Signature=BWgSQpc4lMFFrtj2ae67fw679%2Bc%3D" }, { "file_id" : "6dd0c018-7b8e-46aa-8a45-3075c161c500", "file_name" : "male001.png", "file_md5" : "38b8c2c1093dd0fec383a9d9ac940515", "file_size" : 110321, "file_type" : "png", "asset_file_category" : "COVER", "download_url" : "https://vr-dac-gamma.obs.cn-north-6.myhuaweicloud.com:443/05a8ae5925000fb72f83c0091083231a/ca40212e1cdb64ab5f74446bcddb8eb9/model/image/6dd0c018-7b8e-46aa-8a45-3075c161c500.png?AccessKeyId=F8DE4LGO7EOYY0CM9ERJ&Expires=1657527524&Signature=BWgSQpc4lMFFrtj2ae67fw679%2Bc%3D" } ] } ] } 状态码: 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid Parameter" }
  • 响应示例 状态码: 202 处理成功返回。 { "job_id" : "26f06524-4f75-4b3a-a853-b649a21aaf66" } 状态码: 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码: 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }
  • 响应参数 状态码: 202 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求ID。 表5 响应Body参数 参数 参数类型 描述 job_id String 任务ID。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码: 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • 请求示例 POST https://metastudio.cn-north-4.myhuaweicloud.com/v1/ttsa-jobs { "speed" : 100, "voice_asset_id" : "d05b8edc4b8d189973c1735207ee1505", "volume" : 100, "auto_motion" : false, "script_type" : "TEXT", "text" : "测试用朗读文本。", "pitch" : 100, "style_id" : "262228a233820e80d99c4a223615e9a5" }
  • 响应示例 状态码: 200 处理成功返回。 { "job_id" : "26f06524-4f75-4b3a-a853-b649a21aaf66" } 状态码: 400 { "error_code" : "MSS.00000003", "error_msg" : "Invalid parameter" } 状态码: 401 { "error_code" : "MSS.00000001", "error_msg" : "Unauthorized" } 状态码: 500 { "error_code" : "MSS.00000004", "error_msg" : "Internal Error" }
  • 请求示例 POST https://metastudio.cn-north-4.myhuaweicloud.com/v1/0d697589d98091f12f92c0073501cd79/photo-detection { "human_image" : "/9j/4AAQSkZJRgABAQEAYABgAAD/4QAiRXhpZgAATU0AKgAAAAgAAQESAAMAAAABAAEAAAAAAAD" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取。 响应消息头中X-Subject-Token的值。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 格式为(YYYYMMDD'T'HHMMSS'Z')。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息。 X-App-UserId 否 String 第三方用户ID。 说明: *不允许输入中文。 表3 请求Body参数 参数 是否必选 参数类型 描述 human_image 是 String 人物照片,需要Base64编码。照片分辨率不超过1080P。
共100000条