华为云用户手册

修改手机号 华为云客户可能同时拥有华为云账号手机号和华为帐号手机号，两者可能一致，也可能不相同。 以下场景修改手机号，请参见修改华为帐号手机号。 华为云账号手机号和华为帐号手机号一致。 华为云账号手机号和华为帐号手机号不一致，但升级同步成功。 新注册的华为帐号或者已注册但未开通华为云业务的华为帐号。 以下场景修改手机号，请参见修改华为云账号手机号（业务手机号）。 华为云账号手机号和华为帐号手机号不一致，且升级同步失败。 修改华为帐号手机号 修改华为云账号手机号（业务手机号） 父主题： 管理帐号信息（使用华为帐号）

修改华为帐号邮件地址 进入“基本信息”页面。 在“华为帐号信息”区域，单击“前往管理”。 在“帐号与安全”页面，单击“邮件地址”后的“更改”。 进行身份验证。 通过手机号码进行身份验证 单击“短信验证码”后面的“获取验证码”，获取并输入短信验证码，单击“下一步”。 通过邮箱进行身份验证 单击“选择其他验证方式”，选择邮箱，单击“邮件验证码”后面上午“获取验证码”，获取并输入邮件验证码，单击“下一步”。 如果手机号或邮箱都无法验证身份，请提交工单处理。或拨打客服电话4000-955-988反馈，按照客服回复提供所需材料。材料审核通过后，客服人员会尽快为您重置邮件地址。 输入新的邮箱，单击“获取验证码”，获取并输入邮箱验证码。 单击“确定”。 系统提示更改邮件地址成功。 父主题： 修改邮件地址

