华为云用户手册

资源和成本规划 该解决方案主要部署如下资源，不同产品的花费仅供参考，具体请参考华为云官网价格，实际以收费账单为准： 表1 资源和成本规划（按需计费） 华为云服务 配置示例 每月预估花费 弹性 云服务器ECS 按需计费：0.78元/小时 区域：华北-北京四 计费模式：按需计费 规格： 通用计算型 S6 | 4核 | 8GB 镜像：Ubuntu 22.04 server 64bit 系统盘：高IO | 100GB 购买量：1 560.88 元 弹性公网IP EIP 按需计费：0.80元/GB 区域：华北-北京四 计费模式：按需计费 线路：动态BGP 公网带宽：按流量计费 购买数量：1 0.80 元/GB 合计 - 560.88 元 + 流量费用 表2 资源和成本规划（包年包月） 华为云服务 配置示例 每月预估花费 弹性云服务器E CS 区域：华北-北京四 计费模式：包月 规格： 通用计算型 S6 | 4核 | 8GB 镜像：Ubuntu 22.04 server 64bit 系统盘：高IO | 100GB 购买量：1 339.30 元 弹性公网IP EIP 按需计费：0.80元/GB 区域：华北-北京四 计费模式：按需计费 线路：动态BGP 公网带宽：按流量计费 购买数量：1 0.80 元/GB 合计 - 339.30 元 + 流量费用

操作步骤 登录 域名 注册控制台。 进入“域名列表”页面。 在左侧树状导航栏中，选择“信息模板”。 在页面右上角，单击“创建信息模板”。 图1 创建信息模板 设置“域名所有者类型”为“企业”。 在“域名所有者实名信息”区域选择域名所有者类型并上传域名所有者证件图片。详细说明如表1所示。 图2 域名所有者实名信息（企业） 表1 域名所有者实名信息填写说明 参数 参数说明 域名所有者类型 域名所有者类型分为个人和企业，选择不同的“域名所有者类型”对域名的使用并无影响。 个人：采用个人有效身份证件进行实名认证，域名所有者为个人。 企业：采用企业或组织有效证件进行实名认证，域名所有者为企业或组织。 说明： 如果域名用于部署在中国大陆节点的网站，则还需要进行网站备案。备案时，要求域名信息（域名所有者、证件类型、证件号码）与备案主体信息保持一致。 这就决定了域名信息模板实名认证域名所有者类型与网站类型、备案类型存在以下对应关系： 个人：适用于非经营性个人网站，采用个人备案。 企业：适用于经营性或非经营性企业或组织网站，采用单位备案。 因此，建议您在选择信息模板实名认证的域名所有者类型时，考虑域名所属的网站及备案类型。如果存在不一致，可以通过域名过户变更域名所有者和域名所有者类型。 证件类型 根据域名所有者类型选择合适的证件类型。 域名所有者类型为“个人”，证件类型的选择请参见表1 个人用户支持的信息模板实名认证证件类型。 域名所有者类型为“企业”，证件类型的选择请参见表2 企业用户支持的域名实名认证证件类型。 证件图片 上传用于信息模板实名认证的证件图片。具体要求请参见如何准备并上传“实名认证材料”。 样式： 必须为证件原件的竖屏、彩色电子版照片，不允许使用黑白复印件照片或黑白照片。 必须确保证件四角边框齐全。 必须确保照片无遮挡、无涂抹或马赛克，无水印（ 含相机自带水印或自定义水印）、无明显折痕。 必须确保照片无反光，请将证件放置在明亮、不反光的环境中拍照，避免信息不清晰。 必须包含清晰完整的红色公章（颁证机关的公章），不需要加盖单位公章。 有国徽的证件，必须保证国徽为红色且清晰完整。 格式： 必须为jpg、jpeg、png、bmp格式。 如果认证材料不是要求的格式，请勿直接修改文件类型后缀，需使用系统自带画图工具、Photoshop等工具将图片打开后另存为“.jpg”或“.bmp”等格式的文件。 大小： 必须在55KB~5MB之间。 如果实名认证材料超大，请使用绘图工具调整文件大小至符合要求。 证件号码 上传证件图片中的证件号码，证件号码需与实名认证证件完全一致。 目前，上传证件图片后，系统会自动识别证件并录入证件号码。为保证准确性，自动录入后建议您再核查一遍。遵循以下原则： 填写格式为半角字符。 证件中（如组织机构代码证）包含的副本编号，如“（1-1）”，不需要填写。 注意区分数字“0”和字母“O”，数字“1”和字母“l”，数字“8”和字母“B”等。 注意代码位数，不要漏填、多填。 域名所有者（中文） 域名所有者拥有域名的归属权。 目前，上传证件图片后，系统会自动识别证件并录入域名所有者。为保证准确性，自动录入后建议您再核查一遍。“域名所有者”需与证件中的“姓名”或者“名称”完全一致。 当“域名所有者类型”为“个人”，支持输入2~32个字符，可以包含数字及英文字母。 当“域名所有者类型”为“企业”，支持输入3~64个字符，可以包含数字及英文字母。 可以使用.,、·（）()《》\\-\"“”/'特殊字符。 必须包含中文，中间不允许输入空格。 说明： 证件图片、证件号码、域名所有者三者的填写请参见信息模板实名认证填写示例（个人）和信息模板实名认证填写示例（企业）。 填写“中文模板信息”和“英文模板信息”。 表2 中文、英文模板信息填写说明 参数 参数说明 中文模板信息 联系人（中文） 域名的联系人。 支持输入2~32个字符，可以包含数字及英文字母。 可以使用.,、·（）()《》\\-\"“”/'特殊字符。 必须包含中文，中间不允许输入空格。 所属区域 根据所在地区进行选择。 通讯地址（中文） 支持输入4~64个中文，由中文开头，可包括英文字母和数字。 通讯地址建议与实名认证证件上的地址保持一致。 电子邮箱 必须选择已验证的电子邮箱。可通过单击右侧“添加邮箱验证”进行验证，详细操作请参考邮箱验证。 邮编 通讯地址所在地的邮政编码。 联系方式 支持输入手机号码或固定电话（加区号）。 手机号码示例：138XXXX0000 固定电话示例：0108523XXXX或0871XXXXXXXX，其中“010”、“0871”为区号。根据注册局规定，固定电话区号需与填写的通讯地址相对应，例如通讯地址填写“北京市”，则固定电话区号为“010”。 英文模板信息 域名所有者（英文） 域名所有者拥有域名的归属权。 该参数会根据上述输入的域名所有者（中文）自动生成。 仅支持输入.·-()'特殊字符。 说明： 若英文域名所有者长度超过64个字符，则可将英文字符删除到限值以内，不会影响实名认证。 联系人（英文） 支持输入4~64个字符，可以包含数字及.,·()-'\"\\特殊字符，不能包含/特殊字符。 该参数会根据上述输入的联系人（中文）自动生成。 通讯地址（英文） 支持输入9~64个字符，由英文字母开头，仅支持.·-()/\特殊字符。 该参数会根据上述输入的通讯地址（中文）自动生成。 说明： 若英文地址长度超过64个字符，则可将英文字符删除到限值以内，不会影响实名认证。 单击“提交”，完成信息模板的配置。 在左侧树状导航栏中，选择“信息模板”。 在信息模板列表中，可以查看已创建的信息模板。 此时，信息模板的“认证状态”为“实名认证审核中”。待信息模板的“认证状态”变为“已实名认证”，表示信息模板实名认证审核通过。 信息模板实名认证一般1个工作日内即可完成审核（部分需要3~5个工作日），请您耐心等待。

