华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 stream_name 是 String 通道名称。 通道名称由字母、数字、下划线和中划线组成，长度为1～64字符。 partition_count 是 Integer 分区数量。 分区是DIS数据通道的基本吞吐量单位。 stream_type 否 String 通道类型。 COMMON：普通通道，表示1MB带宽。 ADVANCED：高级通道，表示5MB带宽。 data_type 否 String 源数据类型。 BLOB：存储在数据库管理系统中的一组二进制数据。 JSON：一种开放的文件格式，以易读的文字为基础，用来传输由属性值或者序列性的值组成的数据对象。 CS V：纯文本形式存储的表格数据，分隔符默认采用逗号。 缺省值：BLOB。 data_duration 否 Integer 数据保留时长。 取值范围：24~72。 单位：小时。 空表示使用缺省值。 auto_scale_enabled 否 Boolean 是否开启自动扩缩容。 true：开启自动扩缩容。 false：关闭自动扩缩容。 默认不开启。 auto_scale_min_partition_count 否 Long 当自动扩缩容启用时，自动缩容的最小分片数。 auto_scale_max_partition_count 否 Integer 当自动扩缩容启用时，自动扩容的最大分片数。 data_schema 否 String 用于描述用户JSON、CSV格式的源数据结构，采用Avro Schema的语法描述。 csv_properties 否 CSVProperties object CSV 格式数据的相关属性，比如分隔符 delimiter compression_format 否 String 数据的压缩类型，目前支持： snappy gzip zip 默认不压缩。 tags 否 Array of Tag objects 通道标签列表。 sys_tags 否 Array of SysTag objects 通道企业项目列表。 表4 CSVProperties 参数 是否必选 参数类型 描述 delimiter 否 String 数据分隔符。 表5 Tag 参数 是否必选 参数类型 描述 key 否 String 键。 不能为空。 对于同一资源键值唯一。 字符集：A-Z，a-z ， 0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 value 否 String 值。 长度不超过43个字符。 字符集：A-Z，a-z ， 0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。 只能包含数字、字母、中划线“-”、下划线“_”。 表6 SysTag 参数 是否必选 参数类型 描述 key 否 String 键。 不能为空。 值必须为_sys_enterprise_project_id。 value 否 String 值。 对应的是企业项目ID，需要在企业管理页面获取。 36位UUID。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 stream_id 是 String 通道唯一标识符。 principal_id 是 String 授权用户。 如果授权给指定租户，格式为：domainId；如果授权给租户下的指定子用户，则格式为：子用户的domainId； 支持多账号添加，用","隔开，比如：domainId1,domainId2； action_type 是 String 授权操作类型。 putRecords：上传数据。 getRecords：下载数据。 getStreamInfo：通道详情。 effect 是 String 授权影响类型。 accept：允许该授权操作。

请求示例 给租户添加权限策略 POST https://{Endpoint}/v3/{project_id}/streams/{streamName}/policies { "stream_id" : "CiFdELMr0401K9GGZlp", "principal_id" : "domainid1", "action_type" : "putRecords", "effect" : "accept" } 给子用户添加权限策略 POST https://{Endpoint}/v3/{project_id}/streams/{streamName}/policies { "stream_id" : "CiFdELMr0401K9GGZlp", "principal_id" : "domainid1", "action_type" : "putRecords", "effect" : "accept" }

添加转储到 对象存储服务 （OBS）的转储任务 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 CreateTransferTaskRequest request = new CreateTransferTaskRequest(); // 配置通道名称：用户在 数据接入服务 (简称DIS)控制台创建通道 request.setStreamName(streamName); // 添加OBS转储任务，并设置任务名称 OBSDestinationDescriptorRequest descriptor = new OBSDestinationDescriptorRequest(); descriptor.setTransferTaskName(taskName); // 转储至对象存储服务(简称OBS)：OBS桶名和子文件夹名，通过OBS控制台或客户端创建桶和文件夹 descriptor.setObsBucketPath("obs-dis"); descriptor.setFilePrefix("transfertask"); // 转储周期，单位s descriptor.setDeliverTimeInterval(900); // 可选：在DIS管理页面自动创建名称为“dis_admin_agency”的IAM委托，默认采用此委托，用于授权访问。如未创建过IAM委托，请用主账户登录DIS控制台并创建通道，点击“添加转储任务”，前往授权。 descriptor.setAgencyName("dis_admin_agency"); // 可选，转储OBS的目标文件格式：默认text，可配置parquet、carbon descriptor.setDestinationFileType(DestinationFileTypeEnum.TEXT.getType()); // 设置从DIS通道拉取数据时的初始偏移量: 默认LATEST，从通道内最新上传的记录开始读取; TRIM_HORIZON，从通道内最早的未过期记录开始读取 descriptor.setConsumerStrategy(PartitionCursorTypeEnum.LATEST.name()); request.setObsDestinationDescriptor(descriptor);