华为云业务注销条款 如果您主动注销您通过华为云服务网站（www.huaweicloud.com）或其他方式开通的业务时，您应遵循有关华为云注销的条款和条件（以下简称“本条款”）。 华为云在此特别提醒您认真阅读、充分理解本协议各条款，特别是其中涉及华为云注销的条件、程序、法律后果的条款。如您勾选本条款并提交注销华为云（或关闭华为云）申请，即视为您已充分阅读、理解并同意本条款的全部内容，对于其中有疑问的内容已由华为云澄清说明，确信通过华为云注销功能能够实现您的目的。有任何疑问，请您联系华为云咨询。 自您提交华为云注销申请起，华为云将按照本条款及相关提示，对您的申请进行检查、核验。对于符合华为云注销条件的申请，华为云将通知您检查结果，并在您确认后启动注销进程，该流程不可撤回。对于不符合华为云注销条件的，华为云也会通知您检查结果，且注销流程将自动终止。 华为云注销的条件 不存在下列情形之一，或者已就相关事宜与华为云达成一致： 存在欠费、欠票、待付费用、可用预付款余额 存在尚未履行完毕的合同，生效中的订单、资源、预留实例 存在任何其他申请中的业务（包含但不限于正在申请新订单、正在申请退订/提现、正在申请加入华为云生态计划等） 与任何华为云生态伙伴账号建立了关联关系 与任何企业主账号、企业子账号建立了关联关系 不存在未缴纳的税款及其他依照法律法规要求应履行未履行的义务等情形； 截至申请注销之日未违反过任何法律规定或与华为云的协议约定，或者已就相关事宜与华为云达成一致。 华为云注销的程序 客户自查 在您提交申请前，请自查是否满足本条款第1条约定的华为云注销条件，否则您的华为云注销程序可能因不满足注销条件而被终止。 注销方式选择 为了保护您的华为云业务安全，华为云仅向您提供自助注销服务，当您的华为云业务不满足注销条件又无法自行处理时，可联系华为云支持求助相应问题。 具体步骤 提出申请 满足前述条件的用户可以通过登录华为云服务网站，在账号中心点击“关闭华为云业务”，完成身份验证，阅读并接受本条款，提交注销申请。 检查 华为云将自动开始对您进行注销条件检查程序。 通知检查结果及后续流程 检查通过 对于符合华为云业务注销条件的申请，华为云将在检查通过后以邮件、短信或其他合理方式通知您，并启动注销流程。 华为云对您业务注销的条件仅进行初步地、形式地审查，华为云认为您符合注销条件，不代表华为云实质上认可或者放弃依法或者依照约定应该享有的权利，也不意味着您在业务注销前的所有相关行为和责任得到豁免或减轻，包括但不限于存在的任何欠费、代付费用、未缴纳税款等。 检查不通过 对于不符合华为云业务注销条件的，华为云将以邮件、短信或其他合理方式通知您不通过的检查项，注销程序将自动终止，且不会自动恢复。如果您希望继续注销的，应重新提起注销申请。 检查通过至注销完毕期间（以下简称“关闭期”），如果华为云发现您被他人投诉、被国家机关调查或者正处于诉讼、仲裁程序中，或不符合注销的其他条件，华为云有权自行终止您的注销进程而无需取得您的同意。 注销华为云，不会影响您使用“华为帐号”服务，如通过“华为帐号”登录访问其他华为网站、应用或服务。如您不希望继续使用“华为帐号”，可在注销华为云后，前往华为帐号中心（id.huawei.com）进行注销操作。 关闭期 华为云根据适用的法律法规、相关监管机构以及行业实践的要求，设置一定的关闭期，并在华为云服务网站公告/向您提示后生效。 关闭华为云期间，您无法继续使用华为云服务；该关闭期不计入服务等级协议（SLA）的计算且您不能享受相应的服务等级条款下的权利。 在关闭期间，您可继续登录华为云服务网站，进行以下操作： 查询过往账单并对待还账单进行结算； 申请再次激活华为云，以便重新申请使用华为云服务； 结清云服务使用费用后，立即注销华为云。 在关闭期间，华为云将删除您在华为云上的内容，但本条款另有约定或依照适用的法律法规，相关行政、执法、司法机关的约束性命令除外。 注销华为云的法律后果 您的华为云业务在本条款生效时启动注销程序。 注销完毕后（关闭期满或您在关闭期选择立即注销），华为云与您签署的所有合同即时解除，将对您产生包括但不限于如下影响及后果： 您将无法再次登录华为云网站、华为云APP等； 您将无法访问控制台或进行任何相关操作； 您将无法找回华为云业务相关的个人信息、交易记录、业务数据、历史信息等； 服务停止。 华为云注销不代表您在业务注销前的所有相关行为和责任得到豁免或减轻。 截止华为云注销之日，华为云已按双方合同及生效订单约定提供服务，不存在任何违约情形。 华为云将您的数据清除，且华为云将不会继续收集、存储和使用您的个人信息和其他数据，但根据所适用的法律规范、行政、执法、司法机关的约束性命令或者行业最佳实践另有要求的情形除外，例如：为了税务合规而保留相应的发票数据、为遵从电子商务相关法律而保留我们与您之间的交易信息等。 账户余额处理 在您结清所用云服务费用后，需对账户余额进行提现。 华为云一旦注销将无法恢复，请您在备份好所有业务信息、数据后谨慎操作。您可在关闭期内查询过往账单，对待还账单进行结算。关闭期内您将无法访问及使用云服务，云服务资源会被系统释放。关闭期满，华为云将清除数据，由此造成数据或信息丢失的，华为云不承担任何责任。 如因您的注销行为给华为云造成损失的，您应赔偿因此给华为云造成的损失，并使得华为云及其董事、雇员、代理商、合作伙伴、供应商免受任何第三方的索赔。 其他 本条款构成《华为云用户协议》的一部分，本条款未尽事宜，应适用《华为云用户协议》的相关约定。 本条款仅约束您主动申请注销的情形，但不排除法定或者其他约定的注销情形（如《华为云用户协议》中“账户注销”的情形）。 如果本条款中文版本与英文或其他语言版本冲突的，应当以中文版本为优先。 父主题： 注销华为云业务(华为帐号用户)

