检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 OSM对外开放的API主要是为运营华为公有云服务的合作伙伴开放工单请求管理API,便于合作伙伴系统能够将华为云工单提交给华为云售后服务团队协助处理。 表1 工单管理接口列表 类型 说明 查询工单类目列表 用户在提交工单时可以选择问题关联的产品类型。 查询问题类型列表
用于通知工单处理进展 是 是 用户帐号注销,会被清除 IP 使用服务时 记录审计日志 否 是 日志清空时删除 授权信息 在授权页面填写,可能包括管理控制台帐号密码、云主机信息等 在需要协助处理或者信息确认时提供,便于服务人员登录主机或者控制台协助进行问题修复,可以拒绝、撤销授权 否
概述 欢迎使用OSM,OSM是支撑华为云售后服务的客户服务支持系统,售后服务人员在OSM处理华为云客户通过电话、官网、APP等途径提交的咨询、技术报障等工单。 您可以使用本文档提供的API对工单进行相关操作,如创建、删除、查询等。支持的全部操作请参见API概览。 父主题: 使用前必读
如何查看审计日志 操作场景 开启了云审计服务后,系统开始记录工单管理的相关操作。云审计服务管理控制台保存最近7天的操作记录。 操作步骤 登录管理控制台。 单击“服务列表”,选择“管理与监管 > 云审计服务”,进入云审计服务信息页面。 单击左侧导航树的“事件列表”,进入事件列表信息页面。
章节。 访问方式 华为云提供了Web化的服务管理平台,即管理控制台和基于HTTPS请求的API(Application programming interface)管理方式。 API方式 如果用户需要将公有云平台上的工单管理集成到第三方系统,用于二次开发,请使用API方式访问工单
认证要高。 Token认证 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。
Administrator(全局项目) 工单服务管理员。 系统角色 Ticket Group Operator(全局项目) 该权限用于处理同组其他用户工单,以便协同办公。 系统角色 表2列出了工单管理常用操作与系统策略的授权关系,您可以参照该表选择合适的系统策略。 表2 常用操作与系统策略的关系 策略名称
服务评价 功能介绍 用户在工单处理完成之后可以进行服务评价,提交一些评论。 URI POST /v1.0/servicerequest/case/evaluation 请求消息 请求参数 表1 请求参数 参数 是否必选 参数类型 取值范围 描述 caseId 是 String 32
用户注册时的帐号,帐号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于帐号是付费主体,为了确保帐号安全,建议您不要直接使用帐号进行日常管理工作,而是创建用户并用来进行日常管理工作。 用户 由帐号在IAM中创建的用户,是云服务的使用人员,具有身份凭证(密码和访问密钥)。
填写需要的授权信息,勾选“我已阅读并同意《工单服务协议》”,单击“确认授权”,即可授权给华为工程师处理。 图2 确认授权 当前授权类型包括以下几种: 服务器类授权:SSH协议(包括密码和私钥两种)、RDP协议、VNC协议 控制台授权:认证凭证、委托授权 认证凭证:无需填写账号密码,但是授权范围较大,服务人员将以授权账号身份登录,拥有同等权限;
Integer 云服务区总数。 regionList List<Region> 云服务区信息列表。 具体请参见表2 表2 regionList字段数据结构说明 参数 参数类型 描述 regionId String 云服务区Id。 regionName String 云服务区名称。 响应示例 {
给用户组授权之前,请您了解用户组可以添加的工单管理权限,并结合实际需求进行选择,工单管理支持的系统权限,请参见:工单管理系统权限。若您需要对除工单管理之外的其它服务授权,IAM支持服务的所有权限请参见权限策略。 已打开“是否启用提单策略”开关(该操作仅IAM主账号可见)。 示例流程
service_time_zone String 服务时区,GMT+08:00 最小长度:0 最大长度:10 service_time_day String 每周服务天数 最小长度:1 最大长度:7 service_time_hour String 每天服务小时 最小长度:1 最大长度:2 请求示例
填写需要的授权信息,勾选“我已阅读并同意《工单服务协议》”,单击“确认授权”,即可授权给华为工程师处理。 图2 确认授权 当前授权类型包括以下几种: 服务器类授权:SSH协议、RDP协议、VNC协议 帐号授权:支持帐号授权和委托授权 FTP授权:支持SFTP 机密信息授权 授权信息在工单处理结束后在系统中清除,华为
支持云审计的关键操作 操作场景 平台提供了云审计服务。通过云审计服务,您可以记录与工单相关的操作事件,便于日后的查询、审计和回溯。 前提条件 已开通云审计服务。 支持审计的关键操作列表 表1 云审计服务支持的工单操作列表 操作名称 资源类型 事件名称 创建工单 case createCase
终端节点 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 工单管理的终端节点如下表所示,请您根据业务需要选择对应区域的终端节点。 表1 工单管理的终端节点 区域名称 区域 终端节点(Endpoint)
修订记录 发布日期 修订记录 2020-01-20 第四次正式发布。 权限管理内容优化。 2019-10-15 第三次正式发布。 新增个人数据保护机制章节内容。 2019-09-23 第二次正式发布。 文档内容结构优化。 2018-08-30 第一次正式发布。
状态码 表1 正常HTTP响应码 Status Code Description 200 OK 表2 异常HTTP响应码 Status Code Description 100 Continue 201 Created 202 Accepted 204 NO Content 400
协议管理 查看最新发布版本协议详情 查询用户是否签署最新协议 签署协议 父主题: API v2(推荐)
附件功能 上传附件 上传附件 删除附件 下载附件 图片展示 附件限制 父主题: API v2(推荐)