华为云用户手册

请求参数 SP调用语音通知API，语音通话平台发起呼叫，给用户播放自定义的语音文件或 TTS 合成语音文件，并可进行收号，获得应答信息并反馈给SP。 注：以下流程以语音通话平台呼叫A，给A播放语音文件并收号为例。流程和接口示例仅供参考，请以实际消息为准。 表2 请求Headers参数说明 参数名称 是否必选 参数类型 说明 Content-Type 是 String 固定填写为application/json;charset=UTF-8。 Authorization 是 String 固定填写为AKSK realm="SDP",profile="UsernameToken",type="Appkey"。 X-AKSK 是 String 取值为UsernameToken Username="APP_Key的值", PasswordDigest="PasswordDigest的值", Nonce="随机数", Created="随机数生成时间"。 PasswordDigest：根据PasswordDigest = Base64(HMAC(appSecret, url+"\n"+安全随机数+"\n"+时间戳))生成。其中，url使用客户设置的话单推送URL，随机数需使用安全随机数。 Nonce：客户发送请求时生成的一个随机数，长度为1~128位，可包含数字和大小写字母。例如：66C92B11FF8A425FB8D4CCFE0ED9ED1F。 Created：随机数生成时间。采用UTC+8(北京时间)格式，例如：2018-02-12T15:30:20Z。不同编程语言中将UTC时间戳转换为普通时间时使用的格式不同，部分语言可参考表3。 表3 不同编程语言的时间格式 编程语言 时间格式 Java yyyy-MM-dd'T'HH:mm:ss'Z' PHP Y-m-d\TH:i:s\Z Python %Y-%m-%dT%H:%M:%SZ C# yyyy-MM-ddTHH:mm:ssZ Node.js toISOString().replace(/.[0-9]+\Z/, 'Z') 注：Node.js中，使用toISOString()转换后的时间格式去除毫秒后即为本接口要求的时间格式。 表4 请求Body参数说明 参数名称 是否必选 参数类型 说明 eventType 是 String(枚举) 该参数标识API事件通知的类型。取值范围如下： callout：呼出事件 alerting：振铃事件 answer：应答事件 collectInfo：放音收号结果事件 disconnect：挂机事件 statusInfo 否 CallStatusInfo 呼叫状态事件的信息。 当eventType参数为callout、alerting、answer、collectInfo、disconnect时携带。 CallStatusInfo 表5 callout：呼出事件 参数名称 是否必选 参数类型 说明 timestamp 是 String(1-128) 该呼叫事件发生时语音通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 userData 否 String(1-256) 用户附属信息，此参数的值与“语音通知API”中的"userData"参数值一致。 sessionId 是 String(1-256) 唯一指定一条通话链路的标识ID。 caller 否 String(1-32) 主叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：呼出事件的主叫号码为SP设置的来电显示号码（displayNbr）。 called 否 String(1-32) 被叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：呼出事件的被叫号码为A号码。 接口示例 POST /status HTTP/1.1 Content-Length: xx {"eventType":"callout","statusInfo":{"sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","timestamp":"2019-01-24 02:48:46","caller":"+86138****0022","called":"+86138****0021"}} 表6 alerting：振铃事件 参数名称 是否必选 参数类型 说明 timestamp 是 String(1-128) 该呼叫事件发生时语音通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 userData 否 String(1-256) 用户附属信息，此参数的值与“语音通知API”中的"userData"参数值一致。 sessionId 是 String(1-256) 唯一指定一条通话链路的标识ID。 caller 否 String(1-32) 主叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：振铃事件的主叫号码为SP设置的来电显示号码（displayNbr）。 called 否 String(1-32) 被叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：振铃事件的被叫号码为A号码。 接口示例 POST /status HTTP/1.1 Content-Length: xx {"eventType":"alerting","statusInfo":{"sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","timestamp":"2019-01-24 02:48:47","caller":"+86138****0022","called":"+86138****0021"}} 表7 answer：应答事件 参数名称 是否必选 参数类型 说明 timestamp 是 String(1-128) 该呼叫事件发生时语音通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 userData 否 String(1-256) 用户附属信息，此参数的值与“语音通知API”中的"userData"参数值一致。 sessionId 是 String(1-256) 唯一指定一条通话链路的标识ID。 caller 否 String(1-32) 主叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：应答事件的主叫号码为SP设置的来电显示号码（displayNbr）。 called 否 String(1-32) 被叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：应答事件的被叫号码为A号码。 接口示例 POST /status HTTP/1.1 Content-Length: xx {"eventType":"answer","statusInfo":{"sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","timestamp":"2019-01-24 02:49:12","caller":"+86138****0022","called":"+86138****0021"}} 表8 collectInfo：放音收号结果事件 参数名称 是否必选 参数类型 说明 timestamp 是 String(1-128) 该呼叫事件发生时语音通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 sessionId 是 String(1-256) 唯一指定一条通话链路的标识ID。 digitInfo 否 String(1-64) 语音通知场景中携带收号的结果。（即用户输入的数字） 接口示例 POST /status HTTP/1.1 Content-Length: xx {"eventType":"collectInfo","statusInfo":{"sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","timestamp":"2019-01-24 02:49:12","digitInfo":"02"}} 表9 disconnect：挂机事件 参数名称 是否必选 参数类型 说明 timestamp 是 String(1-128) 该呼叫事件发生时语音通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 userData 否 String(1-256) 用户附属信息，此参数的值与“语音通知API”中的"userData"参数值一致。 sessionId 是 String(1-256) 唯一指定一条通话链路的标识ID。 caller 否 String(1-32) 主叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：挂机事件的主叫号码为SP设置的来电显示号码（displayNbr）。 called 否 String(1-32) 被叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：挂机事件的被叫号码为A号码。 stateCode 否 Integer 通话挂机的原因值，仅当eventType为disconnect时携带。 取值范围及表示的含义请参考通话挂机原因值说明。 stateDesc 否 String(1-128) 通话挂机的原因值的描述，仅当eventType为disconnect时携带。 接口示例 POST /status HTTP/1.1 Content-Length: xx {"eventType":"disconnect","statusInfo":{"sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","timestamp":"2019-01-24 02:49:23","caller":"+86138****0022","called":"+86138****0021","stateCode":0,"stateDesc":"The user releases the call."}}