DIS服务端错误码 在使用SDK进行操作时如果遇到错误，会在控制台显示错误码描述错误信息。 http状态码 错误码 Error Message 说明 处理措施 441 DIS.4100 Authorization error. 使用AKSK生成的签名信息错误 请检查请求头里的签名信息是否无误。 441 DIS.4101 Authorization header cannot be empty. 使用AKSK生成的签名信息为空 请求头里的签名信息为空，检查是否未生成签名信息。 441 DIS.4102 Incorrectly parsed authorization header. 无法解析签名 请检查请求头里的签名信息。 441 DIS.4103 Empty X-Sdk-Date header. 请求头里的X-Sdk-Date字段为空 请检查请求头里的X-Sdk-Date字段并补齐。 441 DIS.4104 Error parsing X-Sdk-Date header. 无法解析请求头里的X-Sdk-Date字段 请检查请求头里的X-Sdk-Date字段并修正。 441 DIS.4105 Invalid X-Sdk-Date header. 请求头里的X-Sdk-Date字段无效 请检查请求头里的X-Sdk-Date字段并修正。 441 DIS.4106 Empty AcessKey header. 请求头里的签名信息Authorization字段中缺失AK 请检查是否传入AK。 441 DIS.4107 Invalid AcessKey header. 请求头里的签名信息Authorization字段中的AK无效 请检查是否传入有效的AK，避免AK填写错误、AK被删除、临时AK过期等。 441 DIS.4108 Empty ServiceName header. 请求头里的签名信息Authorization字段中缺失服务名 请检查请求头里的Authorization字段中是否包含服务名dis。 441 DIS.4109 The Authorization header must contain the following field: {Credential,SignedHeaders,Signature;} 请求头里的签名信息Authorization字段有误 请检查请求头里的Authorization字段是否包含Credential，SignedHeaders, Signature。 441 DIS.4110 Empty Signature header. 请求头里的签名信息Authorization字段中没有SignedHeaders 请检查签名的生成方式是否有误。 441 DIS.4111 Invalid Region header. 请求头里的签名信息Authorization字段中的region无效 请检查是否传入有效的region。 441 DIS.4112 Invalid authorization request. 使用AKSK生成的签名信息错误 请检查签名的生成方式是否有误，检查AK、SK、region等信息。 441 DIS.4113 Empty Token header. 使用token认证时，请求头里的X-Auth-Token为空 请检查请求头里的X-Auth-Token。 441 DIS.4114 Invalid Token header. 使用token认证时，请求头里的X-Auth-Token无效 请检查请求头里的X-Auth-Token是否过期。 403 DIS.4116 Invalid RBAC. 用户操作受限 请根据返回的具体信息判断账号是否未实名认证、欠费、无DIS服务的操作权限等。 400 DIS.4117 Invalid Project Id. 用户传入的projectId无效 请检查传入的projectId是否有效，是否传入了其他project的id。 400 DIS.4200 Invalid request. 用户的请求无效 请参考API文档检查请求。 400 DIS.4201 Invalid partition_id. 用户传入的partition_id无效 请检查partition_id是否无效。 400 DIS.4202 Empty request. 用户的请求为空 请传入有效的请求。 400 DIS.4203 Invalid monitoring period. 查询监控信息的startTime无效 请传入有效的时间戳。 400 DIS.4204 The monitoring period cannot be longer than 7 days. 仅允许查询最近7天内的监控信息 请查询最近7天内的监控信息。 400 DIS.4209 Invalid metrics label. 查询监控信息时，传入的监控指标不合法 请参考API文档检查监控指标并修正。 400 DIS.4215 Invalid cursor type. 获取数据游标时，传入的游标类型cursor-type不合法 请参考API文档检查cursor-type字段的范围并修正。 400 DIS.4216 Invalid sequence_number. 获取数据游标时，传入的序列号starting-sequence-number不合法 请传入有效的starting-sequence-number。 400 DIS.4217 Invalid partition cursor. 从DIS通道下载数据时，传入的数据游标partition-cursor无效 请重新获取partition-cursor并下载数据。 400 DIS.4219 The file is constantly resent. 该文件已经收到了 文件已经收到不需要再上传。 400 DIS.4220 The block whose sequence number is %s needs to be resent. 文件块需要重新上传 请按照指示上传对应的块。 400 DIS.4221 Block seq %s is expected 重复传入相同的文件块 请从系统期待的块开始上传。 400 DIS.4222 Block seq %s is expected. 传入的文件块不连续 从系统期待的块开始上传。 400 DIS.4223 The file size exceeds the limit. 文件的容量超过了DIS的限制 请拆分文件并再上传。 400 DIS.4224 The sequence number is out of range. 获取数据游标时，传入的序列号starting-sequence-number不在有效范围 请传入有效的starting-sequence-number。 400 DIS.4225 Expired partition cursor. 从DIS通道下载数据时，传入的数据游标partition-cursor过期 请重新获取partition-cursor并下载数据。 400 DIS.4226 A partition iterator error occurred or a record to which the SN corresponds has expired. Try to obtain the partition iterator again. 获取数据时，传入的数据游标partition-cursor对应的序列号starting-sequence-number过期 请获取获取数据游标，并用新游标获取数据。 400 DIS.4300 Request error. 请求体错误 请对照API文档修正请求体。 400 DIS.4301 The stream does not exist. 通道不存在 请检查传入的通道是否存在。 400 DIS.4302 The partition does not exist. 通道的分区不存在 请检查用户传入的分区ID是否存在。 400 DIS.4303 Exceeded traffic control limit. 超出流控 请扩容通道或降低上传速率。 400 DIS.4305 Too many stream requests. 同一时间内用户请求太多 请降低请求频率并重试。 400 DIS.4306 The bucket does not exist. 传入的OBS桶不存在 请检查OBS桶是否存在。 400 DIS.4307 The stream already exists. 指定的通道已经存在 请修改通道名称并重新创建通道 400 DIS.4308 Insufficient quota. 通道或分区的配额不足 请释放配额或提工单修改账号的配额。 400 DIS.4309 Too many request failures. Please try again later. ip被加入黑名单 由于频繁的错误访问导致用户ip被加入黑名单，请检查认证信息和请求是否有效，并稍后重试。 400 DIS.4310 OBS access error. 访问OBS失败 请检查用户是否有访问OBS的权限。 400 DIS.4329 app quota exceeded. APP配额超出限制 请释放APP的配额。 400 DIS.4330 app already exist. 已经存在同名的APP 请修改APP名称并重新创建APP。 400 DIS.4331 app is using. 删除app时，当前app在使用中 请确认app是否在使用中，如需删除请停止使用并重新删除。 400 DIS.4332 app not found. 指定的APP不存在 请检查指定的APP名称是否正确 400 DIS.4335 Invalid IAM agency. 创建转储任务时，使用的IAM委托无效 检查DIS创建的dis_admin_agency或用户自定义的IAM委托是否存在，权限是否完整。 400 DIS.4354 The transfer task does not exist. 删除或更新转储任务时，转储任务不存在 请检查转储任务是否存在。 400 DIS.4355 The transfer task already exists. 创建转储任务时，同一个通道下已存在同名的转储任务 请修改新创建转储任务的名称并重新创建。 400 DIS.4357 Exceeded transfer task quota. 单个通道仅允许同时存在5个转储任务，再创建新的转储任务会超出配额限制 请删除废弃的转储任务释放配额。 400 DIS.4358 The stream supports specific transfer tasks. Check the data type of the stream. 小文件转储的通道不支持创建普通转储任务 请创建新的通道并创建转储任务。 400 DIS.4360 Invalid data schema. 创建通道或更新通道时，传入的data_schema无效 请检查data_schema的格式并重试。 400 DIS.4601 The number of resource tags has reached the maximum. 一个资源上最多有10个标签，添加标签时资源上已添加的标签数超出限制 请删除废弃的标签并重新添加标签。 400 DIS.4602 Invalid resource type. 资源类型不合法 请检查资源类型是否合法。 400 DIS.4603 The resource does not exist. 资源不存在 请确认该资源是否已被删除。 400 DIS.4604 The key does not exist. 标签Key不存在 请确认标签Key是否存在。 400 DIS.4605 The action is not supported. 当前标签操作不支持 请确认当前标签操作是否合法，当前仅支持create和delete操作。 500 DIS.5000 System error. 内部服务错误 请联系技术支持。 500 DIS.5100 HBase error. 连接HBase超时、转储查询异常、其他HBase异常 请联系技术支持。 500 DIS.5150 Redis error. Redis连接异常、数据异常、消息广播异常deng 请联系技术支持。 500 DIS.5200 Zookeeper error. Zookeeper异常，创建topic、删除topic、 给topic添加分区时失败 请联系技术支持。 500 DIS.5250 Kafka error. Kafka异常 请联系技术支持。 500 DIS.5251 Kafka create topic timeout. Kafka创建topic超时 请联系技术支持。 500 DIS.5252 Kafka topic does not exist. Kafka连接错误 请联系技术支持。 500 DIS.5380 Kafka Connect error. Kafka连接错误 请联系技术支持。 500 DIS.5400 Resourcemgt error. Resourcemgt服务创建、更新、删除通道错误或新增分区错误 请联系技术支持。 500 DIS.5401 Kafka partition resource exhausts. Kafka分区资源耗尽 请联系技术支持。 500 DIS.5402 Kafka partition resources are about to be exhausted. Kafka分区资源容量即将售罄 请联系技术支持。 500 DIS.5550 Firehose error. 创建文件失败或者传输文件到OBS失败 请联系技术支持。 500 DIS.5600 Service admin account error. 内置租户账号异常 请联系技术支持。 500 DIS.5601 Service op svc account error. 管理租户账号异常 请联系技术支持。 500 DIS.5750 IAM error. 服务内部调用IAM服务异常 请联系技术支持。 500 DIS.5760 CES error. 将指标上载到CES错误 请联系技术支持。 500 DIS.5780 DCS error. Redis链接失败 请联系技术支持。 500 DIS.5850 OBS error. OBS异常 请联系技术支持。 500 DIS.5900 Partition is readonly for DISK is not enough. 磁盘已满，无法写入数据 请联系技术支持。 父主题： 异常信息

