Chame a operação DescribeEvents para consultar os eventos históricos de uma instância do ApsaraDB RDS.
O recurso de histórico de eventos permite visualizar os eventos ocorridos em uma região durante um intervalo de tempo específico. Os eventos históricos incluem a criação de instâncias e a modificação de parâmetros. Para obter mais informações, consulte Visualizar o histórico de eventos de uma instância do ApsaraDB RDS.
Antes de chamar esta operação, verifique se o recurso de histórico de eventos está ativado. Caso contrário, a operação falhará.
Debugging
Parâmetros de requisição
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | DescribeEvents | A operação a ser executada. Defina o valor como DescribeEvents. |
| RegionId | String | Yes | cn-hangzhou | O ID da região da instância. Chame a operação DescribeRegions para consultar os IDs das regiões. |
| StartTime | String | No | 2019-06-11T15:00:00Z | O início do intervalo de tempo a consultar. Especifique o horário no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. |
| EndTime | String | No | 2019-06-12T15:00:00Z | O fim do intervalo de tempo a consultar. O horário de término deve ser posterior ao horário de início. Especifique o horário no padrão ISO 8601, no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. |
| PageSize | Integer | No | 30 | O número de entradas a retornar por página. Valores válidos:
Valor padrão: 30. |
| PageNumber | Integer | No | 1 | O número da página a retornar. Valores válidos: qualquer inteiro positivo diferente de zero. Valor padrão: 1. |
Parâmetros de resposta
|
Parameter |
Type |
Example |
Description |
|
PageNumber |
Integer |
1 |
O número da página retornada. |
|
RequestId |
String |
A103039D-B1B2-4C57-B989-7D7C0DA95426 |
O ID da requisição. |
|
PageSize |
Integer |
30 |
O número de entradas retornadas por página. |
|
TotalRecordCount |
Integer |
40 |
O número total de entradas retornadas. |
|
EventItems |
Array of EventItems |
Os detalhes dos eventos. |
|
|
EventItems |
|||
|
EventName |
String |
ModifySecurityIPList |
O nome do evento. Para obter mais informações, consulte Visualizar o histórico de eventos de uma instância do ApsaraDB RDS. |
|
EventTime |
String |
2019-08-20T01:08:22Z |
O horário em que o evento ocorreu. |
|
EventUserType |
String |
SYSTEM |
O tipo do usuário que executou o evento. |
|
EventRecordTime |
String |
2019-08-20T01:12:49Z |
O horário em que o evento foi registrado. Esse horário é ligeiramente posterior ao horário em que o evento ocorreu. |
|
CallerUid |
Long |
22973492 |
O ID do usuário que executou o evento. |
|
RegionId |
String |
cn-hangzhou |
O ID da região da instância. |
|
EventId |
Integer |
11000053 |
O ID do evento. |
|
EventType |
String |
NetworkManagement |
O tipo do evento. Para obter mais informações, consulte Visualizar o histórico de eventos de uma instância do ApsaraDB RDS. |
|
ResourceType |
String |
instance |
O tipo do recurso associado ao evento. Apenas instâncias são compatíveis com este parâmetro. |
|
EventPayload |
String |
{\"Domain\": \"rds-inc-share.aliyuncs.com\", \"Api\": \"ReleaseInstancePublicConnection\"} |
Os parâmetros de requisição ou contexto do evento. |
|
EventReason |
String |
FROM_USER |
A origem do evento. Para obter mais informações, consulte Visualizar o histórico de eventos de uma instância do ApsaraDB RDS. |
|
ResourceName |
String |
rm-bp1z3065m9976ix8a |
O nome do recurso associado ao evento. Apenas IDs de instâncias são compatíveis com este parâmetro. |
Exemplos
Exemplos de requisição
http(s)://rds.aliyuncs.com/?Action=DescribeEvents
&Region=cn-hangzhou
&StartTime=2019-08-20T01:30:00Z
&EndTime=2019-08-20T01:35:00Z
&<Common request parameters>Exemplos de resposta bem-sucedida
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeEventsResponse>
<EventItems>
<EventItems>
<EventName>ModifySecurityIPList</EventName>
<EventUserType>SYSTEM</EventUserType>
<ResourceType>instance</ResourceType>
<EventPayload/>
<EventTime>2019-08-20T01:33:43Z</EventTime>
<RegionId>cn-hangzhou</RegionId>
<EventRecordTime>2019-08-20T01:33:57Z</EventRecordTime>
<EventReason>FROM_SYSTEM</EventReason>
<EventId>11000048</EventId>
<ResourceName>rm-bpxxxxxxx</ResourceName>
<EventType>SecurityManagement</EventType>
<CallerUid>25421491**********</CallerUid>
</EventItems>
<EventItems>
<EventName>ModifySecurityIPList</EventName>
<EventUserType>SYSTEM</EventUserType>
<ResourceType>instance</ResourceType>
<EventPayload/>
<EventTime>2019-08-20T01:33:43Z</EventTime>
<RegionId>cn-hangzhou</RegionId>
<EventRecordTime>2019-08-20T01:33:57Z</EventRecordTime>
<EventReason>FROM_SYSTEM</EventReason>
<EventId>11000047</EventId>
<ResourceName>rm-bpxxxxxxx</ResourceName>
<EventType>SecurityManagement</EventType>
<CallerUid>22973492**********</CallerUid>
</EventItems>
</EventItems>
<TotalRecordCount>2</TotalRecordCount>
<PageNumber>1</PageNumber>
<PageSize>2</PageSize>
<RequestId>B5FF9EE6-830E-4DBE-8498-9890A62D2875</RequestId>
</DescribeEventsResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"EventItems" : {
"EventItems" : [ {
"EventName" : "ModifySecurityIPList",
"EventUserType" : "SYSTEM",
"ResourceType" : "instance",
"EventPayload" : "",
"EventTime" : "2019-08-20T01:33:43Z",
"RegionId" : "cn-hangzhou",
"EventRecordTime" : "2019-08-20T01:33:57Z",
"EventReason" : "FROM_SYSTEM",
"EventId" : 11000048,
"ResourceName" : "rm-bpxxxxxxx",
"EventType" : "SecurityManagement",
"CallerUid" : "25421491**********"
}, {
"EventName" : "ModifySecurityIPList",
"EventUserType" : "SYSTEM",
"ResourceType" : "instance",
"EventPayload" : "",
"EventTime" : "2019-08-20T01:33:43Z",
"RegionId" : "cn-hangzhou",
"EventRecordTime" : "2019-08-20T01:33:57Z",
"EventReason" : "FROM_SYSTEM",
"EventId" : 11000047,
"ResourceName" : "rm-bpxxxxxxx",
"EventType" : "SecurityManagement",
"CallerUid" : "22973492**********"
} ]
},
"TotalRecordCount" : 2,
"PageNumber" : 1,
"PageSize" : 2,
"RequestId" : "B5FF9EE6-830E-4DBE-8498-9890A62D2875"
}Códigos de erro
|
HTTP status code |
Error code |
Error message |
Description |
|
400 |
InvalidStartTime.Format |
Specified start time is not valid. |
O horário de início especificado é inválido. |
|
400 |
InvalidParameterCombination |
The end time must be greater than the start time |
O horário de término deve ser posterior ao horário de início. |
|
400 |
RegionNotSupport |
The region is not supported. |
A operação não é compatível com a região especificada. |
Para obter a lista de códigos de erro, acesse o API Error Center.