请求参数 SP调用语音验证码API，语音通话平台发起呼叫，给用户播放语音验证码。 注：以下流程以语音通话平台呼叫A，给A播放语音验证码为例。流程和接口示例仅供参考，请以实际消息为准。 表2 请求Headers参数说明 参数名称 是否必选 参数类型 说明 Content-Type 是 String 固定填写为application/json;charset=UTF-8。 Authorization 是 String 固定填写为AKSK realm="SDP",profile="UsernameToken",type="Appkey"。 X-AKSK 是 String 取值为UsernameToken Username="APP_Key的值", PasswordDigest="PasswordDigest的值", Nonce="随机数", Created="随机数生成时间"。 PasswordDigest：根据PasswordDigest = Base64(HMAC(appSecret, url+"\n"+安全随机数+"\n"+时间戳))生成。其中，url使用客户设置的话单推送URL，随机数需使用安全随机数。 Nonce：客户发送请求时生成的一个随机数，长度为1~128位，可包含数字和大小写字母。例如：66C92B11FF8A425FB8D4CCFE0ED9ED1F。 Created：随机数生成时间。采用UTC+8(北京时间)格式，例如：2018-02-12T15:30:20Z。不同编程语言中将UTC时间戳转换为普通时间时使用的格式不同，部分语言可参考表3。 表3 不同编程语言的时间格式 编程语言 时间格式 Java yyyy-MM-dd'T'HH:mm:ss'Z' PHP Y-m-d\TH:i:s\Z Python %Y-%m-%dT%H:%M:%SZ C# yyyy-MM-ddTHH:mm:ssZ Node.js toISOString().replace(/.[0-9]+\Z/, 'Z') 注：Node.js中，使用toISOString()转换后的时间格式去除毫秒后即为本接口要求的时间格式。 表4 请求Body参数说明 参数名称 是否必选 参数类型 说明 eventType 是 String(枚举) 该参数标识API事件通知的类型。取值范围如下： callout：呼出事件 alerting：振铃事件 answer：应答事件 disconnect：挂机事件 statusInfo 否 CallStatusInfo 呼叫状态事件的信息。 当eventType参数为callout、alerting、answer、disconnect时携带。 CallStatusInfo 表5 callout：呼出事件 参数名称 是否必选 参数类型 说明 timestamp 是 String(1-128) 该呼叫事件发生时语音通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 userData 否 String(1-256) 用户附属信息，此参数的值与“语音验证码场景API”中的"userData"参数值一致。 sessionId 是 String(1-256) 唯一指定一条通话链路的标识ID。 caller 否 String(1-32) 主叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：呼出事件的主叫号码为SP设置的来电显示号码（displayNbr）。 called 否 String(1-32) 被叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：呼出事件的被叫号码为A号码。 接口示例 POST /status HTTP/1.1 Content-Length: xx {"eventType":"callout","statusInfo":{"sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","timestamp":"2019-01-24 02:48:46","caller":"+86138****0022","called":"+86138****0021"}} 表6 alerting：振铃事件 参数名称 是否必选 参数类型 说明 timestamp 是 String(1-128) 该呼叫事件发生时语音通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 userData 否 String(1-256) 用户附属信息，此参数的值与“语音验证码场景API”中的"userData"参数值一致。 sessionId 是 String(1-256) 唯一指定一条通话链路的标识ID。 caller 否 String(1-32) 主叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：振铃事件的主叫号码为SP设置的来电显示号码（displayNbr）。 called 否 String(1-32) 被叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：振铃事件的被叫号码为A号码。 接口示例 POST /status HTTP/1.1 Content-Length: xx {"eventType":"alerting","statusInfo":{"sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","timestamp":"2019-01-24 02:48:47","caller":"+86138****0022","called":"+86138****0021"}} 表7 answer：应答事件 参数名称 是否必选 参数类型 说明 timestamp 是 String(1-128) 该呼叫事件发生时语音通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 userData 否 String(1-256) 用户附属信息，此参数的值与“语音验证码场景API”中的"userData"参数值一致。 sessionId 是 String(1-256) 唯一指定一条通话链路的标识ID。 caller 否 String(1-32) 主叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：应答事件的主叫号码为SP设置的来电显示号码（displayNbr）。 called 否 String(1-32) 被叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：应答事件的被叫号码为A号码。 接口示例 POST /status HTTP/1.1 Content-Length: xx {"eventType":"answer","statusInfo":{"sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","timestamp":"2019-01-24 02:49:12","caller":"+86138****0022","called":"+86138****0021"}} 表8 disconnect：挂机事件 参数名称 是否必选 参数类型 说明 timestamp 是 String(1-128) 该呼叫事件发生时语音通话平台的UNIX时间戳。 该参数取值为UTC时间（+8小时为北京时间）格式，即为“yyyy-MM-dd HH:mm:ss”。 userData 否 String(1-256) 用户附属信息，此参数的值与“语音验证码场景API”中的"userData"参数值一致。 sessionId 是 String(1-256) 唯一指定一条通话链路的标识ID。 caller 否 String(1-32) 主叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：挂机事件的主叫号码为SP设置的来电显示号码（displayNbr）。 called 否 String(1-32) 被叫号码。 号码仅支持全局号码格式（包含国家码），比如+86138****7021。 注：挂机事件的被叫号码为A号码。 stateCode 否 Integer 通话挂机的原因值，仅当eventType为disconnect时携带。 取值范围及表示的含义请参考通话挂机原因值说明。 stateDesc 否 String(1-128) 通话挂机的原因值的描述，仅当eventType为disconnect时携带。 接口示例 POST /status HTTP/1.1 Content-Length: xx {"eventType":"disconnect","statusInfo":{"sessionId":"1202_14260_4294967295_20190124024846@callenabler245.huaweicaas.com","timestamp":"2019-01-24 02:49:23","caller":"+86138****0022","called":"+86138****0021","stateCode":0,"stateDesc":"The user releases the call."}}

