创建关联
功能介绍
创建关联,一个工单最多支持3个关联
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/servicerequest/cases/{case_id}/relations
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
case_id |
是 |
String |
要关联的工单id 最小长度:1 最大长度:64 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:5000 |
X-Language |
否 |
String |
语言环境,值为通用的语言描述字符串,比如zh-cn等,默认为zh-cn。 会根据语言环境对应展示一些国际化的信息,比如工单类型名称等。 最小长度:1 最大长度:32 |
X-Time-Zone |
否 |
String |
环境时区,值为通用的时区描述字符串,比如GMT+8等,默认为GMT+8。 涉及时间的数据会根据环境时区处理。 最小长度:1 最大长度:32 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
related_id_list |
是 |
Array of strings |
要关联的工单id列表,最多3个 最小长度:1 最大长度:32 数组长度:0 - 3 |
group_id |
是 |
String |
组id 最小长度:1 最大长度:64 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 最小长度:0 最大长度:32 |
error_msg |
String |
错误描述 最小长度:0 最大长度:32 |
请求示例
POST https://{endpoint}/v2/servicerequest/cases/case-123/relations { "related_id_list" : "123456", "group_id" : "123456" }
响应示例
无
状态码
状态码 |
描述 |
---|---|
200 |
成功返回200 |
错误码
请参见错误码。