操作场景 根据工信部要求，在注册域名时需要填写用户信息并通过实名认证。 您可以通过创建信息模板操作预先设置域名所有者的信息，并对信息模板进行实名认证。 信息模板的实名认证审核由注册局负责，一般1个工作日内即可完成审核（部分需要3~5个工作日）。 在进行域名注册时，需选择已实名认证通过的信息模板来设置域名所有者信息，那么在域名注册成功后，域名的状态会自动同步域名关联的信息模板实名认证状态。 本章节以创建“企业”信息模板为例进行介绍，创建“个人”信息模板的操作请参见创建信息模板（个人用户）。

操作场景 当系统上报“系统维护”事件时，您需要对ECS实例（含裸金属类型实例）进行“授权维护”操作。 本文介绍如何响应“待授权”状态的“系统维护”事件，指导您完成系统维护的授权操作。 授权维护包括两种模式： 立即授权维护：即系统收到请求后，会在5个工作日内完成实例宿主机的系统维护。 预约授权维护：即系统收到请求后，会在设置的预约维护时间后5个工作日内完成实例宿主机的系统维护。 设置预约维护时间后，您还可以修改预约时间，详细内容，请参见修改预约时间。 系统维护操作需要对主机进行下电，在此期间云服务器将停止无法工作。在授权维护前，请确保云服务器中部署的业务离线或云服务器停止对业务无影响。 如果云服务器上的业务不可停止，请勿授权，并联系技术支持进行处理。

前提条件 如果您通过 IAM 用户进行本操作，则需要在操作前对IAM用户进行授权。 查询及响应事件操作依赖以下策略： 查询事件：ecs:instanceScheduledEvents:list 接受并授权执行事件：ecs:instanceScheduledEvents:accept 修改预约时间：ecs:instanceScheduledEvents:update 为IAM用户授权的操作，请参见ECS自定义策略。