响应参数 接收到话单通知时，第三方服务器返回200响应，同时若携带表6中的响应参数，系统则会根据resultcode参数值判断是否推送成功。 表6 响应消息参数说明 参数名称 是否必选 参数类型 说明 resultcode 否 String(0-32) 请求返回的结果码。 0为成功 其他均为失败 resultdesc 否 String(0-128) 请求返回的结果描述。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 {"resultcode":"0","resultdesc":"Success"}

使用说明 前提条件 SP在开发应用时，若需订阅话单通知，必须要提供话单接收URL（feeUrl），并且确保URL能够正常处理语音通话平台发送的通知信息。 提供话单接收URL有以下两种方式： 提前通过应用管理向语音通话平台提交话单接收URL。 SP应用调用场景API时，填写feeUrl参数。 注意事项 若平台给SP推送话单后未收到成功响应，视为推送失败，会重新推送话单，直至客户返回成功响应。平台最多重推6次，每次时间间隔1小时。 单个用户（一路呼叫）的话单通知是根据呼叫状态顺序推送的，一通通话会推送一条话单。但同一个应用下，如果多个用户（多路呼叫）的通话结束时间（callEndTime）相同，话单会合并在一起发送，最多不超过50条。 使用限制 语音通话平台推送话单信息给开发者应用，仅支持POST方式。

业务影响 单节点使用率超过85%：无法为新副本分配空间，但是新的主分片仍然可以被分配，从而确保业务操作的连续性不受影响，然而，集群的高可用性上有风险。 单节点使用率超过90%：系统将自动触发分片迁移机制，将该节点上的分片重新分配至磁盘使用率较低的其他数据节点。这一过程可能导致集群暂时无法分配新的分片，进而影响到业务的正常运行，因为分片的迁移和重新分配可能会导致查询延迟增加或临时的服务中断，从而对业务连续性造成影响。 单节点使用率超过95%：系统会对Elasticsearch集群中对应节点里每个索引强制设置“read_only_allow_delete”属性，此时该节点上的所有索引将无法写入数据，只能读取和删除对应索引。 单节点使用率过高，可通过扩容Elasticsearch集群操作动态调整集群节点的数量和容量。新扩容的节点不会立即分配索引，可打开Cerebro看下节点索引分配情况，做进一步观察，也可以修改“indices.recovery.max_bytes_per_sec”和“cluster.routing.allocation.cluster_concurrent_rebalance”两个参数值增加索引分配速度。

解决方案 当新建的索引分片被全部分配在一个node节点上时，有以下2种解决办法： 扩容集群需要新建索引时，按照如下所示设置对应参数。 PUT INDEX_NAME/_settings { "index.routing.allocation.total_shards_per_node": 2 } 即单个索引在每个节点上最多分配2个shards。其中，具体每个节点最多分配多少个shards，请根据集群数据节点个数、索引分片（主、副）的数量自行决定。 如果是shards集中分配在数量过少的节点上导致索引shards分配到同一个节点上，可以使用POST _cluster/reroute的move命令迁移分片到其他节点，rebalance模块会自动分配其他更合适的分片与其交换节点。根据具体业务使用场景可以适当调节balance.index，balance.shard配置。

原因分析 新建索引分片被集中分配于一个node节点上可能有以下原因： 之前索引的分配导致某个节点上的shards数量过少，新建索引shards分配被balance.shard参数主导，为了平衡所有索引的全部分片，将shards集中分配在数量过少的节点上。 节点扩容，当新节点加入时新节点上的shards数量为0，此时集群会自动进行rebalance，但是rebalance需要时间，此时新建索引很容易会被balance.shard参数主导，平衡所有索引的分片，即都分配在新节点上看起来更加平衡。 涉及集群平衡性shard分配主要有两个配置参数： cluster.routing.allocation.balance.index（默认值0.45f） cluster.routing.allocation.balance.shard（默认值0.55f） “balance.index”：值越大，shard分配越倾向于使得每个索引的所有分片在节点上均匀分布，如a索引共有6个shards，数据节点有3个，该配置值倾向于让a索引2、2、2平衡分配。 “balance.shard”：值越大，shard分配越倾向于使得所有分片（所有索引的）在节点上平衡，如索引a有2个shards，索引b有4个shards，该配置倾向于所有6个分片进行2、2、2平衡分配。 balance.index和balance.shard共同负责shards分配。

Elasticsearch和OpenSearch集群支持扩容子网吗？ 在Elasticsearch和OpenSearch集群使用过程中，当现有子网无法满足业务需求时，可以切换子网实现子网扩容。 切换子网后，新子网将用于后续新增节点的操作，包括扩容、添加Master/Client节点、开启终端节点服务，新增节点将通过新子网自动申请并绑定IP地址。 一个集群最多支持同时关联两个子网。 子网切换操作不会影响已有节点的网络配置。 登录 云搜索服务 管理控制台。 选择“集群管理”进入Elasticsearch或OpenSearch集群列表。 单击目标集群的名称，进入集群基本信息页面。 在“当前子网”右侧，单击“切换子网”，在弹窗中选择其他子网，如果没有满足要求的子网，也可以单击“新建子网”，跳转到网络控制台新建子网。 图1 切换子网 修改完成后，单击“确定”启动更改任务。 父主题： CSS 集群管理