查询转储列表 参考初始化DIS客户端的操作初始化一个DIS客户端实例，实例名称为dic。 使用DIS SDK查询指定通道的转储任务列表。 1 2 3 4 ListTransferTasksRquest request = new ListTransferTasksRquest(); // 指定待查询的通道名称 request.setStreamName(streamName); 配置“ListTransferTaskRequest”对象之后，通过调用listTransferTask的方法查询指定通道的转储任务列表。 1 ListTransferTasksResult result = dic.listTransferTasks(request); 查询转储任务列表的返回信息如下。 1 2 3 4 5 6 7 8 9 10 11 12 { "tasks":[ { "destination_type":"OBS", "task_name":"task_qTd9", "create_time":1552355757885, "state":"RUNNING", "last_transfer_timestamp":1552458158527 } ], "total_number":2 } 父主题： 使用SDK（Java）

查询转储详情 参考初始化DIS客户端的操作初始化一个DIS客户端实例，实例名称为dic。 使用DIS SDK查询指定转储任务的详情。 1 2 3 4 5 6 7 DescribeTransferTaskRequest request = new DescribeTransferTaskRequest(); // 指定待查询的通道名称 request.setStreamName(streamName); // 指定待查询的转储任务名称 request.setTransferTaskName(taskName); 配置“DescribeTransferTaskRequest”对象之后，通过调用describeTransferTask的方法查询指定的转储任务详情。 1 DescribeTransferTaskResult result = dic.describeTransferTask(request); 查询转储任务的返回信息如下。 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 { "partitions":[ { "partitionId":"shardId-0000000000", "discard":0, "state":"RUNNING", "last_transfer_timestamp":1552458085454, "last_transfer_offset":56 } ], "stream_name":"dis_test1", "task_name":"task_Ztab", "task_id":"gGGu2WN88XbmRTm64nJ", "destination_type":"OBS", "state":"RUNNING", "create_time":1552457808502, "last_transfer_timestamp":1552458085454, "dli_destination_description":{ "agency_name":"dis_admin_agency", "file_prefix":"OBS", "obs_bucket_path":"dis.test.not.delete", "deliver_time_interval":300, "consumer_strategy":"LATEST" } } 父主题： 使用SDK（Java）