操作场景 安全组类似防火墙功能，是一个逻辑上的分组，用于设置网络访问控制。用户可以在安全组中定义各种访问规则，当弹性云服务器加入该安全组后，即受到这些访问规则的保护。 入方向规则：放通入方向网络流量，指从外部访问安全组规则下的云服务器。 出方向规则：放通出方向网络流量。指安全组规则下的云服务器访问安全组外的实例。 默认安全组规则请参见默认安全组和规则。常用的安全组规则配置示例请参见安全组配置示例。

操作场景 当进行“本地盘换盘”事件的“授权换盘”操作时，需要先对本地盘进行换盘预处理。 本文介绍如何对裸金属类型的ECS实例进行本地盘的换盘预处理操作。 本地盘换盘操作会丢失故障本地盘上的数据，如果无需保留本地盘上的数据，可通过本操作换盘预处理。 本地盘换盘操作可能伴随宿主机的下电与重启，在预处理前，请确保云服务器中部署的业务离线，或云服务器停止对业务无影响。 如果需要保留本地盘上的数据或如果云服务器上的业务不可停止，请结束操作并联系技术支持进行处理。

如何统一设置企业签名? 1. 企业签名：管理员可统一为成员设定企业签名，在“管理端-企业定制-企业签名”设置。成员在撰写邮件时，可选择设定的企业签名或自定义的签名。 2. 创建企业签名：填写签名名称，适用该企业签名的邮箱域名（则对应域名的 企业邮箱 成员可于前台查看及使用），可在签名中加入变量，包含成员姓名，所在部门，公司名称，其企业邮箱。 3. 使用企业签名：成员登录邮箱前台后，可在“个人设置-个人信息”中，查看管理员设置的企业签名。成员也可自定义签名、设置写邮件、回复/转发的默认签名。 父主题： 企业个性化定制

优化顾问的风险检查覆盖哪些云服务产品？ 目前已经覆盖18个云服务产品，含ECS（云服务器）、RDS（云数据库）、ELB（负载均衡）、CDN（内容分发）、VPC（专有网络）、EVS、BMS、DDoS、镜像、域名、配额、安全组、VPN（VPN网关）、NAT（NAT网关）、EIP（弹性公网IP）、DDS、 MRS 、DMS、DCS、 CSS 、DWS、 DLI 、ModelArts。后续随着优化顾问的发展会覆盖更多的云产品，敬请期待。

计费模式检查 应用场景 部分资源支持将按需计费实例转为包周期（包年/包月）实例。由于按需资源较贵，需要长期使用资源的按需用户可以选择对按需资源进行转包周期，继续使用这些资源的同时，享受包周期的低资费。 检查步骤 登录优化顾问服务控制台。 在“风险检查总览”页面，单击“开始检查”按钮，当检查进度为100%时检查完成。 图1 点击检查 图2 检查 在“风险检查维度”菜单下，单击“成本”页签，在“风险项”页签，查看部分资源计费模式检查结果 优化建议 建议将按需计费超过一个月的实例的计费方式变更为包周期计费，节约成本。