使用限制 单账号跟踪的事件可以通过 云审计 控制台查询。多账号的事件只能在账号自己的事件列表页面去查看，或者到组织追踪器配置的OBS桶中查看，也可以到组织追踪器配置的 CTS /system日志流下面去查看。 用户通过云审计控制台只能查询最近7天的操作记录。如果需要查询超过7天的操作记录，您必须配置转储到 对象存储服务 （OBS）或 云日志 服务（LTS），才可在OBS桶或LTS日志组里面查看历史事件信息。否则，您将无法追溯7天以前的操作记录。 云上操作后，1分钟内可以通过云审计控制台查询管理类事件操作记录，5分钟后才可通过云审计控制台查询数据类事件操作记录。 CTS新版事件列表不显示数据类审计事件，您需要在旧版事件列表查看数据类审计事件。 云审计控制台对用户的操作事件日志保留7天，过期自动删除，不支持人工删除。

操作场景 镜像是一种区域性资源，私有镜像归属于其被创建时的区域，如果需要在其他区域使用某一私有镜像，可以通过跨区域复制镜像功能实现。 跨区域复制镜像的典型场景为系统环境多区域部署，以应对系统高可用及国际化的趋势。部署方式通常需要多区域+海外节点部署，快速实现跨区域复制云服务器的方法之一便是通过复制镜像将一个镜像复制到多个区域，然后使用私有镜像快速部署云服务器。如图1所示。 图1 跨区域复制典型场景示意图

背景知识 跨区域复制适用于跨区域部署服务器，或者跨区域备份数据，常和共享镜像结合使用，以达到跨区域跨账号复制镜像的目的。不同场景的使用方式见下表： 场景 说明 操作步骤 跨区域同账号复制 复制完成后，目标区域会生成新的镜像，新镜像具有唯一的ID。 参见本章节。 跨区域跨账号复制 复制镜像到目标区域后，再共享给其他账号使用。 参见本章节和共享指定镜像。 同区域跨账号复制 共享镜像不会生成新的镜像，接受者所看到的镜像和源镜像拥有相同的ID。镜像所有者仍为共享者。 参见共享指定镜像。 跨区域复制整机镜像时，会将关联的云服务器备份或云备份进行复制，因此收取相应 CS BS或CBR的按需费用。 镜像跨区域复制所需的时间与网络速度、镜像大小、并发任务数等因素有关，需要您耐心等待。 支持一次选择多个镜像进行跨区域复制，但是ISO镜像、加密镜像、整机镜像以及状态为“创建中”或“已冻结”的镜像不允许此操作。 跨区域复制需要提供 IAM 委托，该委托必须同时具备目的镜像区域的项目创建权限（IMS Administrator）。 例如：用户想从Region A复制到Region B，则添加的委托必须具备Region B的IMS Administrator的权限。创建IAM委托请参考附：创建IAM委托。

约束与限制 支持系统盘镜像和数据盘镜像跨区域复制的区域，请见下图。 图2 支持跨区域复制镜像的区域 “√”表示支持跨区域复制镜像。 “×”表示不支持跨区域复制镜像，可手动在A区域做镜像导出，再将其导入到B区域。 “-”表示相同区域不涉及跨区域复制镜像。 部分区域变更调整会影响镜像的跨区域复制范围，实际支持的跨区域复制范围，请以控制台界面为准。已注册的老用户跨区域复制不受影响。 图中未包含的区域，不支持跨区域复制系统盘镜像和数据盘镜像。 对于整机镜像，各区域支持的跨区域复制范围存在差异，以控制台界面为准。 对于不支持跨区域复制的情况，您可以使用整机镜像创建云服务器，再分别创建系统盘镜像和数据盘镜像，然后跨区域复制到目标区域，实现整机镜像的跨区域复制功能。 对于使用云服务器备份创建的整机镜像，仅支持对当前区域生成的备份执行跨区域复制操作，不支持对复制操作产生的备份再次执行跨区域复制操作。 如果系统盘镜像和数据盘镜像不支持跨区域复制，整机镜像也不支持跨区域复制。 跨区域复制镜像仅适用于私有镜像。如果您需要复制其他类型的镜像（如公共镜像），可先使用镜像创建云服务器，再使用该云服务器创建私有镜像，然后复制该私有镜像。 私有镜像发布为市场镜像后，不支持跨区域复制。 由市场镜像创建的云服务器所生成的私有镜像（如windows镜像），不支持跨区域复制镜像。 IAM用户如需使用跨区域复制功能，必须具备IAM ReadOnlyAccess权限，并同时具备源区域和目的区域的IMS FullAccess权限。 跨区域复制镜像的大小限制如下： “华南-广州”、“华东-上海一”、“华东-上海二”和“华北-北京四”用于跨区域复制的镜像不能超过300GB；其他区域用于跨区域复制的镜像不能超过128GB。 每个用户只能同时跨区域复制5个镜像。 暂不支持跨区域复制ISO镜像、加密镜像。

