更新时间:2024-12-10 GMT+08:00
分享

云服务告警查询

功能

查询云服务告警。

SLA项

定义

请求成功率

≥99%

可用性

Tier 2

数据一致性

强一致

吞吐量

60 次/分钟

TP50请求时延

200 ms

TP99.9请求时延

300 ms

注意事项

调用方法

GET

URI

/rest/dataapi/homs/open-api/v1/CloudServiceAlarm/info

路径参数

查询参数

参数

是否必选

类型

值域

描述

cleared

string

告警是否清除:cleared=0未清除,cleared=1已清除。

service_type

string

云服务名称:ECS/EVS。

begin_time

string

毫秒时间戳

开始时间。

end_time

string

毫秒时间戳

结束时间。

page_size

int

0~1000

页大小。

offset_value

int

查询起始值。

请求

  • 请求header参数

    参数

    是否必选

    类型

    值域

    说明

    X-APIG-Appcode

    string

    由SRE分配的AppCode。

    x-auth-token

    string

    调用方APIG的IAM认证token。

    x-hcso-domainid

    是(HCSO场景)

    否(其他场景)

    string

    接入的租户ID。

    x-hcso-appcode

    string

    由SRE分配的AppCode

  • 请求body参数

  • 请求示例
    GET /rest/dataapi/homs/open-api/v1/CloudServiceAlarm/info HTTP/1.1 
    Host: example.com 
    Content-Type: application/json 
    Accept: application/json
    X-APIG-Appcode: xxx 
    x-auth-token: xxx 
    x-hcso-domainid:xxx 
    x-hcso-appcode:xxx

响应

  • 响应参数
    • 响应状态码200:返回Data对象。Data对象包含如下属性:

      参数

      是否必选

      类型

      值域

      说明

      total

      int32

      数据总数量。

      list

      List<Item>

      流程对象。

      Item对象包含如下属性:

      参数

      是否必选

      类型

      值域

      说明

      csn

      string

      告警流水号。

      alarm_name

      string

      告警名称。

      alarm_id

      int32

      告警id。

      severity

      string

      告警级别:1-紧急、2-重要、3-次要、4-提示。

      event_type

      string

      事件类型。

      origin_system_type

      string

      来源系统类型。

      origin_system_name

      string

      来源系统名称。

      moi

      string

      对象标识,告警定位信息。

      additional_information

      string

      附加信息。

      latest_occur_utc

      string

      告警最后发生的UTC时间。

      first_occur_utc

      string

      告警首次发生的UTC时间。

      meName

      string

      告警对应的对象名称。

      count

      string

      告警发生次数。

      probable_cause

      string

      可能原因描述。

      region

      string

      区域名称。

      dc_name

      string

      数据中心名称。

      res_pool_name

      string

      告警上报的POD信息。

      azone_name

      string

      可用分区名称。

      tenant

      string

      所属租户名称。

      nativeMeDn

      string

      告警IP地址。

      moc

      string

      对象类型。

      cleared

      string

      告警是否清除。

      clear_category

      string

      可自动清除。

      clear_utc

      string

      告警清除UTC时间。

      clear_user

      string

      清除人员。

      clear_type

      string

      告警清除类型。

      acked

      string

      告警确认状态:0-未确认、1-已确认。

      ack_user

      string

      确认人员。

      ack_utc

      string

      确认utc时间。

      merge_key

      string

      合并key。

      me_category

      string

      产生告警的云服务。

      me_type

      string

      产生告警的服务。

      product_name

      string

      产生告警的微服务。

      LogicalRegionId

      string

      区域Code。

      serviceAffectedType

      string

      影响业务标识。

      affectedService

      string

      告警所影响的业务名称。

      meDn

      string

      告警对应的对象标识。

  • 响应示例
    HTTP/1.1 200 OK 
    Date:Tue,18 Jul 2023 09:58:01 GMT
    Server: example.com
    Content-Type: application/json;charset=UTF8 
    { 
        "total": "总数", 
        "list": [ 
                 { 
                 "csn": "12346578", 
                 "alarm_name": "告警名称", 
                 "alarm_id": "告警id", 
                 "severity": "告警级别:1-紧急、2-重要、3-次要、4-提示", 
                 "event_type": "事件类型", 
                 "origin_system_type": "来源系统类型", 
                 "origin_system_name": "来源系统名称", 
                 "moi": "对象标识,告警定位信息", 
                 "additional_information": "附加信息", 
                 "latest_occur_utc": "告警最后发生的UTC时间", 
                 "first_occur_utc": "告警首次发生的UTC时间", 
                 "meName": "告警对应的对象名称", 
                 "count": "告警发生次数", 
                 "probable_cause": "可能原因描述", 
                 "region": "区域名称", 
                 "dc_name": "数据中心名称", 
                 "res_pool_name": "告警上报的POD信息", 
                 "azone_name": "可用分区名称", 
                 "tenant": "所属租户名称", 
                 "nativeMeDn": "告警IP地址", 
                 "moc": "对象类型", 
                 "cleared": "告警是否清除", 
                 "clear_category": "可自动清除", 
                 "clear_utc": "告警清除UTC时间", 
                 "clear_user": "清除人员", 
                 "clear_type": "告警清除类型", 
                 "acked": "告警确认状态:0-未确认、1-已确认", 
                 "ack_user": "确认人员", 
                 "ack_utc": "确认utc时间", 
                 "merge_key": "合并key", 
                 "me_category": "产生告警的云服务", 
                 "me_type": "产生告警的服务", 
                 "product_name": "产生告警的微服务", 
                 "LogicalRegionId": "cn-north-201", 
                 "serviceAffectedType": "影响业务标识", 
                 "affectedService": "告警所影响的业务名称", 
                 "meDn": "告警对应的对象标识" 
                  } 
                ] 
    }

状态码

状态码

说明

200

操作成功。

400

参数错误。

401

token鉴权失败。

403

鉴权失败。

404

rest接口未找到。

操作危险级别

Minor

相关文档