响应参数 状态码： 200 表8 响应Body参数 参数 是否必选 参数类型 描述 job_id 否 String 创建的任务标识, 如果创建任务成功时必须存在。 由于录音文件识别通常会需要较长的时间，因此识别是异步的，即接口分为创建识别任务和查询任务状态两个接口。 创建识别任务接口创建任务完成后返回job_id参数，然后用户通过调用录音文件识别状态查询接口来获得转写状态和结果。 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 提交录音文件识别任务 POST https://{endpoint}/v1/1609d8170cd86660a81281e5a3a03f8b/asr/transcriber/jobs Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "config": { "audio_format": "auto", "property": "chinese_8k_general", "add_punc": "yes", "need_analysis_info": { "diarization": true, "channel": "LEFT_AGENT", "emotion": true }, "need_word_info": "yes" }, "data_url":"https://****_voip.obs.myxxxcloud.com/VOIP/***.wav" } 使用Python3语言提交录音 文字识别 任务 # -*- coding: utf-8 -*- # 此demo仅供测试使用，强烈建议使用sdk。需提前安装requests，执行pip install requests import requests import time import json def lasr_demo(): url = 'https://{{endpoint}}/v1/{{project_id}}/asr/transcriber/jobs' # endpoint和project_id需替换 token = '用户对应region的token' obs_url = 'obs路径' header = { 'Content-Type': 'application/json', 'X-Auth-Token': token } body = { 'data_url': obs_url, 'config': { 'property': 'chinese_8k_general', 'audio_format': 'auto' } } resp = requests.post(url, data=json.dumps(body), headers=header) job_id = json.loads(resp.text, encoding='utf-8')['job_id'] query_task(header, job_id) def query_task(header, job_id): # endpoint和project_id需替换 url = 'https://{{endpoint}}/v1/{{project_id}}/asr/transcriber/jobs/' + job_id for _ in range(1000): resp = requests.get(url, headers=header) print(resp.text) if resp.text.find('segments') != -1: break time.sleep(1) if __name__ == '__main__': lasr_demo() 使用Java语言提交录音文件识别任务 import java.io.BufferedReader; import java.io.InputStream; import java.io.InputStreamReader; import java.io.OutputStreamWriter; import java.net.HttpURLConnection; import java.net.URL; /** * 此demo仅供测试使用，强烈建议使用SDK */ public class LasrDemo { public void lasrDemo() { try { // endpoint和projectId需要替换成实际信息。 URL url = new URL("https://{{endpoint}}/v1/{{project_id}}/asr/transcriber/jobs"); String token = "对应region的token"; String obsUrl = "音频在obs的路径"; HttpURLConnection connection = (HttpURLConnection)url.openConnection(); connection.setRequestMethod("POST"); connection.setDoInput(true); connection.setDoOutput(true); connection.addRequestProperty("Content-Type", "application/json"); connection.addRequestProperty("X-Auth-Token", token); OutputStreamWriter osw = new OutputStreamWriter(connection.getOutputStream(), "UTF-8"); String body = "{\"data_url\":\"" + obsUrl + "\", \"config\": { \"audio_format\": \"auto\", " + "\"property\":\"chinese_8k_general\"}}"; osw.append(body); osw.flush(); InputStream is = connection.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8")); String jobId = ""; while (br.ready()) { String line = br.readLine().trim(); jobId = line.replace("{\"job_id\":\"", "").replace("\"}", ""); } queryTask(token, jobId); } catch (Exception e) { e.printStackTrace(); } } private void queryTask(String token, String jobId) { try { // endpoint和projectId需要替换成实际信息。 URL url = new URL("https://{{endpoint}}/v1/{{project_id}}/asr/transcriber/jobs/" + jobId); while (true) { HttpURLConnection connection = (HttpURLConnection)url.openConnection(); connection.setRequestMethod("GET"); connection.setDoInput(true); connection.setDoOutput(true); connection.addRequestProperty("Content-Type", "application/json"); connection.addRequestProperty("X-Auth-Token", token); InputStream is = connection.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8")); if (br.ready()) { String line = br.readLine(); System.out.println(line); if (line.contains("segments")) { break; } } Thread.sleep(2000); } } catch (Exception e) { e.printStackTrace(); } } public static void main(String[] args) { LasrDemo lasrDemo = new LasrDemo(); lasrDemo.lasrDemo(); } }

功能介绍 该接口用于提交录音文件识别任务，其中录音文件保存在用户的OBS桶中或公网可访问的服务器上（需保证可使用域名访问）。用户开通 录音识别 服务时，如果录音文件存放在OBS桶中，需授权录音文件引擎读取用户OBS桶权限，授权方法见配置OBS访问权限。该接口的使用限制请参见约束与限制，详细使用指导请参见SIS服务使用简介章节。 SIS服务控制台提供了录音文字识别的在线使用页面，用户无需编程即可使用服务功能。 图1 在线使用