计费方式 DIS提供按需计费和包年包月计费方式供您灵活选择，使用越久越便宜。 按需计费 DIS默认为按需计费方式，即按实际使用的时长收费，以小时为单位，每小时整点结算，不设最低消费标准。 按需计费方式下各计费项的具体价格，请参见产品价格详情。您可以通过DIS提供的价格计算器，根据您的业务诉求，来快速计算出购买DIS的参考价格。 包年包月 您也可以通过包年包月（资源包）的方式，提前购买使用额度和时长，获取更多的优惠。超出资源包的部分自动转按需计费。 各资源包在不同规格及时长下的具体价格，请参见产品价格详情。您可以通过DIS提供的价格计算器，根据您的业务诉求，来快速计算出购买DIS的参考价格。

计费示例 假设用户A的上传流量为5MB/s，单条记录大小为2KB，创建5个普通分区，采用按需计费。这种情况下每小时收费如下； 分区时间费用 分区时间0.1元/小时，5个分区需要：0.1 * 5 = 0.5元。 消息数量费用 上传消息数量0.1元/百万条，每小时上传消息数量为：5MB/s * 1024 / 2KB * 3600秒 = 9.216百万条。因此工具需要：0.1 * 9.216 = 0.9216元。 因此每小时收费总共需要：0.5 + 0.9216 = 1.4216元/小时。

计费项 DIS根据您的消息数量和使用分区时长计费。 表1 计费项信息 计费项 计费说明 消息数量 用户上传至DIS通道的消息数量，下载不计入消息数量。单条消息计量不超过25KB，即用户每次上传的单条数据超过25KB是按多条消息计算，不足25KB时，按单条消息计算。 说明： 只有DIS普通通道涉及此计费因子，高级通道不按消息数量收费，只根据使用分区时长计费。 分区时间 使用分区的时长，时长从创建DIS分区开始计入。普通通道和高级通道的分区使用时长计费标准不同。 普通通道分区使用时长计费详情请参见DIS分区计费。 高级通道分区使用时长计费详情请参见DIS分区计费。

Mac自带邮件客户端绑定华为云 企业邮箱 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。 打开Mac自带邮件客户端，点击“添加账户” 选择 其他“邮件”账户，填写名称、邮箱地址和客户端专有密码。 3. 继续配置，选择 IMAP账户类型（可同步全部邮件数据)，如选择POP类型，只能同步收件箱数据） 收件服务器：imap.sparkspace.huaweicloud.com 发件服务器：smtp.sparkspace.huaweicloud.com *若选择POP账户类型，收件服务器需修改为：pop3.sparkspace.huaweicloud.com 4. 完成配置后，即可使用该客户端收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

