使用门票API运算创建门票、添加注释或更新门票状态华体会联盟hthRackspace滴答目前限专用主机或托管主机产品
邮票
POST/表
Content-Type: application/vnd.ticketing.v2+json
Accept: application/vnd.ticketing.v2+json
华体会联盟hth开机空间创建新票
面向专用和fazure账号混合式 :
)用户必须拥有账户_admin
或编辑列表
角色分配作用可在内部管理华体会联盟hthmy.rackspace.com门外
所有其他账户,用户必须拥有identity:user-admin
或入场券:admin
角色化角色管理云控制板.
预设条件
创建票用户前需要知道
注解
华体会联盟hth连接入机票时,用户首先需要上传附机到拉克空间环境上传附件请参考附加文件
请求参数
请求有下列体参数:
名称 | 类型 | 描述性 |
---|---|---|
记账Id | 字符串(必备) | 开票账户(例如)混合式:12345 ) |
题材 | 字符串(必备) | 题目列票 |
类别 | 字符串(必备) | 类别名类别划分账号 ,计费支付 ,请求信息 ,变换 并事件处理 . |
子类 | 字符串(必备) | 子类名 |
严重性 | 字符串 | 重度请求,请使用/帐户端点判定您的账号可用分量 |
注释 | 对象类 | 可使用此对象描述您的入场券 。 |
注释.text | 字符串(必备) | 详细描述你请求的性质 |
comment.attachments | 对象设置 | 附加注释 |
comment.attachments.filename | 字符串 | 名附属文件 |
comment.attachments.uuid | 字符串 | UUID附属文件 |
资源类 | 字符串 | URL受问题影响的资源 票描述 |
接收者 | 数组 | 列表所有接收人通知门票 |
请求示例
下示例显示JSON请求开票
sccountId:Hybrid:12345,主体:Help华体会联盟hthWe need more servers!", "category": "Incident", "subcategory": "Other", "severity": "Urgent", "comment": { "text": "We are receiving a ton of traffic, we need more servers!" "attachments": [ { "filename": "server.log", "uuid": "1234-server.log" }, { "filename": "database.log", "uuid": "1234-database.log" } ] }, "recipients": [ "RPN-3322-23" ], "resources": [ "https://resources.api.rackspace.com/resources/dedicated:00001", "https://resources.api.rackspace.com/resources/dedicated:0002" ] }
响应参数
响应有下列体参数:
名称 | 类型 | 描述性 |
---|---|---|
门票Id | 字符串 | UUID票 |
记账Id | 字符串 | ID账户创建 |
题材 | 字符串 | 题目列票 |
状态 | 字符串 | 状态票 |
严重性 | 字符串 | 问题的严重性可用片段低频 ,常态 ,高位 ,紧急事件 并紧急事件 . |
资源类 | 字符串 | URL受问题影响的资源 票描述 |
类别 | 字符串 | 类别名类别划分账号 ,计费支付 ,请求信息 ,变换 并事件处理 . |
子类 | 字符串 | 子类名只有一个子类概论 . |
创建 | 字符串 | 日期时间创建 |
修改后 | 字符串 | 日期时间最后一次更新 |
修改By | 对象类 | 用户最后一次修改票, 典型地这是最后一个用户对票表示评论 |
修改By.id | 字符串 | 华体会联盟hthRackspace人数评分器RPN上位修改票者为racker时此为空 。 |
修改Byname | 字符串 | 或账号用户名 或鼠标名 和最后首字母 |
modifiedBy.roles | 链表 | 角色分配用户谁最后一次修改票这是小学 ,行政类 或技术类 上个修改由账号用户或鼠标 华体会联盟hthif ticket上由rackspace修改 |
修改By类型 | 链表 | 用户类型 上修改票, 这是或客户端 或机架 . |
创建By | 对象类 | 用户创建票 |
创建By.id | 字符串 | 华体会联盟hthRackspace人数评分器RPN华体会联盟hth空票由 Rackspace创建 |
创建By.name | 字符串 | 或帐号用户名或创建票的racker名和末名 |
创建By.函数 | 链表 | 角色分配用户创建票这是小学 ,行政类 或技术类 由账号用户创建或鼠标 华体会联盟hthif ticket由rackspace创建 |
创建By类型 | 链表 | 类型用户创建票,这是或客户端 或机架 . |
注释 | 链表 | 所有评论都关连到门票 |
objective.id | 字符串 | 个人注释标识 |
注释. text | 字符串 | 文本内容注释 |
comments.created | 字符串 | 日期和时间注释创建 |
注释编写者 | 对象类 | 资料编写者评论 |
comments.author.id | 字符串 | 华体会联盟hthRackspace人数评分器RPN华体会联盟hth空票由 Rackspace创建 |
comments.author.name | 字符串 | 或帐号用户名或创建票的racker名和末名 |
comments.author.roles | 链表 | 角色分配用户创建票这是小学 ,行政类 或技术类 由账号用户创建或鼠标 华体会联盟hthif ticket由rackspace创建 |
comments.author.type | 链表 | 类型用户创建票,这是或客户端 或机架 . |
comment.attachments | 对象设置 | 附加注释 |
comment.attachments.filename | 字符串 | 名附属文件 |
comment.attachments.uuid | 字符串 | UUID附属文件 |
comment.attachments.upload_url | 字符串 | 上传附加文件url |
comment.attachments.url | 字符串 | url附属文件 |
分类法 | 字符串 | 门票分类分类法服务请求 ,变换 并事件处理 . |
接收者 | 对象设置 | 列表所有接收者通知门票 |
接受者类型 | 字符串 | 类型接收者接触 |
recipients.value | 字符串 | 接收者接触值 |
响应示例
下示例显示JSON响应请求
3ketld:123456,ccountld:faws:12345华体会联盟hthWe need more servers!", "status": "In Progess", "severity": "Normal", "resources": [], "category": "Incident", "subcategory": "Other", "created": "2018-04-03T16:44:27.644Z", "modified": "2018-04-03T16:44:27.644Z", "modifiedBy": { "id": "12344", "name": "Billing User", "roles": [ "billing" ], "type": "customer" }, "createdBy": { "id": "", "name": "Rackspace R.", "roles": [ "racker" ], "type": "racker" }, "comments": [ { "text": "We are receiving a ton of traffic, we need more servers!", "id": "170503-abc-0000001", "author": { "id": "2344567", "name": "Billing User", "roles": [ "billing" ], "type": "customer" }, "attachments": [ { "uuid": "123465-storage.log", "upload_url": "https://storage101.ord1.clouddrive.com/v1/MossoCloudFS_9872494b-6265-40fe-a03b-502f2caca50d/c46b/c46b6c66-3619-11e8-9168-0050561a016d?temp_url_expires=1522638093&temp_url_sig=7bfb1d35ded258906e4b03c789ae36c8e5e80089", "filename": "storage.log" }, { "uuid": "123465-database.log", "upload_url": "https://storage101.ord1.clouddrive.com/v1/MossoCloudFS_9872494b-6265-40fe-a03b-502f2caca50d/c46b/c46b6c66-3619-11e8-9168-0050561a016d?temp_url_expires=1522638093&temp_url_sig=7bfb1d35ded258906e4b03c789ae36c8e5e80089", "filename": "database.log" } ] "created": "2018-04-03T16:44:27.644Z" }, { "text": "We are on it!", "id": "170503-abc-0000002", "author": { "id": "", "name": "Rackspace R.", "roles": [ "racker" ], "type": "racker" }, "created": "2018-04-03T16:45:27.644Z" } ], "recipients": [ { "type": "email", "value": "email.com" }, { "type": "contact", "value": "RPN-123-129e" } ], }
响应代码
操作可有下列响应码:
代码解析 | 名称 | 描述性 |
---|---|---|
二百 | 成功经验 | 请求成功 |
429 | 多请求 | 程序内置速率限制为每分钟请求一分超出此限值后,收到429状态代码响应,直到冷淡周期结束 |
补丁票
PATCH/Ticket/{ticketId}
Content-Type: application/vnd.ticketing.v2+json
Accept: application/vnd.ticketing.v2+json
更新入站票状态或更新入站票资源
成功响应返回响应代码204,即操作成功完成可依据请求更新本地记录,但更新由云源播送
注解
华体会联盟hthRackspace推荐Patch HTTP方法用户使用PUT方法兼容性问题
请求参数
请求有下列URI参数
名称 | 类型 | 描述性 |
---|---|---|
门票Id | 字符串(必备) | 票牌ID存储 通过TicketingAPI |
请求有下列体参数:
名称 | 类型 | 描述性 |
---|---|---|
状态 | 字符串 | 更新状态关闭票唯一选择闭合 . |
资源类 | 数组 | 更新开机票资源选项用请求主体替换现有资源 |
请求示例
下示例显示JSON请求
-
- 更新票状状态
{状态:关闭}
-
- 更新入场券资源
请求删除已有资源并添加请求主体传递的资源需要保留老资源时 需在请求体内清晰传递
比方说5资源已存入票内,而现在我们只寄出2资源载荷中,我们只需保留传递资源载荷并删除现有资源,而不论与旧资源相同或不同。
- 更新入场券资源
华体会联盟hth{资源s/stage.ress.api.rackspace.com/resources/de
响应示例
下示例显示响应代码204(无内容)请求响应
HTTP/1.1204 无内容
内容链度:0
内容类型:应用/json
日期:Thu2017年11月1日
下示例显示JSON响应码404请求
{状态:404/消息/故障/#ticknotfound}
响应代码
操作可有下列响应码:
代码解析 | 描述性 |
---|---|
二百 | 请求成功 |
404 | 未找到票 |
429 | 程序内置速率限制为5分钟请求超出此限值后,收到429状态代码响应,直到冷淡周期结束 |
邮票注释
POST /tickets/{ticketId}/comments
Content-Type: application/vnd.ticketing.v2+json
Accept: application/vnd.ticketing.v2+json
添加注释更新票
成功响应返回响应代码204,即操作成功完成可依据请求更新本地记录,但更新信息通过云源播送
请求参数
请求有下列URI参数
名称 | 类型 | 描述性 |
---|---|---|
门票Id | 字符串(必备) | 票牌ID存储 通过TicketingAPI |
添加注释请求有下列体参数:
名称 | 类型 | 描述性 |
---|---|---|
注释 | 对象类 | 关于票中描述问题的评论 |
注释.text | 字符串(必备) | 注释提供当前支持请求状态 |
comment.attachments | 对象设置 | 附加注释 |
comment.attachments.filename | 字符串 | 名附属文件 |
comment.attachments.uuid | 字符串 | UUID附属文件 |
注解
华体会联盟hth关联附加注释时,用户优先上传附加注释上传附件请参考附加文件
请求示例
下示例显示JSON请求加注入票
{ "comment": { "text": "Any updates on the new servers?", "attachments": [ { "filename": "server.log", "uuid": "1234-server.log" }, { "filename": "database.log", "uuid": "1234-database.log" } ] } }
响应示例
下示例显示响应代码204(无内容)请求响应
HTTP/1.1204 无内容
内容链度:0
内容类型:应用/json
日期:Thu2017年11月1日
下示例显示JSON响应码404请求
{状态:404/消息/故障/#ticknotfound}
响应代码
操作可有下列响应码:
代码解析 | 名称 | 描述性 |
---|---|---|
二百 | 成功经验 | 请求成功 |
404 | 未找到 | 未找到票 |
429 | 多请求 | 程序内置速率限制为5分钟请求超出此限值后,收到429状态代码响应,直到冷淡周期结束 |