附：创建IAM委托 登录管理控制台。 单击右上方登录的用户名，在下拉列表中选择“ 统一身份认证 ”。 在左侧导航栏中，单击“委托”。 在“委托”页面，单击“创建委托”。 在“创建委托”页面，设置如下参数： 委托名称：按需填写，例如“ims_copy_image_agency”。 图5 创建委托 委托类型：选择“云服务”。 云服务：（“委托类型”选择“云服务”时出现此参数项。）在下拉列表中选择“ 镜像服务 IMS"。 持续时间：选择“永久”。 描述：非必选，可以填写“拥有IMS跨区域复制镜像权限的委托”。 单击“完成”，在授权的确认弹窗中，单击“立即授权”。根据镜像类型勾选需要授予委托的权限。 图6 给委托授权 单击“下一步”，选择权限的作用范围，给委托授权。 图7 选择权限作用范围 单击“确定”，委托创建完成。 图8 新创建的委托 授权记录列表中若存在Tenant Administrator或者IMS Administrator系统角色权限，建议您单击“删除”，避免权限过大导致风险问题，IMS服务已提供细粒度的系统策略，建议您配置最小权限。例如：跨区域复制镜像委托权限过大时，建议优化为如下权限： 表1 跨区域复制镜像所需的权限 场景 系统策略名 跨区域复制系统盘镜像和数据盘镜像 IMS CrossCopyAgencyPolicy 跨区域复制整机镜像 IMS CrossCopyAgencyCBRPolicy

事件监控支持的事件列表 表1 镜像服务 事件来源 命名空间 事件名称 事件ID 事件级别 事件说明 处理建议 事件影响 IMS SYS.IMS 创建镜像 createImage 次要 用户创建私有镜像 无 镜像创建完成后，可使用该镜像创建云服务器。 更新镜像 updateImage 次要 用户更新私有镜像元数据 无 更新镜像关键元数据可能导致该镜像创建云服务器失败。 删除镜像 deleteImage 次要 用户删除私有镜像 无 不能使用该镜像创建云服务器。

操作步骤 登录管理控制台。 单击右上方登录的用户名，在下拉列表中选择“统一身份认证”。 在左侧导航栏中，单击“委托”。 在“委托”页面，单击“创建委托”。 在“创建委托”页面，设置如下参数： 委托名称：按需填写，例如“ims_copy_image_agency”。 图1 创建委托 委托类型：选择“云服务”。 云服务：（“委托类型”选择“云服务”时出现此参数项。）在下拉列表中选择“镜像服务IMS"。 持续时间：选择“永久”。 描述：非必选，可以填写“拥有IMS跨区域复制镜像权限的委托”。 单击“完成”，在授权的确认弹窗中，单击“立即授权”。根据镜像类型勾选需要授予委托的权限。 图2 给委托授权 单击“下一步”，选择权限的作用范围，给委托授权。 图3 选择权限作用范围 单击“确定”，委托创建完成。 图4 新创建的委托 授权记录列表中若存在Tenant Administrator或者IMS Administrator系统角色权限，建议您单击“删除”，避免权限过大导致风险问题，IMS服务已提供细粒度的系统策略，建议您配置最小权限。例如：跨区域复制镜像委托权限过大时，建议优化为如下权限： 表1 跨区域复制镜像所需的权限 场景 系统策略名 跨区域复制系统盘镜像和数据盘镜像 IMS CrossCopyAgencyPolicy 跨区域复制整机镜像 IMS CrossCopyAgencyCBRPolicy

相关操作 对新创建的工作项，可以执行以下操作。 表2 工作项基本操作 操作项 说明 查看工作项详情 在工作项列表中，单击目标工作项的标题或编号，可以查看工作项详情。 编辑工作项标题 在工作项列表中，单击目标工作项所在行的，可以编辑工作项标题。 快速新建子工作项 在工作项列表中，单击目标工作项所在行的，可以输入子工作项标题完成快速新建子工作项流程。 Epic/Feature/Story类型工作项下可新建子工作项，Task/Bug类型工作项下不可新建子工作项。 关注工作项 在工作项列表中，单击目标工作项所在行操作栏中的，关注成功后图标变为，再次单击可取消关注。 复制工作项 单击目标工作项右侧下的“复制”，可以将当前工作项复制到目标项目中。 项目内复制仅支持工作项基本信息、自定义字段和项目内附件的复制，跨项目复制仅支持工作项基本信息。 归档工作项 单击目标工作项右侧下的“归档”，可以将当前工作项归档。仅对状态为结束态的工作项才能进行归档。 编辑工作项 在工作项列表中，单击目标工作项所在行的字段值，即可修改编辑对应工作项字段。 在工作项详情页中，单击需要修改工作项对应参数值并保存。 删除工作项 在工作项列表中，单击目标工作项所在行操作栏中的，选择“删除”，可以删除目标工作项及其下的子任务。 在工作项详情页中，单击右上角下的“删除”，可以删除目标工作项及其下的子任务。 Scrum项目工作项的删除为彻底删除，一旦删除后，不可恢复。 批量操作 选择多个工作项，可进行如下操作。 批量复制 项目内复制仅支持工作项基本信息、自定义字段和项目内附件的复制，跨项目复制仅支持工作项基本信息。 批量编辑 批量归档 仅对状态为结束态的工作项才能进行归档。 批量删除 批量导出