Foxmail 7.0 客户端绑定华为云企业邮箱 因为安全升级，不再支持 Foxmail 7.2.17 以下版本 。 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。进入Foxmail客户端，点击菜单栏“工具-系统设置”，选择网络，如代理默认选项为“不使用代理”，可跳转至步骤2配置。反之，需要修改代理为“不使用代理服务器”选项，保存修改后，重启Foxmail，而后进行配置。 在Foxmail窗口右上角单击菜单入口，点击账号管理 点击左下角的新建按钮，弹窗出“新建账号向导”，在弹出页面中填写您的邮箱地址，进入配置页面 邮箱类型建议选择IMAP (可同步全部邮件数据)，如选择POP3类型，只能同步收件箱数据。密码为客户端专有密码，点击下一步。 接收服务器类型建议选择IMAP (可同步全部邮件数据)，如选择POP3类型，只能同步收件箱数据。 接收邮件服务器：imap.sparkspace.huaweicloud.com 端口：993（需勾选“使用SSL来连接服务器”） 发送邮件服务器：smtp.sparkspace.huaweicloud.com 端口：465（需勾选“使用SSL来连接服务器”） 如若选择POP3接收服务器类型，参数如下： POP服务器：pop3.sparkspace.huaweicloud.com 端口：995（需勾选“使用SSL来连接服务器”） 完成配置后，可点击测试验证，测试成功后，即表示绑定成功。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

生成客户端密码 什么是三方客户端安全密码？ 为增强用户在使用三方客户端进行邮件收发的安全性，在用户使用Outlook/Foxmail等三方客户端进行邮件收发时，单独为三方客户端登入华为邮箱账号设置的独立密码，该密码区别于华为邮箱账号密码。 客户端安全密码获取方式： 如需使用第三方邮件客户端（如Outlook、Foxmail等其他邮件App）绑定华为云企业邮箱账号，需生成客户端专用密码后绑定。 企业成员登录邮箱后，在“设置-客户端设置”中生成第三方客户端登录的专用密码，凭此专用密码和邮箱地址在第三方邮件客户端绑定华为邮箱。 2. “生成客户端专用密码”按钮，设置密码名称和密码过期时间（默认永久有效,可自定义过期时间），确认后，系统将随机生成客户端专用密码。 注意：“客户端专用密码仅在生成时展示一次,建议复制并保存到本地后再关闭” 随后即可使用该密码登录任意第三方邮件客户端，无需重复生成。 3. 生成客户端专用密码后，请至第三方邮箱绑定华为云企业邮箱。 4. 忘记密码或想客户端专用密码可进行删除操作。若删除后，则该专用密码将无法登录任意第三方邮件客户端。 绑定第三方邮箱app/客户端的配置信息，如下所示。建议使用IMAP方式配置（可同步全部邮件数据）；POP3仅支持同步收件箱数据： 接收/发送 协议 服务器地址 端口号（无加密） 端口号（SSL加密） 接收邮件 IMAP imap.sparkspace.huaweicloud.com 143 993 POP3 pop3.sparkspace.huaweicloud.com 110 995 发送邮件 SMTP smtp.sparkspace.huaweicloud.com 25 465

网易邮箱大师客户端绑定华为云企业邮箱 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。随后打开网易邮箱大师客户端，进入邮箱设置，点击添加邮箱，即可看到登录弹窗，输入邮箱地址后，会出现“服务器配置”，点击服务器配置。 进入服务器设置页面，填写相关配置信息。协议建议选择IMAP (可同步全部邮件数据)，如选择POP3类型，只能同步收件箱数据。 如选择IMAP协议，配置信息如下： 收信服务器：imap.sparkspace.huaweicloud.com 端口：993（加密：需选择SSL/TLS） 发送服务器：smtp.sparkspace.huaweicloud.com 端口：465（加密：需选择SSL/TLS） 收信服务器和发件服务器下方的账号都填写邮箱地址，密码都为客户端专有密码。配置完成后，即可使用。 如若选择POP3接收服务器类型，需修改协议与收件服务器外，其他同IMAP协议配置： POP服务器：pop3.sparkspace.huaweicloud.com 端口：995（加密：需选择SSL/TLS） 服务器备份，建议服务器邮件不自动删除，否则服务器上的邮件可能会定期自动删除。 3. 完成配置后，即可使用该客户端收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

