华为云用户手册

示例 建立一个名为cursor1的游标： 1 CURSOR cursor1 FOR SELECT * FROM tpcds.customer_address ORDER BY 1; 建立一个名为cursor2的游标： 1 CURSOR cursor2 FOR VALUES(1,2),(0,3) ORDER BY 1; WITH HOLD游标的使用示例。 开启事务： 1 START TRANSACTION; 创建一个with hold游标： 1 DECLARE cursor3 CURSOR WITH HOLD FOR SELECT * FROM tpcds.customer_address ORDER BY 1; 抓取头2行到游标cursor3里： 1 2 3 4 5 6 FETCH FORWARD 2 FROM cursor3; ca_address_sk | ca_address_id | ca_street_number | ca_street_name | ca_street_type | ca_suite_number | ca_city | ca_county | ca_state | ca_zip | ca_country | ca_gmt_offset | ca_location_type ---------------+------------------+------------------+--------------------+-----------------+-----------------+-----------------+-----------------+----------+------------+---------------+---------------+---------------------- 1 | AAAAAAAABAAAAAAA | 18 | Jackson | Parkway | Suite 280 | Fairfield | Maricopa County | AZ | 86192 | United States | -7.00 | condo 2 | AAAAAAAACAAAAAAA | 362 | Washington 6th | RD | Suite 80 | Fairview | Taos County | NM | 85709 | United States | -7.00 | condo (2 rows) 结束事务： 1 END; 抓取下一行到游标cursor3里： 1 2 3 4 5 FETCH FORWARD 1 FROM cursor3; ca_address_sk | ca_address_id | ca_street_number | ca_street_name | ca_street_type | ca_suite_number | ca_city | ca_county | ca_state | ca_zip | ca_country | ca_gmt_offset | ca_location_type ---------------+------------------+------------------+--------------------+-----------------+-----------------+-----------------+-----------------+----------+------------+---------------+---------------+---------------------- 3 | AAAAAAAADAAAAAAA | 585 | Dogwood Washington | Circle | Suite Q | Pleasant Valley | York County | PA | 12477 | United States | -5.00 | single family (1 row) 关闭游标： 1 CLOSE cursor3;

参数说明 cursor_name 将要创建的游标名。 取值范围：遵循数据库对象命名规范。 BINARY 指明游标以二进制而不是文本格式返回数据。 NO SCROLL 声明游标检索数据行的方式。 NO SCROLL：声明该游标不能用于以倒序的方式检索数据行。 未声明：根据执行计划的不同，自动判断该游标是否可以用于以倒序的方式检索数据行。 WITH HOLD | WITHOUT HOLD 声明当创建游标的事务结束后，游标是否能继续使用。 WITH HOLD：声明该游标在创建它的事务结束后仍可继续使用。 WITHOUT HOLD：声明该游标在创建它的事务之外不能再继续使用，此游标将在事务结束时被自动关闭。 如果不指定WITH HOLD或WITHOUT HOLD，默认行为是WITHOUT HOLD。 query 使用SELECT或VALUES子句指定游标返回的行。 取值范围：SELECT或VALUES子句。

操作场景 为了提高网站联系方式准确率，2020年8月17日起，所有省份的用户在提交备案申请（“取消接入”备案类型除外）后，还需完成工信部短信核验，备案申请才能进入管局审核。具体流程如下： 初审通过后，华为云备案专员转交备案申请至管局。 华为云发送短信，给备案信息中填写的互联网信息服务负责人， 注册华为账号 时填写的手机号码，告知备案信息已提交管局审核。 工信部发送验证码给备案负责人。 不同的备案类型，发送的备案负责人有差异。 一般在收到华为云通知短信后5分钟内，即可收到工信部的短信。 备案负责人收到验证码后，需在 24 小时内访问工信部官网进行验证。 本节主要介绍指导您在收到验证码后如何进行短信核验。

验证码发送原则 验证码仅发送至备案信息中填写的主体负责人、互联网信息服务负责人手机号码中，具体以实际为准。 备案类型 备案服务 核验对象 备注 新增备案 网站备案 主体负责人 互联网负责人 全部需验证通过。 若主体负责人与互联网信息服务负责人手机号为同一人，只发送一个验证码（判断标准为手机号码）。 网站、App备案 主体负责人 互联网负责人 App负责人不进行短信核验 App备案 主体负责人 无 新增互联网 网站备案 主体负责人 互联网负责人 系统会自动识别是否需要上报主体变更信息 （上报了主体变更信息，管局系统则判定为需要变更主体信息，需主体负责人进行短信核验） 网站、App备案 主体负责人 互联网负责人 App备案 主体负责人 无 新增接入 仅新增接入 无 互联网负责人 无 新增接入同时变更互联网信息 无 互联网负责人 新增接入同时主体信息 主体负责人 互联网负责人 新增接入同时主体信息与互联网信息 主体负责人 互联网负责人 变更备案 仅主体变更 主体负责人 无 主体、互联网均变更 主体负责人 互联网负责人 互联网信息变更 无 互联网负责人 变更主体 不涉及变更省份 主体负责人 无 涉及变更所在省份 无 无 变更服务 无 无 互联网负责人 变更接入 无 无 无 网站迁移 无 无 无 注销主体 / 主体负责人 无 注销互联网 / 无 互联网负责人 取消接入 / 无 无 备案信息提交管局审核后，5分钟左右即可收到验证短信。如没有收到，您也可以登录工信部网站，手动重新发送验证短信，系统最多可以重发3次短信验证码。 具体操作指导请参见短信重发操作步骤。 验证码为6位数字，请谨慎输入。连续5次输入错误短信核验的任意信息，在第6次输入验证时系统将自动退回您的备案申请。 验证码发送号码为12381或106**********12381。为保证顺利收到短信通知，建议您不要设置短信拦截功能。

ICP备案结果 备案申请提交管局系统后，管局审核时长一般为3~20个工作日，管局审核结果将以短信及邮件形式通知您，如您的ICP备案申请被驳回，您可登录华为云备案管理系统查看驳回原因排查问题，并根据当地管局的ICP备案规则修改信息后，重新提交ICP备案订单。详情请参见备案驳回FAQ。 管局审核通过后，审核信息需要一段时间才能同步到华为云备案管理系统，若您备案的为网站，在此期间，您可以设置 域名 解析。 设置域名解析，将您的域名指向华为云服务器并开通网站访问。 域名解析设置，请参见启用解析 使用华为云DNS服务的域名可以通过“启用解析”设置域名解析。 使用非华为云DNS服务解析的域名，需前往域名的DNS服务商设置域名解析。

ICP备案进度 审核结果 对应的订单状态 状态说明 需要执行的操作 通过 待提交管局 表示您提交的备案订单已通过初审，等待华为云备案专员提交备案资料至当地管局进行审核，如图1待提交管局所示。 - 待管局审核 表示您提交的备案订单已通过初审，华为云备案专员已将订单提交至管局审核，如图2待管局审核所示。 - 驳回 初审驳回 表示华为云备案专员已审核订单，发现提交的备案申请信息不正确（如真实性核验不通过、网站内容存在违规），不满足网站备案相关要求，如图3初审驳回所示。 请单击“状态”栏的查看初审不通过的原因，并单击“继续备案”修改备案申请，然后重新提交初审。 初审驳回的常见原因与解决方法：请参见初审驳回。 待完善资料 接入商审核为待修改 表示华为云备案专员已审核订单，发现提交的备案申请缺失材料、或填写的信息不完整，不完全满足网站备案相关要求，如图4接入商审核为待修改所示。 请单击“状态”栏的查看审核意见，并单击“去修改信息”进一步完善备案申请，然后重新提交接入商审核。 提交后，订单状态更新为“已修改待审核”。 图1 待提交管局 图2 待管局审核 图3 初审驳回 图4 接入商审核为待修改

场景二：账号下有备案信息 产品验证完成后，点击下一步。 查看主体单位信息，如主体信息有变更请重新上传证件，将鼠标放置在原有营业执照上，”点击修改”进行替换，系统会自动识别并改正。 备案省市、主办单位性质、证件类型不支持修改 图4 主体单位信息 查看主体负责人信息，请根据备案实际情况选择主体负责人信息。 如选择已有主体负责人信息。 请核对负责人信息是否正确，如信息有变化请重新上传证件，将鼠标放置在原有证件上，”点击修改”进行替换，系统会自动识别并改正。 核实联系方式是否有效，如需要变更请进行验证。 已有主体负责人信息证件类型不支持修改 图5 已有主体负责人信息 如选择新的主体负责人。 请您按照您的证件选择证件类型，并上传证件，系统会自动识别您的身份信息。 图6 填写新负责人信息 请填写负责人真实有效的联系方式并进行验证。 验证完成后，请点击”下一步”。 图7 填写新负责人信息