接口约束 录音时长不超过5小时，文件大小不超过300M。8k采样率音频最小为1.6kb，16k采样率音频最小为3.2kb，即音频时长至少0.1s以上。 需要将识别的录音文件存放在某服务上，可以通过URL访问。 推荐使用华为云OBS：授权配置请参见配置OBS服务，优先推荐使用与请求服务同一region的私有桶文件，如果region不一致，可考虑使用obs签名。 您也可以把录音文件放在自行搭建服务器上，提供下载文件的地址。URL不能使用IP地址，只能使用域名，请尽量避免中文。 音频转写时长受音频时长和排队任务数量影响，音频时长和理论返回时间可参见表 音频转写时长参考表。如果转写耗时比理论时延长，大概率表示当前时间段出现转写高峰，请耐心等待，我们承诺最大转写时长不超过6小时。 表1 音频转写时长参考表 音频时长 参考返回时间 小于10分钟 小于2分钟 10分钟-60分钟 2分钟-12分钟 大于60分钟 12 分钟-60分钟 识别结果保存72小时（从识别完成的时间算起）。72小时后如果再访问，将会返回 "task id is not found"错误。

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。响应消息头中X-Subject-Token的值即为Token。 Enterprise-Project-Id 否 String 企业项目ID。SIS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 账户创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用SIS服务，账单归到企业ID对应的企业项目中。 携带错误的ID，正常使用SIS服务，账单的企业项目会被分类为“default”。 不携带ID，正常使用SIS服务，账单的企业项目会被分类为“default”。 表4 请求Body参数 参数 是否必选 参数类型 描述 config 是 TranscriberConfig object 录音文件识别配置信息。 data_url 是 String 存放录音文件地址： 推荐使用华为云OBS：授权配置请参见配置OBS服务。 您也可以把录音文件放在自行搭建服务器上，提供下载文件的地址。URL不能使用IP地址，只能使用域名，请尽量避免中文。 表5 TranscriberConfig 参数 是否必选 参数类型 描述 audio_format 否 String 支持语音的格式，请参考表 audioformat取值范围。 property 是 String 所使用的模型特征串。通常是“语种_采样率_领域”的形式，例如chinese_8k_common。 采样率需要与音频采样率保持一致。 当前支持如下模型特征串： chinese_8k_general（区域支持cn-north-4, cn-east-3，最新端到端通用模型，强烈推荐使用） chinese_16k_media（音视频领域，区域仅支持cn-north-4，cn-east-3，强烈推荐使用） chinese_8k_common（中文普通话 语音识别 ） chinese_16k_conversation（会议场景的中文普通话语音识别） sichuan_8k_common（四川话识别，区域支持cn-north-4，cn-east-3） chinese_8k_bank（银行领域，区域仅支持cn-north-4） chinese_8k_insurance（保险领域，区域仅支持cn-north-4） add_punc 否 String 表示是否在识别结果中添加标点，取值为yes 、 no，默认no。 callback_url 否 String 表示回调 url，即用户用于接收识别结果的服务器地址，不支持IP地址方式调用，url长度小于2048字节。服务请求方法为POST，请求体参见表 响应参数。 如果用户使用回调方式获取识别结果，需填写该参数，处理成功后用户服务器需返回状态码“200”。 如果用户使用轮询方式获取识别结果，则无需填写该参数。 digit_norm 否 String 表示是否将语音中的数字识别为阿拉伯数字，取值为yes 、 no，默认为yes。 need_analysis_info 否 AnalysisInfo object 该参数用于设置质检分析参数，是否需要输出质检分析内容以及会议场景多说话人分离，如果为null , 表示不需要。 vocabulary_id 否 String 热词表id，不使用则不填写。 创建热词表信息请参考创建热词表。 need_word_info 否 String 表示是否在识别结果中输出分词结果信息，取值为“yes”和“no”，默认为“no”。 表6 AnalysisInfo 参数 是否必选 参数类型 描述 diarization 否 Boolean 是否需要做话者分离。 默认为true，表示会进行话者分离，识别结果中会包含role项（角色）。 如果diarization为false，那么结果中不会出现role项。 说明： 本表中的参数对audio_format格式中采样率为8k和16k的音频有效。对于8k单声道音频，8k双声道音频以及16k双声道音频仅支持两个说话人分离；对于16k单声道音频，自动识别说话人个数，返回结果最多支持10个说话人，并且property仅支持chinese_16k_media，区域仅支持cn-east-3。 channel 否 String 语音文件声道信息，默认为MONO，可设置为MONO，LEFT_AGENT, RIGHT_AGENT。 如果channel 为MONO，那么原始文件需要为单声道文件。 如果为双声道文件，系统会将其转换成单声道文件，可能会影响识别效果。 如果 channel 为 LEFT_AGENT或RIGHT_AGENT, 则原始文件需要为双声道文件，如果为单声道文件，系统会将其转换成双声道文件，识别结果会出现两条内容完全一致的文本。 当channel 为 LEFT_AGENT或RIGHT_AGENT，且diarization为true时，系统会按照配置给出对应角色。其中： LEFT_AGENT 指定左声道语音为agent（坐席）。 RIGHT_AGENT 指定右声道为agent（坐席）。 emotion 否 Boolean 是否需要做情绪检测，默认为true。仅对audio_format格式中采样率为8k的音频有效。 目前支持NORMAL（正常）、ANGRY（愤怒）和UNKNOWN（未知）情绪识别。 speed 否 Boolean 是否需要输出语速信息，默认为true。 表7 audio_format取值范围 audio_format取值 描述 auto 默认格式，系统自动判断，支持的音视频格式如下：WAV（内部支持pcm/ulaw/alaw/adpcm编码格式）、AMR、FLAC、M4A、MP3、OGG、WEBM、AAC、AC3、MOV、WMA、MP4、AVI、RMVB、MKV、FLV、F4V、WMV、3GP。支持双声道的音视频。 pcm16k16bit 16k16bit裸音频录音数据。 pcm8k16bit 8k16bit裸音频录音数据。 ulaw16k8bit 16k8bit ulaw 裸音频录音数据。 ulaw8k8bit 8k8bit ulaw 裸音频录音数据。 alaw16k8bit 16k8bit alaw 裸音频录音数据。 alaw8k8bit 8k8bit alaw 裸音频录音数据。