相关操作 对新创建的工作项，可以执行以下操作。以下操作针对工作项的列表视图。 表2 工作项基本操作 操作项 说明 快捷编辑工作项 在工作项列表中，单击目标工作项标题右侧的“修改标题”或按快捷键T，可以编辑工作项标题。 在工作项列表中，单击目标工作项标题右侧的“修改处理人”或按快捷键A，可以快捷修改工作项处理人。 在工作项列表中，单击目标工作项标题右侧的“修改为自己”或按快捷键空格，可以将工作项处理人快速修改为自己。 在工作项列表中，单击目标工作项标题右侧的“修改结束日期”或按快捷键D，可以快捷修改工作项的结束日期。 编辑工作项 在工作项列表中，单击目标工作项所在行的字段值，即可修改编辑对应工作项字段。 快速新建子工作项 在工作项列表中，单击目标工作项标题右侧的“新建XX”，可以输入子工作项标题完成快速新建子工作项流程。 最底层工作项层级面板下的工作项不支持新建子工作项。 批量创建子 在工作项列表中，单击目标工作项标题右侧的“批量创建子”，可以输入多条子工作项标题完成快速批量创建子工作项流程。 最底层工作项层级面板下的工作项不支持新建子工作项。 关注工作项 在工作项列表中，单击目标工作项标题右侧的“关注工作项”，关注成功后操作按钮变成“取消关注工作项”，再次单击可取消关注。 复制工作项 在工作项列表中，单击目标工作项标题右侧的“复制工作项”，可以将当前工作项复制到目标项目中，目标项目类型仅支持看板项目。 拆分工作项 当前工作项若分解的不合理，您可以根据需要对其进行拆分。 在工作项列表中，单击目标工作项标题右侧的“拆分工作项”，可以将当前工作项拆分出1个或2个工作项。 设置阻塞 当前工作项研发过程中遇到了风险阻塞，可以将该工作项设为阻塞。 在工作项列表中，单击目标工作项标题右侧的“设为阻塞”，可以选择“阻塞类型”和输入详细说明后，将工作项设为阻塞。 已阻塞工作项不支持更改状态。 已阻塞工作项不支持归档。 归档工作项 在工作项列表中，单击目标工作项标题右侧的“归档工作项”，可以将当前工作项归档。 已归档工作项可在下的“已归档工作项”中查看。 已归档工作项可进行“取消归档”操作。 删除工作项 在工作项列表中，单击目标工作项标题右侧的“删除工作项”，可以删除目标工作项。 工作项删除后，会进回收站。 进入回收站的工作项可以在“回收站”中还原和彻底删除，在回收站中还原后，工作项状态恢复至状态流的第一个状态。

新建文件库 通过知识库主页进入个人文件库。 单击左侧导航个人文件库，进入文件库列表页面。 单击页面中的“新建文件库”，进入新建文件库窗口。 设置名称和公开性，文件库不能重名。 公开性请根据实际情况设置。默认属性为“个人可见”。 单击“确定”。 创建好的文件库显示在列表中。 在文件库列表中，可以根据需要修改名称、并进行分享、收藏或删除操作等。 进入文件库后，单击个人文件库右上角“更多”，可以根据需要查看批量下载记录、分享、收藏或删除文件库。 更多文件操作请参见文件操作。

约束与限制 该解决方案部署前，需 注册华为账号 并开通华为云，完成实名认证，且账号不能处于欠费或冻结状态。如果计费模式选择“包年包月”，请确保账户余额充足以便一键部署资源的时候可以自动支付；或者在一键部署的过程进入费用中心，找到“待支付订单”并手动完成支付。 如果选用IAM委托权限部署资源，请确保使用的华为云账号有IAM的足够权限，具体请参考创建rf_admin_trust委托；如果使用华为主账号或admin用户组下的IAM子账户可不选委托，将采用当前登录用户的权限进行部署。

方案架构 该解决方案帮助您快速部署Dify LLM应用开发平台。 图1 方案架构图（单机部署） 图2 方案架构图（高可用部署） 图3 方案架构图（ 云搜索 ） 该解决方案将会部署如下资源： 云服务器单机部署： 创建1台华为云Flexus云服务器X实例，用于搭建Dify-LLM应用开发平台。 创建1个弹性公网IP EIP并关联FlexusX实例，提供访问公网和被公网访问能力。 创建1个安全组，通过配置安全组规则，为云服务器提供安全防护。

方案优势 成本优化 提供高性价比的云服务器，按需选择资源规格、支持自动扩展，减少资源闲置，优化成本投入，进一步降低客户的运营成本。 高可用性 通过云容器引擎 CCE、云数据库 RDS for PostgreSQL、云搜索服务 CSS OpenSearch部署应用，更好地托管与简化维护应用实例，确保系统的高性能和可扩展性。 一键部署 一键轻松部署，即可完成云服务资源的创建及Dify-LLM应用开发平台的搭建。

Dify配置公网 域名 （单机版） 您需要在域名解析系统中，添加一条A记录，值为Dify服务器的公网IP。本文档以华为云云解析服务 DNS为例。如在华为云购买域名，默认直接添加到公网域名，可供管理华为云域名购买链接：https://www.huaweicloud.com/product/domain.html。如果不是通过华为云购买的域名，可参考创建公网域名。 进入公网域名列表页面，选择要使用的域名，单击“管理解析”。 图46 管理解析 单击“添加记录集”，填写配置信息如下 记录类型：“A – 将域名指向IPv4地址” 主机记录：解析域名的前缀。 例如创建的域名为“example.com”，其“主机记录”设置包括： www：用于网站解析，表示解析的域名为“www.example.com”。 空：用于网站解析，表示解析的域名为“example.com”。 主机记录置为空，还可用于为空头域名“@”添加解析。 abc：用于子域名解析，表示解析的域名为“example.com”的子域名“abc.example.com”。 mail：用于邮箱解析，表示解析的域名为“mail.example.com”。 *：用于泛解析，表示解析的域名为“*.example.com”，匹配“example.com”的所有子域名。 记录值：域名对应的IPv4地址。最多可以输入50个不重复地址，多个地址之间以换行符分隔。本文值为Dify的公网ip地址。 图47 添加记录集 登录弹性云服务 ECS控制台，选择部署Dify的服务器，单击“远程登录”。选择“VNC登录”，输入服务器密码，登录服务器。 图48 远程登录 图49 VNC登录 将SSL证书文件命名为dify.crt、dify.key并上传至：/dify/docker/nginx/ssl 图50 上传SSL证书 修改环境变量，在命令行执行如下命令，解析的域名为步骤二获取，例如www.example.com： sh /dify/docker/configure_dify_domain_name.sh ${解析的域名} 图51 配置环境变量 浏览器即可通过配置的域名访问Dify平台。 图52 访问Dify平台

