GetProblemPreview - 获取故障通知预览

获取故障通知预览。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /problem/preview HTTP/1.1

请求参数

名称类型必填描述示例值
bodyobject

请求 Body。

problemIdlong

故障 ID。

12312
problemNotifyTypestring

通告类型:

  • PROBLEM_NOTIFY:故障通告。
  • PROBLEM_UPDATE:故障更新。
  • PROBLEM_UPGRADE:故障升级。
  • PROBLEM_DEGRADE:故障降级。
  • PROBLEM_RECOVER:故障恢复。
  • PROBLEM_REISSUE:故障补发。
  • PROBLEM_CANCEL:故障取消。
PROBLEM_NOTIFY
problemLevelstring

故障等级。

P2
effectServiceIdsarray

影响服务。

long

影响服务 ID。

1231
relatedServiceIdlong

关联服务 ID。

21312
incidentIdlong

事件 ID。

213123
serviceGroupIdsarray

协同组 ID。

long

服务组 ID。

12313
clientTokenstring

幂等 Token。

4361a0e1-6747-4834-96ce-0c4840f13812

返回参数

名称类型描述示例值
object

响应结构。

requestIdstring

请求 ID。

4361a0e1-6747-4834-96ce-0c2840fd3812
dataobject

降级规则。

problemobject

关联故障。

problemNamestring

故障名称。

故障名称
problemStatusstring

故障状态:

  • HANDLING:处理中。
  • RECOVERED:已恢复。
  • REPLAYING:复盘中。
  • REPLAYED:已复盘。
  • CANCEL:已取消。
HANDLING
problemLevelstring

故障等级递降:

  • P1
  • P2
  • P3
  • P4
P2
discoverTimestring

发现时间。

2021-02-21 00:00:00
recoveryTimestring

恢复时间。

2021-02-21 00:00:00
serviceNamestring

关联服务名称。

服务A
progressSummarystring

进展摘要。

摘要123
preliminaryReasonstring

初步原因。

原因A
mainHandlerNamestring

主要处理人。

小明
mainHandlerIdstring

主要处理人 ID。

231
isManualboolean

是否手动。

true
isUpgradeboolean

是否升级。

true
problemIdlong

故障 ID。

123123
relatedServiceIdlong

关联服务 ID。

213123
createTimestring

创建时间。

2021-02-21 00:00:00
progressSummaryRichTextIdlong

富文本 ID。

12312
coordinationGroupsarray<object>

应急协同组。

coordinationGroupsobject

应急协同组。

serviceGroupNamestring

服务组名称。

服务组A
serviceGroupIdlong

服务 ID。

1231
serviceGroupDescriptionstring

服务组描述。

服务组描述
effectionServicesarray<object>

影响服务。

effectionServicesobject

影响服务。

serviceNamestring

影响服务名称。

服务B
serviceIdlong

影响服务 ID。

1231
voiceobject

语音。

countlong

数量。

12
usersarray<object>

用户组。

usersobject

用户。

usernamestring

用户。

用户名称
mailobject

邮箱。

countlong

数量。

123
usersarray<object>

用户组。

usersobject

用户。

usernamestring

用户名称。

用户名称
smsobject

短信。

countlong

数量。

12
usersarray<object>

用户组。

usersobject

用户。

usernamestring

用户名称。

用户名称
webhookobject

webhook。

countlong

数量。

32
serviceGroupsarray<object>

服务组。

serviceGroupsobject

服务组名称。

serviceNamestring

服务名称。

服务名称
upBeforeDatastring

升级前数据。

最新升级前等级
upAfterDatastring

升级后数据。

最新升级后等级
deBeforeDatastring

降级前数据。

最新降级前等级
deAfterDatastring

降级后数据。

最新降级后等级

示例

正常返回示例

JSON格式

{
  "requestId": "4361a0e1-6747-4834-96ce-0c2840fd3812",
  "data": {
    "problem": {
      "problemName": "故障名称",
      "problemStatus": "HANDLING",
      "problemLevel": "P2",
      "discoverTime": "2021-02-21 00:00:00",
      "recoveryTime": "2021-02-21 00:00:00",
      "serviceName": "服务A",
      "progressSummary": "摘要123",
      "preliminaryReason": "原因A",
      "mainHandlerName": "小明",
      "mainHandlerId": "231",
      "isManual": true,
      "isUpgrade": true,
      "problemId": 123123,
      "relatedServiceId": 213123,
      "createTime": "2021-02-21 00:00:00",
      "progressSummaryRichTextId": 12312,
      "coordinationGroups": [
        {
          "serviceGroupName": "服务组A",
          "serviceGroupId": 1231,
          "serviceGroupDescription": "服务组描述"
        }
      ],
      "effectionServices": [
        {
          "serviceName": "服务B",
          "serviceId": 1231
        }
      ]
    },
    "voice": {
      "count": 12,
      "users": [
        {
          "username": "用户名称"
        }
      ]
    },
    "mail": {
      "count": 123,
      "users": [
        {
          "username": "用户名称"
        }
      ]
    },
    "sms": {
      "count": 12,
      "users": [
        {
          "username": "用户名称"
        }
      ]
    },
    "webhook": {
      "count": 32,
      "serviceGroups": [
        {
          "serviceName": "服务名称"
        }
      ]
    },
    "upBeforeData": "最新升级前等级",
    "upAfterData": "最新升级后等级",
    "deBeforeData": "最新降级前等级",
    "deAfterData": "最新降级后等级"
  }
}

错误码

HTTP status code错误码错误信息描述
404ProblemNotExistedThe problem does not exist.故障不存在

访问错误中心查看更多错误码。