部署架构画图 左侧导航树选择“架构设计”进入架构设计页面。 点击左上角“新建部署架构”，需要填写架构名称，选择架构类型（对画图无影响），填写描述，选择部署情况（对画图无影响）。 在“部署架构”列表中找到刚刚新建的部署架构图，鼠标放到架构图中央，单击“查看架构图”，进入架构图。 单击画图上方“浏览”开关打开编辑功能。 右侧提供了画图需要的基础图元和各云服务图元。 左侧画图工具栏选择“自动画图”，拖动“子网”图元到画图，双击“子网”图元，选择区域、虚拟私有云和子网后单击开始分析，可以自动识别并画出该子网下的资源信息并按照逻辑架构分层。开通VPC流日志之后还可以绘制出各资源之间的关联关系。 左侧画图工具栏选择“支持全链路”，里边的云服务支持全链路一键画图。 将其中一个云服务图元（例如弹性云服务器ECS）拖动至画布中。 双击ECS图元，选择区域和资源类型查询该区域下的ECS实例资源，按需选择实例资源，然后单击画布或者单击右拉箭头关闭实例选择页面。 单击ECS图元，图元右侧有三个按钮，点击右侧中间按钮，进行全链路一键画图 左侧画图工具栏选择“支持实例”，里边的云服务支持实例关联，将其中一个云服务图元（例如弹性云服务器ECS）拖动至画布中，双击ECS图元，选择区域和资源类型查询该区域下的ECS实例资源，按需选择实例资源，然后单击画布或者单击右拉箭头关闭实例选择页面。

修订记录 发布日期 修订记录 2023-10-09 修改 FineBI工具对接DLI Trino、PowerBI工具对接DLI Trino补充Trino引擎支持的区域。 2023-08-15 修改 FineBI工具对接DLI Trino、PowerBI工具对接DLI Trino补充说明“Trino引擎队列仅支持HTTPS协议的连接方式”。 2023-07-21 新增 FineBI工具对接DLI Trino章节。 PowerBI工具对接DLI Trino章节。 2023-03-09 调整手册结构，将DLI数据开发相关内容迁移至《 数据湖探索 开发指南》。 2023-03-02 修改关于迁移Kafka数据至DLI中的前提条件的说明。 2023-01-18 迁移Kafka数据至DLI补充关于 CDM 配置迁移作业场景的相关说明。 2023-01-06 配置DLI队列与内网数据源的网络联通，优化“外部数据源的安全组添加放通DLI队列网段的规则”操作步骤。 2022-10-31 优化以下章节补充方案优势、流程引导、资源和成本规划等信息。 使用DLI进行车联网场景驾驶行为数据分析 使用DLI将CSV数据转换为Parquet数据 使用DLI Flink SQL进行电商实时业务数据分析 2022-09-27 新增配置DLI 队列与公网网络联通。