创建工作流 单击“工作室”，访问dify平台工作室。 图28 工作室 导入工作流。在工作室页面，单击“导入DSL文件”，在弹出的页面中选择“URL”，复制下面的地址，粘贴到DSL URL路径里，如下图所示： https://documentation-samples.obs.cn-north-4.myhuaweicloud.com/solution-as-code-publicbucket/solution-as-code-moudle/building-a-dify-llm-application-development-platform/workflow/DeepSeek_searXNG%E8%81%94%E7%BD%91%E6%90%9C%E7%B4%A2_%E7%9F%A5%E8%AF%86%E5%BA%93.yml 图29 导入工作流 图30 工作流模板 配置知识库。添加知识库：单击“知识检索”节点，单击“+”按钮添加知识库，选择知识库，单击“添加”。 图31 配置知识库 选择联网搜索插件，单击授权按钮，并添加URL。单机版部署填写Dify服务器私网IP：http://{ECS私网IP}:8080；高可用部署填写URL：http://searxng:8080。如下图所示，单击“保存”后，即可设置成功。(ECS私网IP是部署Dify的虚机的内网ip，如连接不通，请检查虚机的安全组是否放通8080端口号）。 图32 授权联网搜索 图33 单机版URL 图34 高可用版URL 调整模型。若大模型处有提示感叹号如下图所示，即表示该模型不存在，需要调整为Dify平台已经添加好的模型。单击大模型名称，在右侧弹窗继续单击模型名称旁边的下拉列表，继续单击模型名称，在下拉列表中选择一个模型即可。其余大模型按照此步骤重复操作即可。 图35 模型不存在提示 图36 替换模型 至此，工作流配置已完成，单击右上角“预览”进行对话。 图37 联网搜索 图38 知识检索

与MaaS服务对接 登录ModelArts Studio 平台，本文以部署华东二的DeepSeek-R1-Distill-Qwen-32B-4K为例。 图4 ModelArts Studio 在ModelArts Studio左侧导航栏中，选择“在线推理”进入“预置服务”服务列表，选择“免费服务”。 图5 免费服务 领取免费调用额度。在免费服务列表，选择所需的服务，单击右侧操作列的“领取额度”。当领取置灰时，表示该服务的免费额度已领取。 图6 领取额度 成功领取后，在免费服务列表，选择所需的服务，单击“调用说明”，在调用弹窗中接口类型选择“OpenAI SDK”获取API地址和模型名称。 图7 调用说明 免费服务中单个模型提供200万token推理额度，额度消耗完后可开通使用商用级别的推理 API服务 （仅限贵阳一），或前往我的服务部署为我的服务后付费使用。 图8 商用服务 图9 调用说明 在调用MaaS部署的模型服务时，需要填写API Key用于接口的鉴权认证。在左侧导航栏，单击“API Key管理”（最多可创建30个密钥。每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥）。 图10 API Key管理 在“API Key管理”页面，单击右上角“创建API Key”，填写标签（自定义API Key的标签，标签具有唯一性，不可重复。仅支持大小写英文字母、数字、下划线、中划线，长度范围为1~100个字符）和描述（自定义API Key的描述，长度范围为1~100个字符）信息后，单击“确定”。标签和描述信息在创建完成后，不支持修改。 图11 创建API Key 对接Dify平台。打开您的Dify平台界面，单击右上角用户名称，下拉并单击“设置”。 进入模型供应商页签，选择OpenAI-API-compatible供应商。 图12 选择供应商 Dify 1.0版本以上，需先安装模型供应商插件再添加模型。 配置模型信息：“模型名称”及“API endpoint URL”填写上述本节步骤4或步骤5“调用说明”中的“模型名称”及“API地址”；"API Key"填写步骤7中创建的API Key，填写完成后单击“保存”。 图13 设置

与一键部署DeepSeek对接 该章节为成功部署快速搭建DeepSeek推理系统解决方案后，将DeepSeek大模型对接至Dify平台时参考使用。 右侧单击用户名称，下拉并单击“设置”。 图14 设置 单击左侧“模型供应商”，在Ollama下单击“添加模型”。 图15 添加Ollama模型 模型名称填写快速部署中选择部署的模型，如“deepseek-r1:7b”，基础URL填写中获取的私网IP地址（如果部署的Dify应用和DeepSeek-R1蒸馏版模型不在同一服务器且不在同一VPC下，需填写DeepSeek-R1蒸馏版模型所在服务器的公网IP），端口号11434（使用公网连接时，模型服务器所在安全组需放通11434端口），单击右下角“保存”并关闭“设置”。 图16 模型配置

安全组规则修改（可选） 该解决方案使用80端口用来访问Dify，默认全放通，请参考修改安全组规则，配置IP地址白名单。 该解决方案使用22端口用来以SSH方式远程登录云服务器，若需远程登录云服务器，请参考修改安全组规则，配置IP地址白名单，以便能正常访问服务。 该解决方案部署成功后，环境初始化预计5-10分钟，受网络、带宽影响，部署时间会有波动部署完成之后方可正常访问。 安全组实际是网络流量访问策略，包括网络流量入方向规则和出方向规则，通过这些规则为安全组内具有相同保护需求并且相互信任的云服务器、云容器、云数据库等实例提供安全保护。 如果您的实例关联的安全组策略无法满足使用需求，比如需要添加、修改、删除某个TCP端口，请参考以下内容进行修改。 添加安全组规则：根据业务使用需求需要开放某个TCP端口，请参考添加安全组规则添加入方向规则，打开指定的TCP端口。 修改安全组规则：安全组规则设置不当会造成严重的安全隐患。您可以参考修改安全组规则，来修改安全组中不合理的规则，保证云服务器等实例的网络安全。 删除安全组规则：当安全组规则入方向、出方向源地址/目的地址有变化时，或者不需要开放某个端口时，您可以参考删除安全组规则进行安全组规则删除。

