调用 DescribeEventTypes 接口,查询事件类型列表。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeEventTypes | 要执行的操作,取值:DescribeEventTypes。 |
Version | String | 是 | 2020-04-01 | API的版本,取值:2020-04-01。 |
Kind | String | 否 | StateChange | 系统事件的类别。取值:
|
MaxResults | Integer | 否 | 20 | 分页查询时设置的每页行数。
|
NextToken | String | 否 | -- | 分页查询凭证,用于标记分页的位置,初次调用该接口时无需设置。下次查询时,取值为上一次API调用返回的 |
ResponseRequired | Boolean | 否 | false | 是否需要响应。取值:
|
Types.N | Array of String | 否 | Types.1=DiskError_Redeploy&Types.2=CreateInstance | 系统事件的类型,最多支持100个。
|
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
EventTypes | Array of Object | -- | 实例系统事件信息。 |
NextToken | String | 3tiegs1y963vj0****** | 本次调用返回的查询凭证值,返回为空表示该页为末页。 |
GET /?Action=DescribeEventTypes&Version=2020-04-01&Types.1=DiskError_Redeploy&Types.2=CreateInstance HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing ServiceName: ecs
text
{
"ResponseMetadata": {
"RequestId": "202106111445100102252431000052****",
"Action": "DescribeEventTypes",
"Version": "2020-04-01",
"Service": "ecs",
"Region": "cn-beijing"
},
"Result": {
"EventTypes": [
{
"Type": "DiskError_Redeploy",
"Kind": "UnexpectedOperations",
"Status": [
"Executing",
"Succeeded",
"Failed"
],
"ResponseRequired": "true",
"Title": "硬盘异常,实例重新部署"
},
{
"Type": "CreateInstance",
"Kind": "StateChange",
"Status": [
"Executing",
"Succeeded",
"Failed"
],
"ResponseRequired": "false",
"Title": "创建实例"
}
],
"NextToken": ""
}
}
json
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
---|---|---|
400 | InvalidArgument | 指定的参数不合法。 |
400 | InvalidKind.Malformed | 指定的Kind不合法。 |
400 | InvalidTypes.Malformed | 指定的Types不合法。 |
400 | LimitExceeded.MaximumTypes | 指定的类型数量超过限制。 |
500 | InternalError | 内部错误,请重试。如果多次尝试失败,请提交工单。 |