支持的授权项 策略支持的操作与API相对应，授权项列表说明如下： 权限：自定义策略中授权项定义的内容即为权限。 对应API接口：自定义策略实际调用的API接口。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。 AM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。 “√”表示支持，“x”表示暂不支持。 GES支持自定义策略授权项如下表所示。 表1 API授权项列表 权限 对应API接口 授权项 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 查询图列表 GET /v1.0/{project_id}/graphs?offset={offset}&limit={limit} ges:graph:list 项目级服务VPC vpc:publicIps:get √ √ 查看图详情 GET /v1.0/{project_id}/graphs/{graph_id} ges:graph:getDetail - √ √ 创建图 POST /v1.0/{project_id}/graphs ges:graph:create 项目级服务ECS ecs:cloudServerFlavors:get ecs:cloudServerNics:update 项目级服务EVS evs:types:get 项目级服务VPC vpc:ports:create vpc:ports:update vpc:securityGroups:get vpc:publicIps:list vpc:ports:get vpc:subnets:get vpc:vpcs:list √ √ 关闭图 POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=stop ges:graph:operate - √ √ 启动图 POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=start ges:graph:operate - √ √ 删除图 DELETE /v1.0/{project_id}/graphs/{graph_id} ges:graph:delete 项目级服务VPC vpc:publicIps:get vpc:ports:delete vpc:ports:get √ √ 增量导入图 POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=import-graph ges:graph:operate - √ √ 导出图 POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=export-graph ges:graph:operate - √ √ 清空图 POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=clear-graph ges:graph:operate - √ √ 升级图 POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=upgrade ges:graph:operate - √ √ 重启图 POST /v1.0/{project_id}/graphs/{graph_id}/action ges:graph:operate - √ √ 变更图规格 POST /v1.0/{project_id}/graphs/{graph_id}/resize ges:graph:resize - √ √ 扩副本 POST /v1.0/{project_id}/graphs/{graph_id}/expand ges:graph:expand 项目级服务ECS ecs:cloudServerFlavors:get ecs:cloudServerNics:update 项目级服务EVS evs:types:get 项目级服务VPC vpc:ports:create vpc:ports:update vpc:securityGroups:get vpc:publicIps:list vpc:ports:get vpc:subnets:get vpc:vpcs:list √ √ 绑定EIP POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=bindEip ges:graph:operate - √ √ 解绑EIP POST /v1.0/{project_id}/graphs/{graph_id}/action?action_id=unbindEip ges:graph:operate - √ √ 查看所有备份列表 GET /v1.0/{project_id}/graphs/backups?offset={offset}&limit={limit} ges:backup:list - √ √ 查看某个图的备份列表 GET /v1.0/{project_id}/graphs/{graph_id}/backups?offset={offset}&limit={limit} ges:backup:list - √ √ 新增备份 POST /v1.0/{project_id}/graphs/{graph_id}/backups ges:backup:create - √ √ 删除备份 DELETE /v1.0/{project_id}/graphs/{graph_id}/backups/{backup_id} ges:backup:delete - √ √ 查询元数据列表 GET /v1.0/{project_id}/graphs/metadatas?offset={offset}&limit={limit} ges:metadata:list - √ √ 查询元数据 GET /v1.0/{project_id}/graphs/metadatas/{metadata_id} ges:metadata:list - √ √ 校验元数据 POST /v1.0/{project_id}/graphs/action?action_id=check-schema ges:metadata:operate - √ √ 新增元数据 POST /v1.0/{project_id}/graphs/metadatas ges:metadata:create - √ √ 删除元数据 DELETE /v1.0/{project_id}/graphs/metadatas/{metadata_id} ges:metadata:delete - √ √ 查询任务状态 GET /v1.0/{project_id}/graphs/{graph_id}/jobs/{job_id}/status ges:jobs:getDetail - √ √ 查询任务列表 GET /v1.0/{project_id}/graphs/jobs?offset={offset}&limit={limit} ges:jobs:list - √ √

响应参数 表2 响应Body参数说明 参数 类型 说明 graphs Array of graphs objects 返回的图列表。 result String 查询成功时值为success，失败时值为failed。 表3 graphs 参数 类型 说明 graph_name String 返回的图名。 idType String ID类型。 idLength Integer ID长度。 sortKeyType String sortKey类型。 averageImportRate Integer 平均导入率。

响应示例 状态码： 200 成功响应示例 Http Status Code: 200 { "graphs": [ { "graph_name": "movieee", "idType": "fixedLengthString", "idLength": 20, "sortKeyType":"varString"， "averageImportRate": 0.0 }, { "graph_name": "ldbc", "idType": "fixedLengthString", "idLength": 20, "sortKeyType":"int"， "averageImportRate": 0.0 } ], "result": "success" } 状态码： 400 失败响应示例 Http Status Code: 400 { "result": "failed" }

响应参数 表5 响应Body参数说明 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 jobId String 执行该异步任务的jobId。 可以查询jobId查看任务执行状态、获取返回结果，详情参考查询Job状态(1.0.0)-业务面。

响应示例 状态码： 200 成功响应示例 HttpStatusCode: 200 { "jobId": "f99f60f1-bba6-4cde-bd1a-ff4bdd1fd500000168232" } 状态码： 400 失败响应示例 HttpStatusCode: 400 { "errorMessage": "graph [demo] is not found", "errorCode": "GES.8011" }

URI POST /ges/v1.0/{project_id}/graphs/{graph_name}/jobs/{job_id}/action?action_id=export-result 表1 路径参数 参数 是否必选 类型 说明 project_id 是 String 项目ID。获取方法请参见获取项目ID。 graph_name 是 String 图名称。 job_id 是 String Response对应的任务Job ID。

功能介绍 用于将异步任务（jobId）的执行结果（result）导出到文件。 支持算法列表： pagerank、personalrank、pixie louvain、label_propagation、connect_component kcore sssp、shortest_path（含time_window_shortest_path）、shortest_path_of_vertex_sets、all_shortest_paths、n_paths traingle_count、cluster_coefficient、degree_correlation、closeness link_prediction betweenness、edge_betweenness、od_betweenness 支持查询列表 Cypher操作API（2.2.16） 点过滤查询(1.0.0) 边过滤查询(1.0.0)