CCE容器高可用部署 表3 资源和成本规划（按需计费） 华为云服务 配置示例 数量 每月预估花费 虚拟私有云 VPC 区域：华北-北京四 VPC网段：192.168.0.0/16 1 0.00 子网 Subnet 区域：华北-北京四 子网网段：192.168.1.0/24， 192.168.2.0/24， 192.168.3.0/24， 192.168.4.0/24 网关：192.168.0.1， 192.168.1.1，192.168.2.1，192.168.3.1 4 0.00 安全组 SecurityGroup 区域：华北-北京四 4 0.00 华为云Flexus云服务器X实例 按需计费：1.42元/小时 区域：华北-北京四 规格：Flexus云服务器X实例 | 性能模式（关闭）| x1.16u.16g | 16核 | 16 GB 镜像：Ubuntu 22.04 server 64bit 系统盘：高IO | 40GB 数据盘：高IO | 100 GiB 3 3064.18元 华为云Flexus云服务器X实例 按需计费：4.53元/小时 区域：华北-北京四 规格：Flexus云服务器X实例 | 性能模式（开启）| x1e.32u.32g | 32核 | 32 GB 镜像：Ubuntu 22.04 server 64bit 系统盘：通用型SSD | 40GB 1 3262.18元 弹性公网IP EIP 区域：华北-北京四 计费模式：按需计费 线路：动态BGP 公网带宽：按流量计费 带宽大小：300Mbit/s 3 0.80元/GB 对象存储服务 OBS 区域：华北-北京四 存储空间：数据存储（多AZ存储） 默认存储类别：标准存储 桶策略：私有 请求费用：GET/PUT 0.01元/万次，DELETE 免费 存储空间：0.1390元/GB/月 流量费用： 内/公网流入流量（数据上传到OBS）：0元 内网流出流量（通过 ECS云服务器 下载OBS的数据）： 0元公网流出流量 / 00:00-08:00（闲时）：0.2500元/GB 公网流出流量 / 08:00-24:00（忙时）： 0.5000元/GB 1 详细请参考每月账单。计费说明参考价格详情 云容器引擎 CCE 按需计费：2.91元/小时 区域：华北-北京四 计费模式：按需计费 规格：cce.s2.small（50节点） 集群 master 实例数： 3 集群 node 实例数： 3 类型：CCE 1 2095.20元 分布式缓存服务Redis®*版 按需计费：0.58元/小时 区域：华北-北京四 计费模式：按需计费 规格：4G (基础版）| 副本数：2 实例类型：Redis(主备) 1 414.72元 云数据库 RDS for PostgreSQL 按需计费：1.24元/小时 区域：华北-北京四 计费模式：按需计费 规格：rds.pg.n1.large.2.ha | 2 vCPU | 4 GB (通用型） 储存：SSD云盘 | 100GB 数据库引擎：PostgreSQL(主备) 1 892.80元 云搜索服务 CSS 按需计费：3.98元/小时 区域：华北-北京四 计费模式：按需计费 规格： ess.spec-4u8g | 4 vCPUs | 8 GB 节点存储总容量：超高I/O | 120GB 集群类型：OpenSearch 节点数：3 1 2864.16元 弹性负载均衡 ELB 计费模式：按需计费 独享型负载均衡 网络型 | 弹性规格、应用型 | 弹性规格 按需计费：0.25元/小时 区域：华北-北京四 1 180‬元 NAT网关 NAT 按需计费：12元/天 区域：华北-北京四 规格：小型 SNAT规则数：3 1 360元 合计 - - 13133.24元 + 弹性公网IP EIP费用 + 对象存储服务OBS存储及流量费用

创建rf_admin_trust委托（可选） 进入华为云官网，打开控制台管理界面，鼠标移动至个人账号处，打开“统一身份认证”菜单。 图1 控制台管理界面 图2 统一身份认证菜单 进入“委托”菜单，搜索“rf_admin_trust”委托。 图3 委托列表 如果委托存在，则不用执行接下来的创建委托的步骤 如果委托不存在时执行接下来的步骤创建委托 单击步骤2界面中的“创建委托”按钮，在委托名称中输入“rf_admin_trust”，委托类型选择“云服务”，输入“ RFS ”，单击“完成”。 图4 创建委托 单击“立即授权”。 图5 委托授权 在搜索框中输入”Tenant Administrator”并勾选搜索结果，单击“下一步”。 图6 选择策略 选择“所有资源”，并单击“确定”完成配置。 图7 设置最小授权范围 “委托”列表中出现“rf_admin_trust”委托则创建成功。 图8 委托列表

响应示例 状态码：200 nl-query请求返回体。 { "header" : [ { "caption" : "收入", "data_type" : "NUMBER", "level_type" : null, "model_type" : "measure" } ], "data" : [ [ "423xxx214.32" ] ], "sql_text" : "SELECT xxx AS xxx FROM xxx.xxx AS xxx", "insight" : "查询结果: 去年11月公司的收入为xxx。建议探索的方向：xxx。业务建议：xxx。" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务，获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 X-Workspace-Id 是 String 工作空间ID。获取方法请参见获取工作空间ID。 表3 请求Body参数 参数 是否必选 参数类型 描述 subject_id 是 String 智能分析助手ID。 dialog_id 是 String 对话ID。如果不想触发多轮问答能力，需每次调用请求时传入不同的dialog_id。 message_content 是 String 查询问题。 need_insight 否 Boolean 是否需要智能见解。 simplify_response 否 Boolean 是否简化输出结果，默认为False。设置为False的时候查询数据为响应体的query_data部分。设置为True的时候查询数据为响应体的header和data部分。