场景一：账号下无备案信息 填写主体信息。 按提示填写本次备案的主体信息，参数说明如表1所示。 表1 主体信息参数说明 类别 参数 要求 主办单位信息 单位名称 企业：请填写真实有效的单位名称（与营业执照保持一致） 个人：请填写个人身份有效证件上的姓名。 即主体信息，备案的主体信息应与域名持有者信息保持一致。 个人备案：备案负责人信息与域名注册人实名认证信息需保持一致，包括姓名、证件类型、证件号码。 单位备案：备案主体信息（主办单位名称或主体负责人）与域名注册人（域名持有者）实名认证信息需保持一致，包括主办单位名称、证件类型、证件号码。 说明： 如果域名注册人（域名持有者）实名认证信息与备案主体信息（主办单位名称或主体负责人）不一致时，即域名注册者为公司股东、单位主要负责人或高级管理人员，可提供相关证明材料上传至备案系统。 相关链接： 个人备案与单位备案FAQ 修改域名所有者 域名已备案，证件未备案 证件住址 企业：请填写真实有效的单位证件住址（与营业执照中保持一致） 个人：请填写个人身份有效证件上的地址。 通讯地址：请按实际的办公地址填写，该地址需要与证件签发地、备案地所属同一地域。 主办单位负责人信息 证件类型：请选择主体负责人个人有效证件。 选择对应的证件上传彩色扫描件，扫描件要求请参见电子版证件资料要求。 即主体负责人信息，一般情况下必须填写法定代表人。 同一个法定代表人有多家公司需要备案时，法定代表人的联系方式需保持一致。 部分省市的管局要求，主体负责人的手机号码归属地需要与备案选择的地域保持一致。如果不一致，请更换其他号码使用，并确保：手机号码真实、有效，为本人所有；手机号码的归属地可查询。 相关链接： 主体负责人必须为法人吗？ 办公电话问题 备案联系方式填写要求 负责人姓名：请填写个人身份有效证件上的姓名。 证件号码：系统会根据上传的证件自动识别证件号码，请检查号码的正确性。 证件是否长期有效：请按实际情况选择。 证件有效期起始日期：如果证件类型选择身份证，请填写负责人的个人身份证上的起止日期。若身份证件是长期。根据国徽面身份证有效期年限选择身份证有效期的截止日期。 手机号：请填写真实联系电话，并确保电话畅通。主体负责人手机号码将用于接收工信部备案结果的通知，请准确填写。 应急电话：必须真实、有效，且是备案主体长期使用的号码，不能填写其他公司的电话。 请确保填写的应急电话唯一，没有重复给其他单位备案使用过。 电子邮件地址：请填写主体负责人真实、有效的邮箱地址。主体负责人邮箱将用于接收工信部备案结果的通知以及备案密码的发放，请准确填写。 请确保填写的邮箱地址唯一，没有重复给其他单位备案使用过。 通讯地址信息。 企业：请填写实际的办公住址信息； 个人：住所居住地。 图1 通讯地址信息 主体负责人信息 请您勾选主体负责人是否为法人，个别省份要求备案时主体负责人必须为法人，如不是需提供主体负责人授权书，可参考管局规则。 请您按照您的证件选择证件类型，并上传证件，系统会自动识别您的身份信息。 图2 主体负责人信息 联系方式 请填写负责人真实有效的联系方式并进行验证。 验证完成后，请点击”下一步”。 若当前不方便获取验证码信息，可在备案订单提交初审之前方便接收验证码的时候进行验证 图3 联系方式

ICP备案后 开通互联网信息服务 ICP备案成功后，您可以开通开通互联网信息服务，以便正常访问。例如：如果您使用了E CS 实例，可以将ECS实例的公网IP地址加入域名进行解析后，通过域名访问该网站。具体操作，请参见添加解析记录。 添加ICP备案号及版权所有 ICP备案成功后，您需要在互联网信息服务底部悬挂备案号和跳转至工信部的链接，以便访问者查询确认ICP备案信息。部分省份管局要求，例如江苏省，需要在互联网信息服务下方添加版权所有。详情请参见添加ICP备案号和版权处理。 公安联网备案 依据 《计算机信息网络国际联网安全保护管理办法》相关规定，各互联网信息服务需在开通之日起30日内登录全国互联网安全管理服务平台提交公安联网备案申请。详情请参见公安备案信息填写。

ICP备案流程操作 填写基础信息 在华为云备案管理系统中，根据界面提示，按要求填写主办单位信息和互联网信息服务等，系统将根据您所填信息，自动校验是否可以进行ICP备案。 您使用App端进行首次备案或新增互联网信息服务（原备案不在华为云）等ICP备案申请时，在此步骤还需根据实际情况上传主办单位证件。 详细介绍及操作指导请参见主体信息填写。 填写主办者信息 填写ICP备案主办单位的真实信息。 详细介绍及操作指导请参见主体负责人信息填写。 填写互联网信息服务 填写网站或App信息以及网站或App负责人的真实信息。 详细介绍及操作指导请参见填写网站信息和填写App信息。 上传资料及真实性核验 拍摄真实有效、彩色的证件材料（原件）照片并上传，且上传部分资料时需同步进行 人脸识别 完成真实性核验。 详细介绍及操作指导请参见上传资料及真实性核验。 ICP备案初审 您提交ICP备案申请后，审核专员会对您提交的备案信息进行初步审核，备案审核相关请参见步骤二：华为云初审。 工信部短信核验 根据工信部最新要求，自2020年8月17日起，各省市进行ICP备案申请时需通过工信部备案管理系统进行短信核验，需进行短信核验的ICP备案类型请参见备案短信核验。 管局审核 初审完成后，华为云备案审核专员会将ICP备案申请提交至对应管局处做最终的管局审核。管局审核通过后您的备案即已完成，审核结果会发送至您的手机和邮箱，详情请参见步骤五：ICP备案进度及结果查询。

ICP备案操作步骤 ICP备案前准备 注册账号：ICP备案前您需要注册一个华为云账号，用于申请ICP备案和后续维护ICP备案信息。详细信息请参见注册华为云账号并登录华为云备案系统。 域名准备：ICP备案前需完成域名注册及域名实名认证，并检查您的域名是否符合ICP备案要求。详细信息请参见准备可备案域名。 域名实名认证、修改/过户完成后，需要约三天时间将实名认证信息入库管局。建议您在实名认证完成后至少等待三天再申请ICP备案，避免管局审核时无法获取最新域名实名认证信息。 服务器准备：购买华为云华为云中国大陆节点服务器。详细信息请参见准备可备案的服务器。 ICP备案所需资料：主体为个人和单位所需资料不同。更多信息，请参见准备备案材料。 前置审批：部分特殊行业的互联网信息服务，需联系当地机关办理对应的前置审批手续。各类行业对应的办理机关及手续类型请参见前置审批。 管局规则：了解ICP备案所在地域的管局规则，根据管局要求准备ICP备案的材料。详细信息请在各地区管局备案规则中单击对应省份查看。

ICP备案类型 系统会自动验证您的备案类型，无需手动选择。 首次备案 首次备案即同时新增主体和互联网信息服务，包括网站首次备案和App首次备案。 首次备案：互联网信息服务的主体和域名从未办理过ICP备案，在互联网信息服务开通服务前，您需通过华为云ICP代备案系统完成ICP备案。 新增备案 新增备案，即新增互联网信息服务。 新增互联网信息服务（原备案在华为云）：主体已在华为云办理过备案，且已经备案成功，现要新增互联网信息服务，则需进行新增互联网信息服务（原备案在华为云）操作。 新增互联网信息服务（原备案不在华为云）：主体没有在华为云办理过备案，而是在其他接入商办理的备案，且已经备案成功。现购买了华为云大陆节点服务器，需要在华为云办理新增互联网信息服务，则需要进行新增互联网信息服务（原备案不在华为云）操作。 接入备案 接入备案：主体和域名均已通过其他服务商成功备案，现需要将服务商变更为华为云或将华为云添加为该互联网信息服务的新增服务商，需要在华为云接入备案，以便正常访问部署在华为云服务器的互联网信息服务。 新增接入不会影响您在其他接入商的备案信息，一个网站或App可备案在多家接入商。 接入备案期间，如原备案的IP资源有效可继续解析访问，不会影响原业务的正常使用。接入备案成功后，即可解析到华为云对应IP。 接入备案是完整接入网站或App原备案的所有域名，如个别域名已过期，需续费或先注销后才能申请接入。

上传资料 根据页面提示上传证件照片或证件彩色扫描件。 主体信息资料、互联网信息资料的详细介绍，请参见准备备案材料。 前置审批文件：需要提供前置审批文件的行业，请参见前置审批。 域名证书：请参见域名证书如何获取。 广东管局《互联网信息服务备案承诺书》：根据广东省通信管理局要求，自2021年6月21日起，所有提交至广东省管局的ICP备案申请（非经营性互联网信息服务备案），均需要签署《互联网信息服务备案承诺书》。详情请参见互联网信息服务备案承诺书。 其他证件：请根据企业经营范围判断网站是否涉及其他证件的上传，如不涉及，不需要上传。 更多关于上传资料的常见问题，请参见上传资料与真实性核验。

场景一：账号下无备案信息 在App端登录华为云备案小程序。 下载华为云App。 您可在各大应用市场或扫描下方二维码下载华为云App，如果已下载华为云App请将App升级至最新版本。 图7 下载华为云App 登录华为云App，在“控制台”中或者在搜索“ICP备案”，单击“ICP备案”，进入备案操作入口。 图8 登录控制台 验证备案类型 查看备案流程，并单击“开始备案”。 如果存在正在备案中的订单，无法重复提交备案申请。请先根据提示继续完成正在进行中的备案，或放弃备案订单，然后再开始备案。 图9 备案办理流程 在“验证备案类型”页面，按提示填写信息，然后单击“验证备案类型”。 系统将根据填写的域名、证件等，自动校验备案类型。更多内容，请参见验证备案类型注意事项。 图10 验证备案类型 表2 验证备案类型参数说明 参数 说明 地域 对于个人备案，请根据您的身份证所在地、或实际居住地选择备案提交的地域。是否允许跨省备案，需以各地管局要求为准。 对于单位备案，请根据主体证件签发地（如营业执照工商注册地），选择备案提交的地域。不能选择非企业主体证件签发地的省份。 主办单位性质 请按照实际单位性质进行选择。 如：企业法定代表人请选择“企业”，事业法定代表人请选择“事业单位”。 其中，个人备案与单位备案的介绍，请参见个人备案与单位备案FAQ。 主办单位名称 请输入主办单位名称。 证件类型 请根据主办单位性质，选择正确的证件类型。 证件号码 请输入主办单位证件号码。 资源类型 请选择需要备案的对应云服务， 如选择ECS，需为包周期且不小于3个月。备案资源请参考：可备案服务器资源 如使用备案授权码，请到“授权码管理”中申请。如何获取及使用“备案授权码”，具体请参考如何获取及使用“备案授权码”。 按需 购买云服务器 ，暂不支持备案。 服务类型 网站备案请选择网站。 App备案请选择App。 域名/App名称 网站备案请填写需备案的域名，格式如：huaweicloud.com 注意： 首次备案、新增网站请先前往域名的DNS服务商处关闭解析： 如果您的域名使用的是华为云DNS，可以通过“暂停解析”停止域名解析。 如果您的域名使用的非华为云DNS，需前往域名的DNS服务商停止域名解析。 备案结束后，重新启用域名解析即可。 App备案请填写需备案的App名称。 判断是否需要“认领备案”。 如果系统检测到您填写的域名和主体信息已在“原华为云备案系统”备案过，将提示您认领备案。 在其他接入商处进行迁移互联网信息服务或跨省变更操作后，需进行认领备案。 如图11所示。此时，请先执行认领备案，然后再继续履行备案申请。 图11 认领备案 如果系统提示您进行产品验证，说明不需要认领备案，请继续执行。 填写ICP备案申请。 产品验证。 资源类型：选择用于备案的服务器，并单击“验证”。如果提示没有可用资源，请购买服务器，详情请参见准备可备案服务器。 表3 资源类型参数说明 云服务类型 说明 相关链接 ECS 使用弹性云服务器（含华为云Flexus应用服务器（X实例））备案时，选择“ECS”。 弹性云服务器（含华为云Flexus应用服务器（X实例））需包月3个月及以上（包含多次续费后累计时长）。如果不满足条件，系统无法搜索到对应资源。 一台服务器是否可以多次办理备案 什么是“用于备案的资源” 为什么提示“备案授权码无效” 提示“用于备案的资源已达最大使用次数”怎么办 如何获取及使用备案授权码 准备可备案服务器 备案授权码 如需使用跨账号的资源备案，请选择“备案授权码”。“包年包月”购买弹性云服务器的，可生成备案授权码。 备案授权码：请输入备案授权码。每个备案授权码可以备案一个网站，不能重复使用。 企业门户 使用企业门户产品备案时，选择“企业门户”。 企业门户，需包月3个月及以上（包含多次续费后累计时长）。 一个企业门户支持备案3个域名。 专享客户 详情请参见如何申请为备案“专享客户”。 专属云 使用专属云备案时，选择“专属云”。 选择云服务：专属云需包年1年及以上。如果不满足条件，系统无法搜索到对应资源。 NAT网关 使用“公网NAT网关”备案时，选择“NAT网关”。 选择云服务：公网NAT网关需包月3个月及以上。如果不满足条件，系统无法搜索到对应资源。 图12 产品验证

场景一：账号下无备案信息 在PC端登录华为云备案系统。 图1 登录备案系统 填写主体信息。 选择“地域”。 企业：企业备案地域需与营业执照所在地保持一致 个人：个人备案地域建议您与证件住址保持一致。 个别省份不支持异地备案或异地备案需提供居住证等证明材料，请参考各地区管局规则。 系统弹窗提示下载并使用华为云App备案。 为了缩短备案时间，提高备案效率，华为云推出App备案方式，让您在手机端即可完成ICP备案。华为云App备案支持证件智能识别和人脸识别能，电子化的核验方式让流程更简单，备案更便捷。 如需切换使用App备案，请扫描下方二维码，下载华为云App执行后续操作。 如需继续使用PC备案，请单击右上角的或者右下角的“关闭”按钮。 图2 推荐您使用华为云App备案 填写主体单位信息 请您上传您的备案证件，系统会自动识别您的证件信息并录入。 系统将根据填写的域名、证件等，自动校验备案类型。更多内容，请参见验证备案类型注意事项。 表1 表1 验证备案类型参数说明 参数 说明 地域 对于个人备案，请根据您的身份证所在地、或实际居住地选择备案提交的地域。是否允许跨省备案，需以各地管局要求为准。 对于单位备案，请根据主体证件签发地（如营业执照工商注册地），选择备案提交的地域。不能选择非企业主体证件签发地的省份。 主办单位性质 请按照实际单位性质进行选择。 如：企业法定代表人请选择“企业”，事业法定代表人请选择“事业单位”。 其中，个人备案与单位备案的介绍，请参见个人备案与单位备案FAQ。 主办单位名称 请输入主办单位名称。 证件类型 请根据主办单位性质，选择正确的证件类型。 证件号码 请输入主办单位证件号码。 资源类型 请选择需要备案的对应云服务， 如选择ECS，需为包周期且不小于3个月。备案资源请参考：可备案服务器资源 如使用备案授权码，请到“授权码管理”中申请。如何获取及使用“备案授权码”，具体请参考如何获取及使用“备案授权码”。 按需购买云服务器，暂不支持备案。如何将“按需计费”的ECS切换为“包年/包月”计费模式，请参见：按需转包年/包月。 互联网信息服务类型 网站备案请选择网站。 App备案请选择App。 域名/App名称 网站备案请填写需备案的域名，格式如：huaweicloud.com 注意： 首次备案、新增网站请先前往域名的DNS服务商处关闭解析： 如果您的域名使用的是华为云DNS，可以通过“暂停解析”停止域名解析。 如果您的域名使用的非华为云DNS，需前往域名的DNS服务商停止域名解析。 备案结束后，重新启用域名解析即可。 App备案请填写需备案的App名称。 判断是否需要“认领备案”。 如果系统检测到您填写的域名和主体信息已在“原华为云备案系统”备案过，将提示您认领备案。 在其他接入商处进行迁移互联网信息服务或跨省变更操作后，需进行认领备案。 如图 认领备案所示。此时，请先执行认领备案，然后再继续履行备案申请。 图3 认领备案 如果系统提示您进行产品验证，说明不需要认领备案，请继续执行。 3. 产品验证。 互联网信息服务类型：网站备案请选择网站，App备案请选择App。 域名/App名称：网站备案请填写需备案的域名，格式如huaweicloud.com。App备案请填写需备案的App名称。 资源类型：请选择需要备案的对应云服务。 如选择ECS，需为包周期且不小于3个月。备案资源请参考：可备案服务器资源 如使用备案授权码，请到“授权码管理”中申请。如何获取及使用“备案授权码”，具体请参考如何获取及使用“备案授权码”。 按需购买云服务器，暂不支持备案。 填写完成后，点击验证。 图4 验证产品信息

操作场景 不同状态的备案订单，修改备案申请的操作不同，具体如下： 暂未提交初审的备案订单 如需修改订单中填写的备案信息、资料，请参见本节内容。 已提交接入商初审，暂未提交至管局审核的备案订单 如需修改订单中填写的备案信息、资料，需先撤销备案，然后再参见本节内容进行修改。 初审驳回/管局驳回的备案订单 如需修改订单中填写的备案信息、资料，请参见本节内容。 管局审核中的备案订单 不支持撤销、修改。 已备案成功并获取备案号的网站 如需更改服务器IP地址、修改应急电话、更新营业执照地址等，请参见变更备案，修改备案信息。

网站信息填写规范 网站名称：个人网站、企业网站名称的具体要求，请参见网站名称要求。 网站IP：备案服务器的公网IP地址。 您可以登录华为云控制台，查询备案资源的公网IP地址。如果是使用备案授权码备案，需填写生成备案授权码的弹性云服务器公网IP地址。 如果只有一个IP地址，请参见单个IP怎么填写IP地址段起始。 网站服务内容：网站内容必须与主办单位性质相符。 服务类型：默认展示“网站”。 网站语言：指网站内容使用的主要语言。请根据实际情况进行选择，不建议多选。 示例：网站内容的主要语言为中文，部分插件为英文，此时“语言”选择“中文”。 前置审批内容：若包含“前置或专项审批内容类型”中的项目，请上传相关许可证件或咨询备案所在省主管部门。若不包含相关类型内容，前置审批项不填。 备注：请填写备案审核通过后，网站实际开办的内容。 互联网信息服务负责人信息：指备案系统网站信息中的负责人，也是网站的主要负责人，单位备案必须为单位内员工，可填法定代表人或单位内其他网站建设管理者；个人备案必须为备案主体本人。 如果互联网信息服务负责人和主体负责人是同一个人，请勾选“选择已有负责人”。反之，请勾选“填写新负责人”，并填写互联网信息服务负责人信息，此时互联网信息服务负责人和主体负责人的电话、邮箱不能相同。详情请参见备案联系方式填写要求。 互联网信息服务负责人可以不是公司法定代表人。具体请参见互联网信息服务负责人必须为法人吗？ 如需添加多个网站，在一个网站信息填写完后，“保存并添加新互联网信息”或者查看互联网信息的时候点击旁边的“继续添加互联网信息”】。更多请参见多域名如何提交备案。

初审进度 1.确保填写信息准确无误，且真实性核验通过后，勾选“我已阅读并同意《信息安全承诺书》、《协助修改备案在线服务条款》和《互联网信息服务备案承诺书》”，单击“提交初审”。 建议您真实性核验通过后在PC端提交初审，PC端备案订单填写页面可刷新信息。 2.备案信息提交后，备案专员将在1-2个工作日内进行初审，并以短信及邮件形式通知审核结果。 审核期间我们会拨打您备案信息中的联系电话进行沟通，请保持电话畅通。 如涉及备案信息修改，系统将以邮件形式发送至您在备案系统注册的邮箱，邮件内容可能包含：问题点修改建议、备案申请期间注意事项，以及需要补充哪些资料等重要信息，请注意查收并按指导安排处理。 初审通过后，华为云备案审核专员会将备案申请提交至对应管局处做最终的管局审核。 华为云初审： 您提交系统信息后，华为云会在1-2个工作日内为您初步审核，初审通过后整理备案信息和材料提交至管局审核。 提交管局后，备案申请中预留的联系方式将收到短信、邮件通知。 父主题： 步骤二：华为云初审

接口示例 请求示例 POST /rest/httpsessions/callStop/v2.0 HTTP/1.1 content-type: application/json;charset=UTF-8 authorization: AKSK realm="SDP",profile="UsernameToken",type="Appkey" x-aksk: UsernameToken Username="ZRBRz4bAXoFgEH7o4Ew308eXc1RA",PasswordDigest="****",Nonce="ac1c911c4792492687f8f6b2264a491e",Created="2018-05-26T00:35:30Z" content-length:xx { "sessionid":"1200_366_0_20161228102743@callenabler.home1.com", "signal":"call_stop" } 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 { "resultcode":"0", "resultdesc":"Success" }

请求参数 表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-SHA256 (Password，Nonce + Created))生成。其中，Password为APP_Secret的值。Nonce、Created、Password直接进行字符串拼接即可，无需包含+号和空格。 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参数说明 参数名称 是否必选 参数类型 默认值 说明 sessionid 是 String(1-256) 无 该参数用于唯一标识一路通话。 signal 是 String(1-128) 无 该参数值指定终止呼叫的方式，目前signal的取值仅固定为“call_stop”，表示主被叫都拆线。

结果码 请根据以下结果码进行调测，如果有疑问，可联系管理员进行确认。 表6 结果码说明 响应码 结果码 英文描述 中文描述 处理方法 200 0 Success. 成功。 无需处理。 400 1023006 Authorization not contained in the HTTP header. 鉴权失败，请检查鉴权请求正确性。 请检查消息头中是否携带了Authorization，PasswordDigest字段填写是否正确，携带的app_key填写是否正确，且生成随机数的时间与发送请求时的本地时间不能相差太大。 1023007 realm not contained in Authorization. Authorization字段中未找到realm属性。 请检查Authorization字段中的是否携带了realm属性。 1023008 profile not contained in Authorization. Authorization字段中未找到profile属性。 请检查Authorization字段中的是否携带了profile属性。 1023009 The value of realm in Authorization must be SDP. Authorization中realm属性值应该为“SDP”。 请检查Authorization字段中的realm属性值是否为“SDP”。 1023010 The value of profile in Authorization must be UsernameToken. Authorization中profile属性值应该为“UsernameToken”。 请检查Authorization字段中的profile属性值是否为“UsernameToken”。 1023011 The value of type in Authorization must be app_key. Authorization中type属性值应该为“Appkey”。 请检查Authorization字段中的type属性值是否为“Appkey”。 1023012 type not contained in Authorization. Authorization字段中未找到type属性。 请检查Authorization字段中是否携带了type属性。 1023033 HTTP header not found X-AKSK field. HTTP头未找到X-AKSK字段。 请检查HTTP消息头中是否携带了X-AKSK字段。 1023034 UserName not contained in X-AKSK. X-AKSK字段中未找到UserName属性。 请检查X-AKSK字段中的是否携带了Username属性。 1023035 Nonce not contained in X-AKSK. X-AKSK字段中未找到Nonce属性。 请检查X-AKSK字段中的是否携带了Nonce属性。 1023036 Created not contained in X-AKSK. X-AKSK字段中未找到Created属性。 请检查X-AKSK字段中的是否携带了Created属性。 1023037 PasswordDigest not contained in X-AKSK. X-AKSK字段中未找到PasswordDigest属性。 请检查X-AKSK字段中的是否携带了PasswordDigest属性。 1023038 UsernameToken not contained in X-AKSK. X-AKSK中没有携带UsernameToken。 请检查X-AKSK字段中的是否携带了UsernameToken属性。 401 1010010 Invalid digest. PasswordDigest校验失败。 请检查PasswordDigest字段填写是否正确。 1010013 Time out limit. 时间超出限制。 请确认X-AKSK鉴权时，生成随机数的时间与发送请求时的本地时间不能相差太大（具体差值请与管理员确认）。 403 1010002 Invalid request. 非法请求。 检查请求携带的参数格式是否都合法。 1010003 Invalid app_key. 无效的app_key。 检查请求携带的app_key是否填写正确，app_key从应用管理页面获取，若填写正确，请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010006 Invalid Rest API. 无效的Rest API。 检查请求方法填写是否正确。 1010008 The status of the app_key is unavailable. app_key被暂停使用。 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010009 No more APIs can be invoked. API达到调用上限。 请稍等一分钟后再试，并联系管理员申请更高的应用使用配额。 1010010 The flow control upper limit is reached on the platform. 平台达到系统流控上限。 请稍等一分钟后再试。 1010011 The app is not allowed to access a commercial address. APP没有访问商用地址的权限。 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1020166 The app client ip is not in ip white list. 请求发送方app IP不在白名单列表中。 联系管理员检查IP白名单是否配置正确。 1020176 Authentication failed, try again later 鉴权失败，稍后重试 IP因鉴权失败次数过多导致被拉黑，请30分钟后重试，或联系管理员放通该IP。 500 1010001 Internal system error. 系统错误。 请联系管理员处理。 1020001 Parameter error. 参数错误。 检查请求携带的参数格式是否都合法。 1020002 Internal error. 内部错误。 请联系管理员处理。 1020150 The app_key is invalid. appKey无效。 检查请求携带的app_key是否填写正确，app_key从应用管理页面获取，若填写正确，请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1020152 Invalid sessionid. sessionid无效。 检查请求携带的sessionid是否填写正确。语音回呼的sessionid是调用“语音回呼场景API”的成功响应消息的sessionid参数值，也可通过呼叫状态和话单通知API获取。 1023001 Internal error. 内部错误。 请联系管理员处理。 1023002 Response timeout. 响应超时。 重新发送一次请求，若依然返回响应超时，请联系管理员处理。

接口示例 请求示例 POST /rest/httpsessions/callVerify/v1.0 HTTP/1.1 content-type: application/json;charset=UTF-8 authorization: AKSK realm="SDP",profile="UsernameToken",type="Appkey" x-aksk: UsernameToken Username="ZRBRz4bAXoFgEH7o4Ew308eXc1RA",PasswordDigest="****",Nonce="ac1c911c4792492687f8f6b2264a491e",Created="2018-05-26T00:35:30Z" content-length:xx { "displayNbr":"+8675528****88", "calleeNbr":"+86189****0007", "languageType":2, "preTone":"welcome.wav", "verifyCode":"12345678", "times":3, "userData":"cwgtest" } 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 { "resultcode":"0", "resultdesc":"Success", "sessionId":"1200_366_0_20161228102743@callenabler.home1.com" }

结果码 请根据以下结果码进行调测，如果有疑问，可联系管理员进行确认。 表6 结果码说明 响应码 结果码 英文描述 中文描述 处理方法 200 0 Success. 成功。 无需处理。 400 1023006 Authorization not contained in the HTTP header. 鉴权失败，请检查鉴权请求正确性。 请检查消息头中是否携带了Authorization，PasswordDigest字段填写是否正确，携带的app_key填写是否正确，且生成随机数的时间与发送请求时的本地时间不能相差太大。 1023007 realm not contained in Authorization. Authorization字段中未找到realm属性。 请检查Authorization字段中的是否携带了realm属性。 1023008 profile not contained in Authorization. Authorization字段中未找到profile属性。 请检查Authorization字段中的是否携带了profile属性。 1023009 The value of realm in Authorization must be SDP. Authorization中realm属性值应该为“SDP”。 请检查Authorization字段中的realm属性值是否为“SDP”。 1023010 The value of profile in Authorization must be UsernameToken. Authorization中profile属性值应该为“UsernameToken”。 请检查Authorization字段中的profile属性值是否为“UsernameToken”。 1023011 The value of type in Authorization must be app_key. Authorization中type属性值应该为“Appkey”。 请检查Authorization字段中的type属性值是否为“Appkey”。 1023012 type not contained in Authorization. Authorization字段中未找到type属性。 请检查Authorization字段中是否携带了type属性。 1023033 HTTP header not found X-AKSK field. HTTP头未找到X-AKSK字段。 请检查HTTP消息头中是否携带了X-AKSK字段。 1023034 UserName not contained in X-AKSK. X-AKSK字段中未找到UserName属性。 请检查X-AKSK字段中的是否携带了Username属性。 1023035 Nonce not contained in X-AKSK. X-AKSK字段中未找到Nonce属性。 请检查X-AKSK字段中的是否携带了Nonce属性。 1023036 Created not contained in X-AKSK. X-AKSK字段中未找到Created属性。 请检查X-AKSK字段中的是否携带了Created属性。 1023037 PasswordDigest not contained in X-AKSK. X-AKSK字段中未找到PasswordDigest属性。 请检查X-AKSK字段中的是否携带了PasswordDigest属性。 1023038 UsernameToken not contained in X-AKSK. X-AKSK中没有携带UsernameToken。 请检查X-AKSK字段中的是否携带了UsernameToken属性。 401 1010010 Invalid digest. PasswordDigest校验失败。 请检查PasswordDigest字段填写是否正确。 1010013 Time out limit. 时间超出限制。 请确认X-AKSK鉴权时，生成随机数的时间与发送请求时的本地时间不能相差太大（具体差值请与管理员确认） 403 1010002 Invalid request. 非法请求。 检查请求携带的参数格式是否都合法。 1010003 Invalid app_key. 无效的app_key。 检查请求携带的app_key是否填写正确，app_key从应用管理页面获取，若填写正确，请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010006 Invalid Rest API. 无效的Rest API。 检查请求方法填写是否正确。 1010008 The status of the app_key is unavailable. app_key被暂停使用。 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010009 No more APIs can be invoked. API达到调用上限。 请稍等一分钟后再试，并联系管理员申请更高的应用使用配额。 1010010 The flow control upper limit is reached on the platform. 平台达到系统流控上限。 请稍等一分钟后再试。 1010011 The app is not allowed to access a commercial address. APP没有访问商用地址的权限。 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010021 Application unavailable. 应用不可用。 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010023 Invalid display number. 号显号码不合法。 检查displayNbr和displayCalleeNbr参数的填写是否合法，与号码管理页面的“固话号码”保持一致。若合法，请确认该号码是否已申请并下发。申请号码在号码订购页面申请，号码下发后可在号码管理页面查看。 1010024 Invalid caller number. 主叫号码不合法。 检查callerNbr参数的填写是否合法。 1010040 The app_key is not allowed to invoke the API. app_key没有调用本API的权限。 请联系管理员确认该app_key对应的应用是否具语音验证码能力。 1012001 Resource of number is not to be applied. 资源未申请。 app_key和业务号码未绑定。 1012006 The service number is not applied. 业务号码未申请。 请确认是否申请业务号码。 1012012 Application does not open recording function. 应用未开启录音功能。 请在应用管理页面确认请求携带的app_key是否开启了录音功能。 1013001 Calls exceed the SP limit. 请求次数超过SP配置上限。 请和管理员确认开发者呼叫数量限制。 1013002 Calls exceed the APP limit. 请求次数超过应用配置上限。 请和管理员确认应用呼叫数量限制。 1013003 Calls exceed the display number limit. SP的主显号码受限。 请和管理员确认显示号码呼叫数量限制。 1013004 Callee in blacklist. 被叫用户是黑名单。 被叫号码在运营商黑名单库。 1013010 Caller in blacklist. 主叫用户是黑名单。 主叫号码在运营商黑名单库。 1013011 Callee is not on the whitelist. 被叫用户不在白名单中。 请和管理员确认被叫号码白名单限制。 1013100 Common error code . 未知错误。 请和管理员确认安全管控限制。 1013101 Abnormal call restricted . 呼叫行为异常。 请和管理员确认安全管控限制。 1013111 International callin is forbidden. 国际呼入限制。 请检查请求的号码格式是否为国际号码格式。 1013112 International callout is forbidden. 国际呼出限制。 请检查请求的号码格式是否为国际号码格式。 1013113 Abnormal call duration restricted. 通话时间异常。 请检查请求的号码是否通话时间异常。 1013115 Abnormal call completion rate restricted. 呼叫接通率异常。 请检查请求的号码是否呼叫接通率异常。 1013116 Caller call frequency restricted. 主叫呼叫频次限制。 请检查主叫号码是否有呼叫频次限制。 1013117 Callee call frequency restricted. 被叫呼叫频次限制。 请检查被叫号码是否有呼叫频次限制。 1013118 Service number call frequency restricted. 业务号码呼叫频次限制。 请检查业务号码是否有呼叫频次限制。 1013119 Service number suspend. 业务号码被暂停。 请和管理员确认号码状态。 1013120 Ip address is null. IPv4地址未携带。 请客户接口携带请求发送方IPv4地址。 1013121 Call black time forbidden. 呼叫时段限制。 呼叫时段为休息时段，请工作时段再呼叫。 1013122 Sub enterprise is suspended. 子企业已被暂停。 查看是否因投诉被下线，可查看订购号码时填写的邮箱是否有业务下线通知邮件。 1020165 The number of app_key voice call ports exceeds the upper limit. 超出语音呼叫端口数限制。 请稍等一分钟后再试。建议联系管理员为该应用申请更多的端口配额。 1020166 The app client ip is not in ip white list. 请求发送方app IP不在白名单列表中。 运营商IP地域管控，此地区无法呼通。 1020168 The call is rejected because the login IP of the peer app is blacklisted . 请求发送方app登录IP是黑名单。 运营商IP地域管控，此地区无法呼通。 1020171 The call is rejected because the login IP of the peer app is blacklisted area. 请求发送方app登录IP在受限地域。 运营商IP地域管控，此地区无法呼通。 1020176 Authentication failed, try again later 鉴权失败，稍后重试。 IP因鉴权失败次数过多导致被拉黑，请30分钟后重试，或联系管理员放通该IP。 500 1010001 Internal system error. 系统错误。 请联系管理员处理。 1020001 Parameter error. 参数错误。 检查请求携带的参数格式是否都合法。 1020002 Internal error. 内部错误。 请联系管理员处理。 1020150 The app_key is invalid. app_key无效。 检查请求携带的app_key是否填写正确，app_key从应用管理页面获取，若填写正确，请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1020151 The bindNum is invalid. 业务号码无效。 业务号码无效，请联系管理员处理。 1020154 Insufficient voice ports. 语音端口不足。 请稍等一分钟后再试，并联系管理员申请扩容语音端口。 1023001 Internal error. 内部错误。 请联系管理员处理。 1023002 Response timeout. 响应超时。 重新发送一次请求。

响应参数 表5 响应消息参数说明 参数名称 是否必选 参数类型 默认值 说明 resultcode 是 String(1-32) 无 请求返回的结果码。 resultdesc 是 String(1-128) 无 请求返回的结果描述。 sessionId 是 String(1-256) 无 请求返回的会话sessionId，如果请求失败，则sessionId为空。 idlePort 否 Integer 无 请求参数中returnIdlePort为true时响应消息携带该参数。 该参数表示平台呼叫端口空闲可用数量，取值范围0~65535。

请求参数 表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-SHA256 (Password，Nonce + Created))生成。其中，Password为APP_Secret的值。Nonce、Created、Password直接进行字符串拼接即可，无需包含+号和空格。 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参数说明 参数名称 是否必选 参数类型 默认值 说明 displayNbr 是 String(4-31) 无 固话号码，被叫终端上显示的主叫号码，需要提前在订购号码页面申请该号码。 号码格式（固话）：国家码+区号+固话，与号码管理页面的“号显号码”保持一致。 若该号码为“暂停”状态，语音通话平台会从该应用下随机选取一个其他可用的固话号码进行外呼。 calleeNbr 是 String(4-31) 无 被叫号码。 手机号码格式：+{国家码}{手机号码}。示例：+86134****2222。 固话格式：+{国家码}{区号}{固话号码}，其中区号需去掉首位的0。示例：国家码86，区号0755，固话号码28****01，填写为+8675528****01。 languageType 是 Integer 无 验证码播放的语言类型。 取值范围： 2：中文 preTone 是 String(1-128) 无 播放语音验证码之前需要播放的放音文件名，放音文件需要提前通过放音文件管理页面上传并审核通过才能使用。 当前系统只支持Wave格式的音频文件，文件名如“pretone.wav”。 verifyCode 是 String(2-8) 无 验证码：只支持0～9的数字，最大8位。 如“12345678”。 posTone 否 String(1-128) 无 播放语音验证码之后需要播放的放音文件名。 如果携带该参数，放音文件需要提前通过放音文件管理页面上传并审核通过才能使用。 当前系统只支持Wave格式的音频文件，文件名如“postone.wav”。 如果不携带该参数，系统将在语音验证码播放完毕后结束通话。 times 否 Integer 3 播放次数：0～9。 0表示无限循环。 如果不携带该参数，默认播放3次。 statusUrl 否 String(1-128) 无 此参数请采用BASE64编码进行加密。 此字段用于设置SP接收状态上报的URL。 语音通话平台将业务触发过程中通话的状态信息（包括呼出、振铃、摘机和挂机信息）推送至此服务器，SP根据通话状态信息确定用户状态。 URL可填写为https://IP:Port或域名，推荐使用域名。且该域名对应多个服务器，避免单点故障无法接收通知。 URL只能由大小写字母（a-z、A-Z），数字（0-9），中划线（-），英文冒号（:），英文点号（.），以及英文斜杠（/）组成，不支持其它字符。 feeUrl 否 String(1-128) 无 此参数请采用BASE64编码进行加密。 此参数用于设置SP接收话单上报的URL。 语音通话平台将业务产生的话单推送至此服务器。 URL可填写为https://IP:Port或域名，推荐使用域名。且该域名对应多个服务器，避免单点故障无法接收话单。 URL只能由大小写字母（a-z、A-Z），数字（0-9），中划线（-），英文冒号（:），英文点号（.），以及英文斜杠（/）组成，不支持其它字符。 returnIdlePort 否 String(枚举) false 指示是否需要返回空闲端口数量。 true：需要返回 false：不需要返回 如果不携带该参数，系统默认该参数为false。 userData 否 String(1-256) 无 用户附属信息，此标识由第三方服务器定义，会在后续的通知消息中携带此信息。 不允许携带以下字符：“{”，“}”（即大括号）。 不允许包含中文字符，如果包含中文字符请采用Base64编码。

接口示例 请求示例 POST /rest/httpsessions/click2Call/v2.0 HTTP1.1 content-type: application/json;charset=UTF-8 authorization: AKSK realm="SDP",profile="UsernameToken",type="Appkey" x-aksk: UsernameToken Username="ZRBRz4bAXoFgEH7o4Ew308eXc1RA",PasswordDigest="****",Nonce="ac1c911c4792492687f8f6b2264a491e",Created="2018-05-26T00:35:30Z" Content-Length:xx { "displayNbr":"+86755****8888", "callerNbr":"+86137****0001", "calleeNbr":"+86137****0002", "displayCalleeNbr":"+86755****8888", "userData":"cwgtest" } 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 { "resultcode":"0", "resultdesc":"Success", "sessionId":"1202_566_0_20161228102743@callenabler.home1.com" }

结果码 请根据以下结果码进行调测，如果有疑问，可联系管理员进行确认。 表6 结果码说明 响应码 结果码 英文描述 中文描述 处理方法 200 0 Success. 成功。 无需处理。 400 1023006 Authorization not contained in the HTTP header. 鉴权失败，请检查鉴权请求正确性。 请检查消息头中是否携带了Authorization，PasswordDigest字段填写是否正确，携带的app_key填写是否正确，且生成随机数的时间与发送请求时的本地时间不能相差太大。 1023007 realm not contained in Authorization. Authorization字段中未找到realm属性。 请检查Authorization字段中的是否携带了realm属性。 1023008 profile not contained in Authorization. Authorization字段中未找到profile属性。 请检查Authorization字段中的是否携带了profile属性。 1023009 The value of realm in Authorization must be SDP. Authorization中realm属性值应该为“SDP”。 请检查Authorization字段中的realm属性值是否为“SDP”。 1023010 The value of profile in Authorization must be UsernameToken. Authorization中profile属性值应该为“UsernameToken”。 请检查Authorization字段中的profile属性值是否为“UsernameToken”。 1023011 The value of type in Authorization must be app_key. Authorization中type属性值应该为“Appkey”。 请检查Authorization字段中的type属性值是否为“Appkey”。 1023012 type not contained in Authorization. Authorization字段中未找到type属性。 请检查Authorization字段中是否携带了type属性。 1023033 HTTP header not found X-AKSK field. HTTP头未找到X-AKSK字段。 请检查HTTP消息头中是否携带了X-AKSK字段。 1023034 UserName not contained in X-AKSK. X-AKSK字段中未找到UserName属性。 请检查X-AKSK字段中的是否携带了Username属性。 1023035 Nonce not contained in X-AKSK. X-AKSK字段中未找到Nonce属性。 请检查X-AKSK字段中的是否携带了Nonce属性。 1023036 Created not contained in X-AKSK. X-AKSK字段中未找到Created属性。 请检查X-AKSK字段中的是否携带了Created属性。 1023037 PasswordDigest not contained in X-AKSK. X-AKSK字段中未找到PasswordDigest属性。 请检查X-AKSK字段中的是否携带了PasswordDigest属性。 1023038 UsernameToken not contained in X-AKSK. X-AKSK中没有携带UsernameToken。 请检查X-AKSK字段中的是否携带了UsernameToken属性。 401 1010010 Invalid digest. PasswordDigest校验失败。 请检查PasswordDigest字段填写是否正确。 1010013 Time out limit. 时间超出限制。 请确认X-AKSK鉴权时，生成随机数的时间与发送请求时的本地时间不能相差太大（具体差值请与管理员确认） 403 1010002 Invalid request. 非法请求。 检查请求携带的参数格式是否都合法。 1010003 Invalid app_key. 无效的app_key。 检查请求携带的app_key是否填写正确，app_key从应用管理页面获取，若填写正确，请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010006 Invalid Rest API. 无效的Rest API。 检查请求方法填写是否正确。 1010008 The status of the app_key is unavailable. app_key被暂停使用。 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010009 No more APIs can be invoked. API达到调用上限。 请稍等一分钟后再试，并联系管理员申请更高的应用使用配额。 1010010 The flow control upper limit is reached on the platform. 平台达到系统流控上限。 请稍等一分钟后再试。 1010011 The app is not allowed to access a commercial address. APP没有访问商用地址的权限。 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010021 Application unavailable. 应用不可用。 请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010023 Invalid display number. 号码填写不合法。 检查displayNbr和displayCalleeNbr参数的填写是否合法，与号码管理页面的“固话号码”保持一致。若合法，请确认该号码是否已申请并下发。申请号码在号码订购页面申请，号码下发后可在号码管理页面查看。 1010024 Invalid caller number. 主叫号码不合法。 检查callerNbr参数的填写是否合法。 1010040 The app_key is not allowed to invoke the API. app_key没有调用本API的权限。 请联系管理员确认该app_key对应的应用是否具有语音回呼能力。 1012001 Resource of number is not to be applied. 资源未申请。 app_key和业务号码未绑定。 1012006 The service number is not applied. 业务号码未申请。 请确认是否申请业务号码。 1012012 Application does not open recording function. 应用未开启录音功能。 请在应用管理页面确认请求携带的app_key是否开启了录音功能。 1013001 Calls exceed the SP limit. 请求次数超过SP配置上限。 请和管理员确认开发者呼叫数量限制。 1013002 Calls exceed the APP limit. 请求次数超过应用配置上限。 请和管理员确认应用呼叫数量限制。 1013003 Calls exceed the display number limit. SP的主显号码受限。 请和管理员确认显示号码呼叫数量限制。 1013004 Callee in blacklist. 被叫用户是黑名单。 被叫号码在运营商黑名单库。 1013010 Caller in blacklist. 主叫用户是黑名单。 主叫号码在运营商黑名单库。 1013011 Callee is not on the whitelist. 被叫用户不在白名单中。 请和管理员确认被叫号码白名单限制。 1013100 Common error code . 未知错误。 请和管理员确认安全管控限制。 1013101 Abnormal call restricted . 呼叫行为异常。 请和管理员确认安全管控限制。 1013111 International callin is forbidden. 国际呼入限制。 请检查请求的号码格式是否为国际号码格式。 1013112 International callout is forbidden. 国际呼出限制。 请检查请求的号码格式是否为国际号码格式。 1013113 Abnormal call duration restricted. 通话时间异常。 请检查请求的号码是否通话时间异常。 1013115 Abnormal call completion rate restricted. 呼叫接通率异常。 请检查请求的号码是否呼叫接通率异常。 1013116 Caller call frequency restricted. 主叫呼叫频次限制。 请检查主叫号码是否有呼叫频次限制。 1013117 Callee call frequency restricted. 被叫呼叫频次限制。 请检查被叫号码是否有呼叫频次限制。 1013118 Service number call frequency restricted. 业务号码呼叫频次限制。 请检查业务号码是否有呼叫频次限制。 1013119 Service number suspend. 业务号码被暂停。 请和管理员确认号码状态。 1013120 Ip address is null. IPv4地址未携带。 请客户接口携带请求发送方IPv4地址。 1013121 Call black time forbidden. 呼叫时段限制。 呼叫时段为休息时段，请工作时段再呼叫。 1013122 Sub enterprise is suspended. 子企业已被暂停。 查看是否因投诉被下线，可查看订购号码时填写的邮箱是否有业务下线通知邮件。 1020165 The number of app_key voice call ports exceeds the upper limit. 超出语音呼叫端口数限制。 请稍等一分钟后再试。建议联系管理员为该应用申请更多的端口配额。 1020166 The app client ip is not in ip white list. 请求发送方app IP不在白名单列表中。 运营商IP地域管控，此地区无法呼通。 1020168 The call is rejected because the login IP of the peer app is blacklisted . 请求发送方app登录IP是黑名单。 运营商IP地域管控，此地区无法呼通。 1020171 The call is rejected because the login IP of the peer app is blacklisted area. 请求发送方app登录IP在受限地域。 运营商IP地域管控，此地区无法呼通。 1020176 Authentication failed, try again later 鉴权失败，稍后重试。 IP因鉴权失败次数过多导致被拉黑，请30分钟后重试，或联系管理员放通该IP。 500 1010001 Internal system error. 系统错误。 请联系管理员处理。 1020001 Parameter error. 参数错误。 检查请求携带的参数格式是否都合法。 1020002 Internal error. 内部错误。 请联系管理员处理。 1020150 The app_key is invalid. app_key无效。 检查请求携带的app_key是否填写正确，app_key从应用管理页面获取，若填写正确，请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1020151 The bindNum is invalid. 业务号码无效。 业务号码无效，请联系管理员处理。 1020154 Insufficient voice ports. 语音端口不足。 请稍等一分钟后再试，并联系管理员申请扩容语音端口。 1023001 Internal error. 内部错误。 请联系管理员处理。 1023002 Response timeout. 响应超时。 重新发送一次请求。 1040001 south ne error with responseCode: %$ and responseMsg: %$. 南部网元错误。 请联系管理员处理。

响应参数 表5 响应消息参数说明 参数名称 是否必选 参数类型 默认值 说明 resultcode 是 String(1-32) 无 请求返回的结果码。 resultdesc 是 String(1-128) 无 请求返回的结果描述。 sessionId 是 String(1-256) 无 请求返回的会话sessionId，用于标记一路会话。如果请求失败，则sessionId为空表示会话建立失败。 idlePort 否 Integer 无 请求参数中returnIdlePort为true时响应消息携带该参数。 该参数表示平台呼叫端口空闲可用数量，取值范围0~65535。

请求参数 表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-SHA256 (Password，Nonce + Created))生成。其中，Password为APP_Secret的值。Nonce、Created、Password直接进行字符串拼接即可，无需包含+号和空格。 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参数说明 参数名称 是否必选 参数类型 默认值 说明 displayNbr 是 String(4-31) 无 此字段定义主叫用户收到语音通话平台的呼叫时，主叫用户手机终端的来电显示号码。需提前在订购号码页面申请该号码。 号码格式（固话）：国家码+区号+固话，与号码管理页面的“固话号码”保持一致。 若该号码为“暂停”状态，语音通话平台会从该应用下随机选取一个其他可用的固话号码进行外呼。 callerNbr 是 String(4-31) 无 此字段定义用户在SP开发的应用中，通过语音回呼功能发起呼叫时所使用的主叫号码。 手机号码格式：+{国家码}{手机号码}。示例：+86135***0002。 固话格式：+{国家码}{区号}{固话号码}，其中区号需去掉首位的0。示例：国家码86，区号0755，固话号码28****02，填写为+8675528****02。 displayCalleeNbr 是 String(4-31) 无 此字段定义被叫用户收到语音通话平台的呼叫时，被叫用户终端的来电显示号码。需提前在订购号码页面申请该号码。 该号码可以与displayNbr配置为同一个号码，也可以配置为不同号码。 号码格式（固话）：国家码+区号+固话，与号码管理页面的“固话号码”保持一致。 若该号码为“暂停”状态，语音通话平台会从该应用下随机选取一个其他可用的固话号码进行外呼。 calleeNbr 是 String(4-31) 无 此字段定义终端用户在SP开发的应用中通过语音回呼业务发起呼叫时所拨打的被叫号码。 号码格式： 手机号码格式：+{国家码}{手机号码}。示例：+86135****0004。 固话格式：+{国家码}{区号}{固话号码}，其中区号需去掉首位的0。示例：国家码86，区号0755，固话号码28****04，填写为+8675528****04。 maxDuration 否 Integer 0 此字段用于设置允许单次通话进行的最长时间，通话时间从被叫接通的时刻开始计算。 取值范围：0~1440分钟 0：系统不主动结束通话，由主被叫双方结束通话。 1~1440：当通话时长达到此配置值，系统主动结束通话。 不携带时，参数值默认为0。 lastMinVoice 否 String(1-128) 无 当maxDuration字段设置为非0时此参数有效。 此参数用于设置最后一分钟放音提示音，此值填写SP定制的放音文件名，例如lastmin_voice1.wav，参数取值有以下两种场景： SP无需定制个性化放音，无需配置此参数，系统将使用默认放音文件，放音内容为：“本次通话时长还剩1分钟”。 SP需要定制个性化放音，接口消息中携带此参数，参数值携带定制的放音文件名，请提前制作放音文件并通过放音文件管理页面提交到语音通话平台。 lastMinToUE 否 String（枚举） both 当maxDuration字段设置为非0时此参数有效。 此字段用于设置最后一分钟放音的播放对象。 toa：仅对主叫用户放音。 tob：仅对被叫用户放音。 both：同时给主叫和被叫用户放音。 不携带时，参数值默认为both。 playPreVoice 否 String（枚举） false 此字段用于设置主叫（callerNbr）应答语音回呼后，呼叫被叫（calleeNbr）前，是否向主叫（callerNbr）播放提示音。 当该参数设置为true时，播放完主叫提示音（preVoice）后才播放主叫等待音（waitVoice）并呼叫被叫（calleeNbr）。 true：播放提示音。 false：不播放提示音。 不携带时，参数值默认为false。 preVoice 否 String(1-128) 无 当playPreVoice字段设置为true时此参数有效。 此字段用于设置主叫（callerNbr）应答语音回呼后，呼叫被叫（calleeNbr）前向主叫播放的提示音，此值填写放音文件名，例如pre_voice1.wav。 SP无需定制个性化放音文件，接口消息中无需携带此参数，系统将使用默认放音“正在为您转接中，请稍后”。 SP需要定制个性化放音文件，接口消息中携带此参数，请提前制作放音文件并通过放音文件管理页面提交到语音通话平台。 waitVoice 否 String(1-128) 无 此字段用于设置主叫应答语音回呼后的等待音，此值填写放音文件名，例如wait_voice1.wav。 SP无需定制个性化放音文件，接口消息中无需携带此参数，系统将使用默认放音，系统边给主叫放音（循环放音）边拨打被叫用户；被叫应答才中止放音。 SP需要定制个性化放音文件，接口消息中携带此参数，请提前制作放音文件并通过放音文件管理页面提交到语音通话平台。 waitVoice可结合calleeMedia使用。 calleeMedia 否 String（枚举） all 该参数用于指定被叫的媒体音播放方式，参数取值范围如下： all：透传被叫端的所有放音。当被叫端返回振铃音等媒体音，则终止主叫的等待音，播放被叫的媒体音，如彩铃音等。 none：不透传被叫所有放音，一直播放主叫的等待音，直到被叫应答或挂机。 fail：只有在被叫回失败放音时（带reason原因值），才终止主叫的等待音、播放被叫的失败放音。 不携带时，参数值默认为all。 statusUrl 否 String(1-128) 无 此参数请采用BASE64编码进行加密。 此字段用于设置SP接收状态上报的URL。 语音通话平台将业务触发过程中通话的状态信息（包括呼出、振铃、摘机和挂机信息）推送至此服务器，SP根据通话状态信息确定用户状态。 URL可填写为https://IP:Port或域名，推荐使用域名。且该域名对应多个服务器，避免单点故障无法接收通知。 URL只能由大小写字母（a-z、A-Z），数字（0-9），中划线（-），英文冒号（:），英文点号（.），以及英文斜杠（/）组成，不支持其它字符。最大128字节。 feeUrl 否 String(1-128) 无 此参数请采用BASE64编码进行加密。 此参数用于设置SP接收话单上报的URL。 语音通话平台将业务产生的话单推送至此服务器。 URL可填写为https://IP:Port或域名，推荐使用域名。且该域名对应多个服务器，避免单点故障无法接收话单。 URL只能由大小写字母（a-z、A-Z），数字（0-9），中划线（-），英文冒号（:），英文点号（.），以及英文斜杠（/）组成，不支持其它字符。最大128字节。 recordFlag 否 String（枚举） false 此字段设置语音回呼通话过程是否录音。 true：开启录音，请在添加应用时开启录音功能。 false：不开启录音。 不携带时，参数值默认为false。 recordHintTone 否 String(1-128) 无 此字段在recordFlag为true时才有效。 此字段用于设置使用录音功能的提示音，参数传值为指定的放音文件名，例如recordhint_voice1.wav。 无需定制个性化放音时，接口消息中无需携带此参数。 需要定制个性化放音文件时，接口消息中携带此参数，请提前制作放音文件并通过放音文件管理页面提交到语音通话平台。 partyTypeRequiredInDisconnect 否 String(枚举) false 该参数用于指定语音通话平台给开发者发送disconnect的呼叫状态时，通知消息是否需要携带通话主动挂机的用户类型（主叫挂机、被叫挂机、平台挂机）。 该参数取值范围如下： true：需要携带 false：不需要携带 不携带该参数时，默认值为false。 returnIdlePort 否 String(枚举) false 指示是否需要返回平台空闲呼叫端口数量。 true：需要返回 false：不需要返回 不携带该参数时，默认值为false。 userData 否 String(1-256) 无 此字段用于SP开发者自定义呼叫发起时，设置用户的附属信息，应用场景可以是当开发者想要对每一次呼叫的用户进行跟踪时，该参数可以携带用于标识用户的信息，如customerId123。 语音通话平台不对此参数做强制要求，如果开发者传入此参数，语音通话平台会在后续发给SP的通知消息中携带该参数值。 不允许携带以下字符：“{”，“}”（即大括号）。 不允许包含中文字符，如果包含中文字符请采用Base64编码。

使用说明 前提条件 已通过“应用管理”页面获取该语音回呼能力的APP_Key，APP_Secret和APP接入地址。 已通过“号码订购”页面向语音通话平台申请以下号码： 若使用定制化主叫端来电显示号码，请确认已申请固话号码（displayNbr）。 若需隐藏主叫号码，使用定制化被叫端来电显示号码，请确认已申请固话号码（displayCalleeNbr）。 若需使用通话录音功能，请确认已向语音通话平台申请该功能。 若使用个性化放音，请确认已按要求制作并通过放音文件管理页面向语音通话平台提交放音文件，包括最后一分钟提示音（lastMinVoice），主叫提示音（preVoice），主叫等待音（waitVoice），录音提示音（recordHintTone），回呼提示音（callBackTone）。 若需订阅呼叫状态和话单通知，请确认已通过应用管理向语音通话平台提交呼叫状态通知URL（statusUrl）和话单通知URL（feeUrl）。若未提交，调用接口时填写也可以。 注意事项 无。 使用限制 无。