请求参数 表2 Body参数说明 参数 是否必选 类型 说明 exportPath 是 String 导出路径。 fileName 否 String 导出文件名。 obsParameters 是 String OBS认证参数。具体请见表3。 paginate 否 Object 分页参数，导出异步任务API默认关闭分页，具体请见表表4。 erase 否 Boolean 导出后是否删除原job任务，取值为true或false，默认值为true即表示默认删除job并释放资源。 表3 obsParameters参数说明 参数 是否必选 类型 说明 accessKey 是 string ak值。 secretKey 是 string sk值。 表4 paginate中各要素说明 参数 是否必选 类型 说明 enable 否 Bool 是否开启分页，默认为false，需要开启分页时，需输入值true。 rowCountPerFile 否 Int 按页导出时，每个文件最大行数，默认10000000。 numThread 否 Int 按页导出时，并行线程数，默认为8。 maxSizePerFile 否 Int 按页导出时，每个文件大小的最大值，单位是byte。 分页参数说明 当分页参数开启状态下，请求体中fileName代表目录名，目录下存放分页的文件；分页参数关闭时，fileName代表文件名。导出前请保证文件名指向的路径为空，确保导出时不会覆盖OBS上已有数据。 当numThread的值大于GES图实例使用的机器cpu数时，会配置为机器cpu数。 rowCountPerFile的值会影响实际使用的线程数。即当结果集大小和rowCountPerFile的比值小于numThread时，会使用这个比值作为线程数。 如果请求被用户取消，已上传到OBS中的数据不会删除，有关取消Job的API详见取消Job(1.0.0)。 分页开启时文件名的命名规则： 分页选项中enable参数为true时，fileName代表一个目录，目录下的文件使用线程id与文件编号的组合命名，中间使用“.”连接。例如，对于320万条数据，不同配置下第一个文件名和最后一个文件名示例如下： rowCountPerFile 10万 10万 100万 100万 500万 numThread 2 48 2 5 2 实际使用的线程 2 32 2 4 1 单线程生成文件数 16 1 2 1 1 第一个文件名 00.000.txt 00.000.txt 00.00.txt 00.00.txt 00.00.txt 最后一个文件名 01.015.txt 031.000.txt 01.01.txt 03.00.txt 00.00.txt 百亿图进行数据导出时，为多节点数据同时导出，文件名前会使用机器id编号作为前缀。

请求参数 表2 Body参数说明 参数 是否必选 类型 说明 project_id 是 String 项目ID。获取方法请参见获取项目ID。 graph_name 是 String 图名称。 sourceVertex 是 String 边的起点。 targetVertex 是 String 边的终点。 label（持久化版） 否 String 边的label值。 sortKey（持久化版） 否 String 重复边的sortKey值。 sortKeyType（持久化版） 否 String 重复边sortKey的类型，int/string/null/varString,sortKey被传入时，此参数为必需，类型与创建图时的sortKey类型需一致，null除外。

响应示例 状态码： 200 成功响应样例 { "data": { "edges": [ { "source": "46", "target": "39", "label": "rate", "sortKey": 5, "properties": { "Rating": [ 5 ], "Datetime": [ "2018-01-0120:30:05" ] } } ] }, "result": "success" } 状态码： 400 失败响应示例 Http Status Code: 400 { "errorMessage":"graph [demo] is not found", "errorCode":"GES.8107" }

响应参数 表3 响应Body参数 参数 类型 说明 errorMessage String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误信息。 errorCode String 系统提示信息。 执行成功时，字段可能为空。 执行失败时，用于显示错误码。 data Object 查询结果。查询成功时显示结果，若查询失败时，字段为空。 result String 查询成功时值为success，失败时值为failed。 表4 data参数说明 参数 是否必选 类型 说明 edges 是 List 边的结果集合。没有查询到对应边时，edges内容为空。

URI POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/properties/action?action_id={actionId} 表1 路径参数 参数 是否必选 类型 说明 project_id 是 String 项目ID。获取方法请参见获取项目ID。 graph_name 是 String 图名称。 actionId 是 String 操作符。 batch-update 更新该属性的值。 batch-add 添加属性的值。当属性的cardinality为single时，其操作与update一致；当cardinality为list或set时，意为向集合中添加值。 batch-del 删除属性的值。

请求参数 表2 Body参数说明 参数 是否必选 类型 说明 edges 是 Json 待更新边数组。 表3 edges参数说明 参数 是否必选 类型 说明 source 是 String 边的source节点。 target 是 String 边的target节点。 label 否 String 边的label。 sortKey 否 String/int/null/varString 重复边的sortKey，查询时给出sortKey必须给出label，类型与创建图时的sortKey类型需一致，null除外。 properties 是 Object 各个属性的值。