修改华为云账号手机号（业务手机号） 如果原华为云账号的手机号与华为帐号的手机号不一致，升级后手机号同步失败时原华为云账号的手机号会在“华为云业务信息”区域显示“业务手机号”，您可以查看并修改业务手机号。 业务手机号仅用于华为云业务，可接收华为云资讯、活动消息以及业务相关验证码。 进入“基本信息”页面。 在“华为云业务信息”区域，单击“业务手机号码”后的“修改”。 进行身份验证。 通过手机号码进行身份验证 单击“通过短信验证码验证”后面的“立即验证”。 单击“获取验证码”，获取并输入短信验证码，单击“下一步”。 通过注册邮箱进行身份验证 单击“通过邮箱验证码验证”后面的“立即验证”。 单击“获取验证码”，获取并输入邮箱验证码，单击“下一步”。 如果手机号或邮箱都无法验证身份，请提交工单处理或拨打客服电话4000-955-988反馈。参考FAQ准备好用于身份认证的相关材料。 输入新手机号码并单击“获取验证码”，获取并输入短信验证码。 单击“确定”。 系统提示更改手机号码成功。 父主题： 修改手机号

修改华为云账号邮件地址（业务邮件地址） 如果原华为云账号的邮件地址与华为帐号的邮件地址不一致，升级后邮件地址同步失败时原华为云账号的邮件地址会在“华为云业务信息”区域显示为“业务邮件地址”，您可以查看并修改业务邮件地址。 业务邮件地址仅用于华为云业务，可接收华为云资讯、活动消息以及业务相关验证码。 进入“基本信息”页面。 在“华为云业务信息”区域，单击“业务邮件地址”后的“修改”。 进行身份验证。 通过手机号码进行身份验证 单击“通过短信验证码验证”后面的“立即验证”。 单击“获取验证码”，获取并输入验证码，单击“下一步”。 通过邮箱进行身份验证 单击“通过邮箱验证码验证”后面的“立即验证”。 单击“获取验证码”，获取并输入验证码，单击“下一步”。 如果手机号或邮箱都无法验证身份，请提交工单处理。或拨打客服电话4000-955-988反馈，按照客服回复提供所需材料。材料审核通过后，客服人员会尽快为您重置邮件地址。 输入新的邮箱，单击“获取验证码”，获取并输入邮箱验证码。 单击“确定”。 系统提示更改邮件地址成功。 父主题： 修改邮件地址

操作步骤 进入“基本信息”页面。 查看用户基本信息。 在“华为帐号信息”区域，您可以查看使用华为帐号时所需的信息，如：帐号名、手机号、邮箱地址和密码。 在“华为云业务信息”区域，您可以查看使用华为云业务时所需的信息，如：租户名、开通时间、企业名称/姓名（系统将根据选择的租户类型展示企业名称或姓名）、职位、业务手机号（仅在华为云账号手机号与华为帐号手机号不一致时显示的华为云账号手机号）、业务邮件地址（仅在华为云账号邮件地址与华为帐号邮件地址不一致时显示的华为云账号邮件地址）、认证信息、安全凭证、联系地址及应用行业信息。

华为云账号注销条款 华为云账号注销的条款（以下简称“本条款”）约束您主动注销您的华为云服务网站（www.huaweicloud.com）账号的行为及所涉相关事宜。 请您在提交账号注销申请前务必仔细阅读本条款，有任何疑问，请您联系华为云咨询。 如您勾选本条款并点击“提交”账号注销（或 账号关闭）申请，即视为您已充分阅读、理解并同意本条款的全部内容，对于其中有疑问的内容已得到华为云澄清说明，确信通过华为云账号注销功能能够实现您所希望的目的。 自您提交账号注销申请时刻起，华为云将按照本条款及相关提示，对您的申请进行检查。对于符合华为云账号注销条件的申请，华为云将通知您检查结果，在您确认后启动账户注销进程，该进程不可撤回。对于不符合华为云账号注销条件的，华为云也会通知您检查结果，账号注销程序将自动终止。 账号注销的条件 拟注销的华为云账号下不存在下列情形之一，或者已就相关事宜与华为云达成一致； 欠费、欠票、待付费用、可用预付款余额 尚未履行完毕的合同，生效中的订单、资源、预留实例 任何其他申请中的业务（包含但不限于正在申请新订单、正在申请退订/提现、正在申请加入华为云生态计划等） 与任何华为云生态伙伴账号建立了关联关系 与任何企业主账号、企业子账号建立了关联关系 拟注销的华为云账号下不存在未缴纳的税款及其他依照法律法规要求应履行未履行的义务等情形； 拟注销的华为云账号截至申请注销之日未违反过任何法律规定或与华为云的协议约定，或者已就相关事宜与华为云达成一致。 账号注销的程序 客户自查 在您提交账号申请前，请自查是否满足本条款第1条约定的账号注销条件，否则您的账户注销程序可能因不满足注销条件而被终止。 注销方式选择 为了保护您的华为云账号安全，华为云仅向您提供自助注销服务，当您的华为云账号不满足注销条件又无法自行处理时，可联系华为云支持求助相应的问题。 具体步骤如下： 提出申请 满足前述条件的用户可以通过登录华为云服务网站，在账号中心点击“关闭账号”，完成身份验证，阅读并接受本条款，提交账号注销申请。 检查 华为云将自动开始对您进行注销条件检查程序 通知检查结果及下一步进程 检查通过 对于符合华为云账号注销条件的申请，华为云将在检查通过后以邮件、短信或其他合理方式通知您，并启动账户注销进程。 华为云对您的账户注销的条件仅进行初步地、形式地审查，华为云认为您符合注销条件，不代表华为云实质上认可或者放弃依法或者依照约定应该享有的权利，也不意味着您在该账号注销前的所有账号行为和相关责任得到豁免或减轻，包括但不限于您拟注销账号下存在的任何欠费、代付费用、未缴纳税款等。 检查不通过 对于不符合华为云账号注销条件的，华为云将以邮件、短信或其他合理方式通知您不通过的检查项，账号注销程序将自动终止，且不会自动恢复。如果您希望继续注销的，应重新提起账号注销申请。 账号检查通过至注销完毕期间（以下简称“关闭期”），如果华为云发现您的华为云账号被他人投诉、被国家机关调查或者正处于诉讼、仲裁程序中，或不符合账号注销的其他条件，华为云有权自行终止你账号注销进程而无需您同意。 关闭期 华为云依照行业实践及法律法规或国家行政司法执法机关的要求，设置一定的关闭期时长，并在华为云服务网站公告/向您提示后生效。 账号关闭期间，您不可继续使用华为云服务；暂停时间不计入SLA的计算且您不能享受相应的服务等级条款下的权利； 在关闭期间，您可继续使用该账号登录华为云服务网站，进行以下操作： 查询过往账单并对待还账单进行结算； 申请激活该账号，以便重新申请使用华为云服务； 或在结清云服务使用费用后，立即注销该账号； 在关闭期间，华为云将删除您在华为云上的内容，但本条款另有约定或依照法律法规或国家行政司法执法机关的要求除外； 账号注销的法律后果 您的华为云账号在本条款生效时启动注销程序； 注销完毕后（关闭期满 或 您在关闭期选择立即注销）所有合同关系即时解除，将对您造成不限于如下的后果： 您将无法再次以此账号登录华为云网站、APP等； 您将无法访问控制面板； 您将无法进行依赖于账号权限进行的其他操作； 您将无法找回该账号下的个人信息、交易记录、业务数据、历史信息等； 服务停止。 账号注销不代表您在该账号注销前的所有账号行为和相关责任得到豁免或减轻。 截止账号注销之日，华为云已按双方合同及生效订单约定提供服务，不存在任何违约情形。 华为云将您的数据清除，无权继续收集、存储和使用您的个人信息和其他数据，但所适用的法律规范或者行业最佳实践另有要求的情形除外，例如：为了税务合规而保留相应的发票数据、为遵从电子商务法律而保留我们与您之间的交易信息等。 账户余额处理 在您结清所用云服务费用后，需对账户余额进行提现。 账号一旦注销即无法找回，请您备份好账号下所有业务信息、数据后谨慎操作。您可在关闭期内查询过往账单，对待还账单进行结算。关闭期内您将无法访问及使用云服务，云服务资源会被系统释放。关闭期满，华为云将收回您的华为云账号，清除数据，由此造成数据或信息丢失的，华为云不承担任何责任。 其他 本条款构成《华为云用户协议》不可分割的一部分，本条款未尽事宜，参考适用《华为云用户协议》的相关约定。 本条款仅约束您主动申请的情形，但不排除法定或者其他约定的账户注销情形（如华为云用户协议中的“账户注销”情形）。 如因您的账号注销事宜给华为造成损失的，您应赔偿因此给华为云造成的损失，并使得华为云及其董事、雇员、代理商、合作伙伴、供应商免受任何第三方的索赔。 本条款中文版本效力优先适用。 父主题： 如何注销华为云账号

AK/SK认证 如需使用AK/SK认证，建议使用 自然语言处理 SDK参考，或使用下文签名SDK。 AK/SK签名认证方式仅支持消息体大小12M以内，12M以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。 AK/SK获取方式请参考获取AK/SK。

Token认证 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 如果您的华为云帐号已升级为华为帐号，将不支持获取帐号Token，建议您为自己创建一个 IAM 用户，授予该用户必要的权限，获取IAM用户Token。 如果您是第三方系统用户，直接使用联邦认证的用户名和密码 获取Token ，系统会提示密码错误。请先在华为云的登录页面，通过“忘记密码”功能，设置原华为云帐号密码。 如果您开启了登录保护并设置登录保护为MFA验证，请参考获取IAM用户Token（使用密码+虚拟MFA）获取IAM用户Token。 如果需要获取具有Security Administrator权限的Token，请参见：如何获取Security Administrator权限的Token。 通过Postman获取用户Token示例请参见：如何通过Postman获取用户Token。 NLP服务所需Token获取可参考下文，如需了解更多获取Token方式，请参考获取用户Token。 获取用户Token接口请求构造如下，您可以从接口的请求部分看到所需的请求参数及参数说明。获取Token消息头只需填写“Content-Type”，将消息体加入后的请求如下所示。 加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的帐号名称，********为用户登录密码。详细信息请参见Token消息体中user name，domain name和project name分别指的是什么？章节。 获取Token的终端节点和projectname需与NLP服务终端节点保持一致。当访问华北-北京四的终端节点（即nlp-ext.cn-north-4.myhuaweicloud.com时），获取Token请使用终端节点https://iam.cn-north-4.myhuaweicloud.com，projectname对应使用cn-north-4。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "projectname" } } } } 如下图所示，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。获取Token之后，您就可以使用Token认证调用NLP服务API。 图1 获取用户Token响应消息头 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333 。

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 URI-scheme：表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint：指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点中获取。例如自然语言处理（NLP）服务在“华北-北京四”区域的Endpoint为“nlp-ext.cn-north-4.myhuaweicloud.com”。 resource-path：资源路径，也即API访问路径。从具体API的URI模块获取，例如“文本分类”API的resource-path为“/v1/{project_id}/nlu/classification”。其中{project_id}为项目ID，请参考获取项目ID获取。 query-string：查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。当前NLP服务未使用该参数。 例如，您需要在“华北-北京四”区域调用文本分类API，则需使用“华北-北京四”区域的Endpoint（nlp-ext.cn-north-4.myhuaweicloud.com），并在文本分类的URI部分找到resource-path（/v1/{project_id}/nlu/classification），拼接起来如下所示。 https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/{project_id}/nlu/classification 图2 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type：消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 X-Auth-Token：用户Token，可选，当使用Token方式认证时，必须填充该字段。用户Token请参考3.2 认证鉴权。用户Token也就是调用IAM服务获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见AK/SK认证。 对于获取用户Token接口，添加消息头后的请求如下所示。 POST https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/{project_id}/nlu/classification Content-Type: application/jsonx-auth-token: MIIaBgYJKoZIhvcNAQcC……

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 GET：请求服务器返回指定资源。 PUT：请求服务器更新指定资源。 POST：请求服务器新增资源或执行特殊操作。 DELETE：请求服务器删除指定资源，如删除对象等。 HEAD：请求服务器资源头部。 PATCH：请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 在文本分类的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/{project_id}/nlu/classification

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于文本分类接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。 POST https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/{project_id}/nlu/classificationContent-Type: application/jsonx-auth-token: MIIaBgYJKoZIhvcNAQcC……{ "content":"XXX去屑洗发水，全国包邮", "domain":1} 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于文本分类接口，您可以从响应消息部分看到返回参数及参数说明。

公共请求参数 表1 公共请求消息头 参数名 说明 必选 示例 Content-type 发送的实体的MIME类型。 是 application/json Content-Length 请求body长度，单位为Byte。 POST/PUT请求为可选， GET不包含。 3495 X-Auth-Token 用户Token。 是 MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... X-Language 请求语言类型。 否，默认为zh-cn。 en-us 其它header属性，请遵照https协议。 父主题： 数据结构

API概览 自然语言处理提供了如下接口，方便用户对自然语言处理的使用。各类接口的说明如表1所示。 表1 接口说明 接口类型 说明 自然语言处理基础 接口 包含分词、多粒度分词、依存句法分析、命名实体识别、文本相似度和句向量、实体链接、关键词抽取、事件抽取接口等。 语言生成 接口 包含文本摘要、诗歌生成接口。 语言理解 接口 包含情感分析、文本分类、意图理解接口。 机器翻译 接口 包含文本翻译、语种识别接口。

操作步骤 进入自然语言处理NLP主页，单击“立即使用”。 进入自然语言处理控制台。 在自然语言处理控制台“总览”页面，选择需要使用的服务，在操作列单击“开通服务”。 在弹出的对话框中单击“确定”。 服务开通成功后，开通状态显示“已开通”。 图1 开通服务 NLP服务开通后，暂不支持关闭。开通服务时，计费规则默认为“按需计费”，按需计费时，不使用NLP服务，则不收费。如果您购买了套餐包，套餐包扣减规则请参见价格计算器计费详情页。 如未开通服务，直接调用NLP API会提示ModelArts.4204报错。

终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 目前自然语言处理基础、语言生成、语言理解和机器翻译服务支持以下地区和终端节点： 表1 自然语言处理基础、语言生成、语言理解和机器翻译服务 区域名称 区域 终端节点（Endpoint） 协议类型 华北-北京四 cn-north-4 nlp-ext.cn-north-4.myhuaweicloud.com HTTPS 父主题： 使用前必读

基本概念 帐号 用户注册华为云时的帐号，帐号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于帐号是付费主体，为了确保帐号安全，建议您不要直接使用帐号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。 用户 由帐号创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看帐号ID和用户ID。通常在调用API的鉴权过程中，您需要用到帐号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 华为云的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您帐号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 父主题： 使用前必读

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于文本分类接口，返回如下消息体，格式请具体参考文本分类响应消息部分。 { "result": { "content": "XXX去屑洗发水，全国包邮", "label": 0, "confidence": 0.5190434 }} 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_code": "NLP.0301", "error_msg": "query param error content.at least one of Chinese, English, or number;"} 其中，error_code表示错误码，error_msg表示错误描述信息。

响应参数 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024 状态码： 401 表4 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024 状态码： 403 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024 状态码： 404 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024

URI POST /v2/{project_id}/instances/{instance_id}/redislog 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参见获取项目ID。 instance_id 是 String 实例ID。 表2 Query参数 参数 是否必选 参数类型 描述 query_time 否 Integer 日期偏移量，表示从过去的n天开始查询，例如：传入0则表示查询今天的日志，传入7则表示查询过去7天的日志。最大支持0-7。 log_type 是 String 返回日志的类型，当前仅支持Redis运行日志，类型为run replication_id 否 String 副本ID，可以从分片与副本中查询对应节点的副本ID，当实例不为单机实例时，该参数为必填。

响应参数 状态码为 200 时: 参数 参数类型 描述 key String 标签键。 最大长度36个unicode字符。 values Array of strings 标签值。 每个值最大长度43个unicode字符。 可以为空字符串。 响应示例 { "tags": [ { "key": "001", "values": [ "002" ] }, { "key": "003", "values": [ "004" ] } ]}

API概览 表1 分布式缓存服务接口列表 类型 说明 生命周期管理 包括实例的创建、查询和删除，实例信息的修改以及实例扩容。 实例管理 包括重启实例、查询实例状态、修改密码、查询实例的统计信息等接口。 分片与副本 包括添加副本、设置备节点切换为主节点的优先级、查询分片信息等接口。 参数管理 包括查询和修改实例配置参数接口。 备份与恢复 包括备份实例、恢复实例、查看备份信息和恢复记录等接口 数据迁移 包括创建实例迁移任务接口。 标签管理 用户管理实例标签的接口，包括为实例添加标签、删除标签、查询标签以及查询租户所有标签。 缓存分析 包括设置大Key和热Key分析任务、查询大Key和热Key等接口。 日志管理 包括查询慢日志的接口。 IP白名单管理 包括为指定实例设置IP白名单分组、查询实例的IP白名单的接口。 后台任务管理 包括查询后台任务列表、删除后台任务的接口。 实例诊断 包括查询可用区信息、产品规格列表以及维护时间窗等接口。 模板管理 包含查询参数模板列表、创建自定义模板接口。 其他接口 包括查询产品规格、查询维护时间窗时间段、查询可用区信息等。

请求消息 请求参数 参数说明见表2。 表2 参数说明 参数 类型 必选 说明 name String 否 实例名称。 由英文字符开头，只能由英文字母、数字、中划线和下划线组成。 创建单个实例时，名称长度为4到64位的字符串。批量创建实例时，名称长度为4到56位的字符串，且实例名称格式为“自定义名称-n”，其中n从000开始，依次递增。例如，批量创建两个实例，自定义名称为dcs_demo，则两个实例的名称为dcs_demo-000和dcs_demo-001。 description String 否 实例的描述信息。 长度不超过1024的字符串。 说明： \与"在json报文中属于特殊字符，如果参数值中需要显示\或者"字符，请在字符前增加转义字符\，比如\\或者\"。 instance_backup_policy JSON 否 备份策略，实例类型为主备和集群时支持。详情参考表4和表5。 maintain_begin String 否 维护时间窗开始时间，格式为HH:mm:ss。 维护时间窗开始和结束时间必须为指定的时间段，可参考查询维护时间窗时间段获取。 开始时间必须为22:00:00、02:00:00、06:00:00、10:00:00、14:00:00和18:00:00。 该参数不能单独为空，若该值为空，则结束时间也为空。 maintain_end String 否 维护时间窗结束时间，格式为HH:mm:ss。 维护时间窗开始和结束时间必须为指定的时间段，可参考查询维护时间窗时间段获取。 结束时间在开始时间基础上加四个小时，即当开始时间为22:00:00时，结束时间为02:00:00。 该参数不能单独为空，若该值为空，则开始时间也为空。 security_group_id String 否 安全组ID。 可从虚拟私有云服务的控制台界面或者API接口查询得到。 请求示例 请求URL： PUT https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id} 示例1： { "description": "instance description"} 示例2： { "name": "dcs002", "description": "instance description", "instance_backup_policy": { "backup_type": "auto", "save_days": 1, "periodical_backup_plan": { "begin_at": "00:00-01:00", "period_type": "weekly", "backup_at": [ "1", "2", "3", "4", "6", "7" ] } }, "security_group_id": "18e9309f-f81a-4749-bb21-f74576292162", "maintain_begin": "02:00:00", "maintain_end": "06:00:00"}

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2022-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "XXXXXX",...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error": { "code": "111400060", "message": "instance name exists." }} 其中，code表示错误码，message表示错误描述信息。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" } } }} 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projectsContent-Type: application/jsonX-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333 。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12M以内，12M以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