Outlook 2019 客户端绑定华为云企业邮箱 因为安全升级，不再支持 outlook 2013及以下版本。 客户端绑定引导视频： 1. 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。 打开outlook客户端， 点击“文件”菜单，账户信息下，点击添加账户，输入邮箱地址，高级选项下方展开，勾选“让我手动设置我的账户” 2. 建议选择IMAP (可同步全部邮件数据)，如选择POP3类型，只能同步收件箱数据。 接收邮件服务器：imap.sparkspace.huaweicloud.com 端口：993 (加密方法：SSL/TLS） 待发邮件服务器：smtp.sparkspace.huaweicloud.com 端口：465 (加密方法：SSL/TLS） 若选择POP类型，则接收邮件服务器需修改为如下： 接收邮件服务器：pop3.sparkspace.huaweicloud.com 端口：995 (加密方法：SSL/TLS） 3. 设置完成后，需输入邮箱密码（客户端专有密码），即可完成配置绑定。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

Welink(蓝版) App绑定华为云企业邮箱 1. 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。下方以Welink为例，提供绑定华为云企业邮箱参考。 2. 打开Welink App, 点击下方“业务”菜单，进入“邮件”业务（如未出现在日常办公栏目中，可搜索“邮件”业务进入）。随后进入登录邮箱界面，输入邮箱地址和客户端专有密码，点击登录 3. 界面提示“未配置邮箱服务器”，点击“配置服务器”，进入配置界面，协议建议选择IMAP (可同步全部邮件数据)，如选择POP3类型，只能同步收件箱数据。 输入邮箱地址，密码请输入客户端专有密码。 接收服务器（IMAP）：imap.sparkspace.huaweicloud.com 安全类型：SSL/TLS 端口为：993 **如若选择POP3服务器，则接收服务器和端口需修改为如下参数： 接收服务器（POP3）：pop3.sparkspace.huaweicloud.com 安全类型：SSL/TLS 端口为：995 发送服务器（SMTP）：smtp.sparkspace.huaweicloud.com 安全类型：SSL/TLS 端口为：465 4. 完成配置后，即为绑定成功，可使用Welink收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

移动端IOS 自带邮件应用绑定华为云企业邮箱 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。下方以手机端iOS16系统为例，提供绑定华为云企业邮箱参考。 进入“设置-邮件-账户-添加账户” 3. 添加账户，请选择“其他”账户，添加邮件账户，输入邮件地址，密码为客户端专有密码 4. 进入新账户配置页面，协议建议选择IMAP (可同步全部邮件数据)，如选择POP类型，只能同步收件箱数据。电子邮件与用户名请输入邮箱地址，密码请输入客户端专有密码。 如选择IMAP协议，收件服务器主机名为imap.sparkspace.huaweicloud.com 发件服务器主机为 smtp.sparkspace.huaweicloud.com 如若选择POP类型，收件服务器主机名为 pop3.sparkspace.huaweicloud.com 5. 完成配置后，即可使用该客户端收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

使用第三方邮件客户端配置华为云企业邮箱解决方案 Foxmail Foxmail 7.2 客户端绑定华为云企业邮箱 Foxmail 7.0 客户端绑定华为云企业邮箱 Outlook Outlook 2019 客户端绑定华为云企业邮箱 Mac Mac自带邮件客户端绑定华为云企业邮箱 Windows 自带邮件 Windows 10 自带邮件绑定华为云企业邮箱 Window7系统绑定第三方客户端使用SSL加密端口报错解决方案 网易邮箱大师 网易邮箱大师绑定华为云企业邮箱 手机等移动端 移动端IOS 自带邮件应用绑定华为云企业邮箱 移动端IOS Outlook App绑定华为云企业邮箱 移动端Android 自带邮件应用绑定华为云企业邮箱 Wlink Welink(蓝版) App绑定华为云企业邮箱 企业微信 企业微信App绑定华为云企业邮箱 钉钉 钉钉App绑定华为云企业邮箱 Foxmail 7.2 客户端绑定华为云企业邮箱 Foxmail 7.0 客户端绑定华为云企业邮箱 Outlook 2019 客户端绑定华为云企业邮箱 Mac自带邮件客户端绑定华为云企业邮箱 Windows 10 自带邮件绑定华为云企业邮箱 window7系统绑定第三方客户端使用SSL加密端口报错解决方案 网易邮箱大师客户端绑定华为云企业邮箱 QQ邮箱客户端绑定华为云企业邮箱 移动端IOS 自带邮件应用绑定华为云企业邮箱 移动端IOS Outlook App绑定华为云企业邮箱 移动端Android 自带邮件应用绑定华为云企业邮箱 Welink(蓝版) App绑定华为云企业邮箱 企业微信App绑定华为云企业邮箱 钉钉App绑定华为云企业邮箱

移动端Android 自带邮件应用绑定华为云企业邮箱 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。下方以手机端Android系统为例，提供绑定华为云企业邮箱参考。 打开手机自带邮件app, 选择添加账户-其他，输入邮箱地址和客户端专有密码，点击手动设置，账户类型建议选择IMAP (可同步全部邮件数据)，如选择POP3类型，只能同步收件箱数据。 用户名请输入邮箱地址，密码请输入客户端专有密码。 IMAP服务器为：imap.sparkspace.huaweicloud.com 端口：993 （安全类型需选择SSL/TLS） 输入完成后，点击下一步 **如若选择POP3服务器，则服务器和端口需修改为如下参数： POP服务器：pop3.sparkspace.huaweicloud.com 端口为995 （安全类型需选择SSL/TLS） SMTP服务器为：smtp.sparkspace.huaweicloud.com 端口：465（安全类型需选择SSL/TLS） 用户名请输入邮箱地址，密码请输入客户端专有密码。 5. 完成配置后，即可使用该客户端收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

Foxmail 7.2 客户端绑定华为云企业邮箱 因为安全升级，不再支持 Foxmail 7.2.17 以下版本。 客户端绑定引导视频： 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。随后进入Foxmail客户端，在Foxmail窗口右上角单击菜单入口，点击账号管理 点击左下角的新建按钮，弹窗出“新建账号”，点击手动设置，在弹出页面中填写您的邮箱地址和密码，进入配置页面。 接收服务器类型建议选择IMAP (可同步全部邮件数据)，如选择POP3类型，只能同步收件箱数据。 邮件账号为邮箱地址，密码为客户端专有密码。 （1）对于国内用户： 邮件账号为邮箱地址，密码为客户端专有密码。 IMAP 服务器：imap.sparkspace.huaweicloud.com 端口：993 (需勾选SSL） SMTP服务器：smtp.sparkspace.huaweicloud.com 端口：465 (需勾选SSL） 如若选择POP3接收服务器类型，参数如下： POP服务器：pop3.sparkspace.huaweicloud.com 端口：995（需勾选SSL） （2）对于海外用户： 邮件账号为邮箱地址，密码为客户端专有密码。 IMAP 服务器：imap-global.sparkspace.huaweicloud.com 端口：993 (需勾选SSL） SMTP服务器：smtp-global.sparkspace.huaweicloud.com 端口：465 (需勾选SSL） 如若选择POP3接收服务器类型，参数如下： POP服务器：pop3-global.sparkspace.huaweicloud.com 端口：995（需勾选SSL） 完成配置后，即可使用该客户端收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

企业微信App绑定华为云企业邮箱 1. 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。下方以企业微信App为例，提供绑定华为云企业邮箱参考。 2. 打开企业微信app, 点击下方“邮件”菜单，输入邮箱地址和客户端专有密码，点击添加，同意授权 3. 需要完善邮箱信息，默认类型为IMAP (可同步全部邮件数据，建议选择IMAP)，如选择POP3类型，只能同步收件箱数据，具体填写信息如下： 账号和用户名请输入邮箱地址，密码请输入客户端专有密码。 收件服务器为：imap.sparkspace.huaweicloud.com 端口为：993 需开启SSL 发件服务器为：smtp.sparkspace.huaweicloud.com 端口为：465 需开启SSL **如若选择POP3类型，则收件服务器和端口需修改为如下参数： 收件服务器（POP类型）：pop3.sparkspace.huaweicloud.com 端口为：995 需开启SSL 4. 完成配置后，即为绑定成功，可使用企业微信内的邮箱收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

移动端IOS Outlook App绑定华为云企业邮箱 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。下方为iOS16系统, Outlook App绑定华为云企业邮箱配置参考。 进入Outlook App设置菜单-添加邮件账户-添加电子邮件账户，输入邮箱地址（可登录用户端查看右上角账户信息，则为您的邮件地址） 2. 请选择IMAP (可同步全部邮件数据) 3. 请填写配置信息：输入邮箱地址， IMAP主机名：imap.sparkspace.huaweicloud.com 端口信息： 993 （端口安全性：SSL），如下所示。 用户名输入邮箱地址即可，IMAP密码为之前生成的客户端专有密码。 SMTP配置信息如下 主机名：smtp.sparkspace.huaweicloud.com 端口信息： 465 （端口安全性：SSL） 用户名输入邮箱地址即可，SMTP密码为之前生成的客户端专有密码,同IMAP密码。 4. 确认填写无误后，则可登录使用。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

Windows 10 自带邮件绑定华为云企业邮箱 1.绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。 打开Windows10 自带邮件客户端 点击左下角设置，右侧弹出设置弹窗，点击管理账户，进入“添加用户”界面，点击高级设置 2. 高级设置，选择Internet电子邮件， 3. 进入配置页面，填写邮箱地址和客户端专有密码，需要用于传入电子邮件的SSL为必选项；已停止支持非安全端口邮箱协议通信。 账户类型建议选择IMAP 4(可同步全部邮件数据)，如选择POP3类型，只能同步收件箱数据。 如选择IMAP4，填写下方配置信息： 传入电子邮件服务器：imap.sparkspace.huaweicloud.com 传出（SMTP）电子邮件服务器：smtp.sparkspace.huaweicloud.com 如若账户类型选择POP3，则需修改传入电子邮件服务器为：pop3.sparkspace.huaweicloud.com 4. 完成配置后，即可使用该客户端收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

钉钉App绑定华为云企业邮箱 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端密码（可参考第三方客户端绑定专有密码生成）。下方以钉钉App为例，提供绑定华为云企业邮箱参考。 打开钉钉app, 进入邮箱，点击上方“收件箱”后，展开菜单，点击左下方“设置”图标 进入设置界面，点击添加账号，点击选择“其它邮箱”， 进入登录邮箱页面，点击右上角的“手动配置”，进入配置页 填写服务器设置相关信息，具体填写信息如下： 用户名请输入邮箱地址，密码请输入客户端专有密码。 收件服务器为：imap.sparkspace.huaweicloud.com 端口为993 需开启SSL 发件服务器为：smtp.sparkspace.huaweicloud.com 端口为465 需开启SSL 6. 完成配置后，即为绑定成功，可使用钉钉内的邮箱收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

QQ邮箱客户端绑定华为云企业邮箱 QQ邮箱客户端绑定华为云企业邮箱 绑定账号前，请确保已在邮箱设置-客户端设置，生成客户端专有密码（可参考第三方客户端绑定专有密码生成） 客户端专用密码只在生成时可见，且只显示一次，请生成后立即复制保存，以便后续第三方客户端登录。 随后打开QQ邮箱客户端，选择其他邮箱。（如果之前已添加过邮箱，点击右上角加号 – 设置 – 添加账号，选择其他邮箱） 输入邮箱账号（输入您完整的华为云企业邮箱账号如：****@company.com）及客户端专有密码，输入完成后，点击下一步。 进入服务器设置页面，填写相关配置信息。协议建议选择IMAP (可同步全部邮件数据)，如选择POP3类型，只能同步收件箱数据。 如选择IMAP协议，配置信息如下： 收信服务器：imap.sparkspace.huaweicloud.com 端口：993（加密：需选择SSL/TLS） 发信服务器：smtp.sparkspace.huaweicloud.com 端口：465（加密：需选择SSL/TLS） 账号及用户名均填写邮箱地址（输入您完整的华为云企业邮箱账号如：****@company.com），密码为客户端专有密码。配置完成后，即可使用。 如选择POP3类型，配置信息如下： 收信服务器：pop3.sparkspace.huaweicloud.com 端口：995（加密：需选择SSL/TLS） 发信服务器：smtp.sparkspace.huaweicloud.com 端口：465（加密：需选择SSL/TLS） 点击右上角完成/登录，完成配置后，即可使用该客户端收发邮件。 父主题： 使用第三方邮件客户端配置华为云企业邮箱解决方案

响应示例 返回状态码为200：操作成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为400：请求参数错误。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 PUT /restconf/v2/data/huawei-ac-nes-device:nes/ne/00000000-0000-0000-0000-000000000000/huawei-nce-e-ifm:interface/10GE0%2F0%2F0 HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy restconf-transaction-id: "00000000-0000-0000-0000-000000000000" { "huawei-nce-e-ifm:interface" : [ { "config-status" : "configured-database-success", "last-committed-time" : "2022-01-01 00:00:00", "related-pkg-version" : "1.0.1", "edit-state" : "RUNNING", "name" : "10GE0/0/0", "ifm-class" : "main-interface", "type" : "10GE", "parent-if-name" : "10GE0/0/0", "number" : "0/0/0", "level" : "L3", "vpn-instance" : "vpn1", "admin-status" : "down", "description" : "the interface for underlay", "bandwidth" : { "bandwidth" : 20, "bandwidth-kbps" : 20 }, "trunk" : { "members" : [ { "interface-name" : "10GE0/0/0" } ] }, "ethernet" : { "negotiation-mode" : "enabled", "combo-mode" : "copper", "duplex" : "full", "speed" : "1000M" } } ] }

请求参数 表2 header参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 restconf-transaction-id 否 string - - 事务ID。 "00000000-0000-0000-0000-000000000000" 表3 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 huawei-nce-e-ifm:interface 是 REFERENCE 详细请参见表4。 接口配置参数。 -

URI /restconf/v2/data/huawei-ac-nes-device:nes/ne/{id}/huawei-nce-e-ifm:interface/{name} 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 是 string 36个字符。满足正则表达[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}。 - 设备ID。 "00000000-0000-0000-0000-000000000000" name 是 string 1~63个字符。 - 接口名称。名称规则：接口类别为主接口时，由物理类型、接口号拼接而成，如GE0/0/0、LoopBack1，接口类别为子接口时，由父接口名称、英文点、接口号拼接而成，如GE0/0/0.1、LoopBack1.1，单一主键字段。 "10GE0/0/0"

响应示例 返回状态码为200：查询设备信息成功，响应体参考GetDeviceResponseBean。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "success", "pageIndex" : 1, "pageSize" : 20, "totalRecords" : 2, "data" : [ { "id" : "b473118d-17ff-4f4f-9fa9-a4c0e1e87e42", "name" : "AR1", "esn" : "2102351BTJ0000000666", "deviceModel" : "AR161EW", "deviceType" : "AR", "status" : "0", "siteId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "mac" : "xx-xx-xx-xx-xx-xx", "ip" : "192.168.0.10", "manageIp" : "192.168.0.10", "neType" : "AR161EW", "version" : "V300R003C00", "vendor" : "HUAWEI", "description" : "HUAWEI", "resourceId" : "HUAWEI", "tenantId" : "ea25fdbf-8dee-4823-bac2-5bfe8e3359ca", "tenantName" : "tenant@huawei.com", "siteName" : "test1", "createTime" : "2017-12-13 01:37:28", "registerTime" : "2017-12-13 01:37:28", "modifyTime" : "2017-12-13 01:37:28", "startupTime" : "2017-12-13 01:37:28", "tags" : ["AP01"], "systemIp" : "192.168.1.1", "patchVersion" : "V200R019SPH", "ztpConfirm" : false, "manageStatus" : "ABNORMAL", "manageStatusDownReason" : ["NEED_ZTP_CONFIRM","DEVICE_HAS_BEEN_ISOLATED"], "role" : ["Gateway"], "performance" : 0, "uptime" : "0 天 1 时 10 分" } ] } 返回状态码为400：参数错误。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：服务内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive