检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
自然语言处理的监控指标 功能说明 本节定义了自然语言处理服务上报云监控服务的监控指标的命名空间,监控指标列表和维度定义,用户可以通过云监控服务提供管理控制台或API接口来检索自然语言处理服务产生的监控指标和告警信息。 命名空间 SYS.NLP 监控指标 表1 NLP支持的监控指标 指标ID
文档翻译状态查询 功能介绍 该接口用于获取文档翻译识别状态以及临时url,临时url可以用于获取翻译后的文档,每个临时url有效期为十分钟。 本API调用限制为20次/秒。 调试 您可以在API Explorer中调试该接口。 前提条件 在使用本API之前,需要您完成服务申请和认
多信息请参见统一身份认证服务IAM。 云监控 云监控(Cloud Eye)可以监控自然语言处理的相关指标,具体如表1所示。用户可以通过指标及时了解自然语言处理的使用情况。Cloud Eye的更多信息请参见云监控CES。 表1 NLP的监控指标 指标名称 指标含义 取值范围 测量对象
状态码 正常 200 异常 返回值 说明 400 Bad Request 请求错误,具体返回错误码请参考错误码。 401 Unauthorized 鉴权失败。 403 Forbidden 没有操作权限。 500 Internal Server Error 服务内部错误。 503 Service
统计API使用量 自然语言处理NLP控制台“服务监控”页面,支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包,可在“套餐包管理”页面,查看已有的套餐包及使用详情。套餐包费用扣减规则请参见计费说明。 图1 服务监控
过各种角度、范围分析成本和用量的趋势及驱动因素。 企业还可以通过成本中心的“成本监控”,及时发现计划外费用,做到成本的可监控、可分析和可追溯。 详细介绍请参见通过成本分析探索成本和使用量、通过成本监控识别异常成本。 成本优化 成本控制 企业可以在成本中心的“预算管理”页面创建精细
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于NLP服务接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,
功能介绍 由于文档翻译会需要较长的时间,因此翻译是异步的,也即接口分为创建翻译任务和查询任务状态两个接口。 创建翻译任务接口创建任务完成后返回,然后用户通过调用查询任务状态接口来获得翻译状态和临时URL。 用户可以使用临时URL下载翻译好的文件,每个临时URL有效期为10分种。翻译
欠费、冻结、被注销等异常状态。 操作步骤 进入自然语言处理NLP主页,单击“立即使用”。 进入自然语言处理控制台。 在自然语言处理控制台“总览”页面,选择需要使用的服务,在操作列单击“开通服务”。 在弹出的对话框中单击“确定”。 服务开通成功后,开通状态显示“已开通”。 图1 开通服务
本章节以分词为例,介绍如何使用API Explorer调试API。 前提条件 已注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通自然语言处理服务。 操作步骤 登录API Explorer。 登录后,“X-Auth-Token”和“project_id”参数会自动填充,无需填写。
该接口可以对文本进行分词处理,并将识别结果以JSON格式返回给用户。 前提条件 已注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通服务。 操作步骤 获取并安装NLP Python SDK。 以PyCharm为例,介绍如何安装SDK。 在PyCharm中新建一
调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时,HTTPS请求返回一个4xx或5xx的HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。 错误响应Body体格式说明 当接口调用出错时,会返回错误码及错误信息说明,错误响应的Body体格式如下所示。
图1 NLP套餐包生命周期 NLP套餐包从购买到到期前,处于正常运行阶段,资源状态为“使用中”。 到期后,资源状态变为“已过期”。 到期未续费时,NLP套餐包首先会进入宽限期,宽限期到期后仍未续费,资源状态变为“冻结”。 超过宽限期仍未续费将进入保留期,如果保留期内仍未续费,资源将自动失效。
费、冻结、被注销等异常状态。 开通服务操作 进入自然语言处理基础官网,单击“立即使用”,进入自然语言处理控制台。 在“总览”页面,选择需要使用的服务,在操作列单击“开通服务”。 图1 开通服务 在弹框中单击“确定”,确认开通服务。 服务开通成功后,开通状态将显示为“已开通”。 N
扣产生的按需费用。 未购买资源包,在按需计费模式下账户的余额不足。 欠费影响 当您的账号因按需NLP资源自动扣费导致欠费后,账号将变成欠费状态。欠费后,按需资源不会立即停止服务,资源进入宽限期。您需支付按需资源在宽限期内产生的费用,相关费用可登录管理控制台,选择页面上方的“费用 >
自动转为按需计费。 欠费影响 图1描述了按需计费自然语言处理API资源各个阶段的状态。购买后,在计费周期内资源正常运行,此阶段为有效期;当您的账号因按需NLP资源自动扣费导致欠费后,账号将变成欠费状态,资源将陆续进入宽限期和保留期。 图1 按需计费自然语言处理API资源生命周期 欠费预警
附录 状态码 错误码 获取项目ID 获取账号ID 配置OBS访问权限
机器翻译服务接口说明 文本翻译 语种识别 文档翻译任务创建 文档翻译状态查询 父主题: API