响应示例 状态码： 200 查询所有实例列表成功。 { "instance_num" : 1, "instances" : [ { "publicip_id" : { }, "vpc_name" : "dcs-beta", "charging_mode" : 0, "vpc_id" : "5e37b3be-950a-48e1-b498-65b63d336481", "subnet_id" : "a4112635-3ec0-471c-95c3-5cf49b9533af", "user_name" : "clouduser", "created_at" : "2022-08-29T09:00:34.335Z", "updated_at" : "2022-08-29T09:00:34.335Z", "enable_ssl" : false, "max_memory" : 128, "publicip_address" : null, "capacity" : 0, "order_id" : null, "maintain_begin" : "18:00:00", "engine" : "Redis", "maintain_end" : "19:00:00", "capacity_minor" : ".125", "service_upgrade" : false, "no_password_access" : true, "service_task_id" : "", "ip" : "192.168.0.195", "used_memory" : 2, "access_user" : null, "instance_id" : "c830053e-d5a3-4bc0-b6d6-ca37d1ea9dd5", "enable_publicip" : false, "port" : 6379, "user_id" : "d53977d1adfb49c5b025ba7d33a13fd7", "domain_name" : "redis-c830053e-d5a3-4bc0-b6d6-ca37d1ea9dd5.dcs.xxx.com", "name" : "dcs-lpvo0829", "spec_code" : "redis.ha.xu1.tiny.r2.128", "engine_version" : "5.0", "status" : "RUNNING", "security_group_id" : "securityGroupId", "enterprise_project_id" : 0, "tags" : [ { "key" : 1, "value" : "D CS " } ], "az_codes" : [ "region01", "region02" ], "description" : "实例描述备注", "cpu_type" : "x86_64", "features" : { "support_acl" : true, "support_transparent_client_ip" : true, "support_ssl" : false }, "sub_status" : "normal" } ]} 状态码： 400 非法请求。 { "error_code" : "DCS.4800", "error_msg" : "Invalid offset in the request."}

响应示例 状态码： 200 查询运行日志成功。如果没有日志则会返回'204' { "total_num" : 1, "file_list" : [ { "id" : "e79f2d97-e972-41f2-b51c-d18f65f39a45", "file_name" : "redis_192.168.0.142_2021-04-16.log", "status" : "succeed", "time" : "2021-04-16", "replication_ip" : "192.168.0.142", "group_name" : "group-0", "backup_id" : "e79f2d97-e972-41f2-b51c-d18f65f39a45" } ]} 状态码： 400 非法请求。 { "error_code" : "DCS.4800", "error_msg" : "Invalid logType."}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 total_num Integer 总数 file_list Array of RunlogItem objects 运行日志列表 表4 RunlogItem 参数 参数类型 描述 id String 日志的唯一标识 file_name String 运行日志文件名 group_name String 分片名称 replication_ip String 采集运行日志所在副本的IP status String 获取运行日志状态 time String 运行日志采集的日期，格式为"yyyy-MM-dd" backup_id String 日志文件的ID 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024 状态码： 404 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024 状态码： 500 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误信息 最大长度：1024 error_code String 错误码 最大长度：9 error_ext_msg String 扩展错误信息(暂未使用，赋值为null) 最大长度：1024