Anda dapat memanggil operasi DescribeEvents untuk mengkueri event historis dari instans ApsaraDB RDS.
Fitur riwayat event memungkinkan Anda melihat event yang terjadi di suatu Wilayah selama rentang waktu tertentu. Event historis mencakup pembuatan instans dan modifikasi parameter. Untuk informasi selengkapnya, lihat Lihat riwayat event instans ApsaraDB RDS.
Sebelum memanggil operasi ini, pastikan fitur riwayat event telah diaktifkan. Jika tidak, operasi ini akan gagal.
Debugging
Parameter permintaan
| Parameter | Type | Required | Contoh | Description |
| Action | String | Yes | DescribeEvents | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeEvents. |
| RegionId | String | Yes | cn-hangzhou | ID Wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID Wilayah. |
| StartTime | String | No | 2019-06-11T15:00:00Z | Awal rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. |
| EndTime | String | No | 2019-06-12T15:00:00Z | Akhir rentang waktu untuk dikueri. Waktu akhir harus lebih baru daripada waktu mulai. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. |
| PageSize | Integer | No | 30 | Jumlah entri yang ditampilkan per halaman. Nilai yang valid:
Nilai default: 30. |
| PageNumber | Integer | No | 1 | Nomor halaman yang ditampilkan. Nilai yang valid: bilangan bulat positif bukan nol apa pun. Nilai default: 1. |
Parameter respons
| Parameter | Type | Contoh | Description |
| PageNumber | Integer | 1 | Nomor halaman yang dikembalikan. |
| RequestId | String | A103039D-B1B2-4C57-B989-7D7C0DA95426 | ID permintaan. |
| PageSize | Integer | 30 | Jumlah entri yang dikembalikan per halaman. |
| TotalRecordCount | Integer | 40 | Total jumlah entri yang dikembalikan. |
| EventItems | Array of EventItems | Detail event. |
|
| EventItems | |||
| EventName | String | ModifySecurityIPList | Nama event. Untuk informasi selengkapnya, lihat Lihat riwayat event instans ApsaraDB RDS. |
| EventTime | String | 2019-08-20T01:08:22Z | Waktu terjadinya event. |
| EventUserType | String | SYSTEM | Jenis pengguna yang menjalankan event. |
| EventRecordTime | String | 2019-08-20T01:12:49Z | Waktu pencatatan event. Waktu ini sedikit lebih baru daripada waktu terjadinya event. |
| CallerUid | Long | 22973492********** | ID pengguna yang menjalankan event. |
| RegionId | String | cn-hangzhou | ID wilayah instance tersebut. |
| EventId | Integer | 11000053 | ID event. |
| EventType | String | NetworkManagement | Jenis event. Untuk informasi selengkapnya, lihat Lihat riwayat event instans ApsaraDB RDS. |
| ResourceType | String | instance | Jenis resource yang terkait dengan event. Hanya instans yang didukung untuk parameter ini. |
| EventPayload | String | {\"Domain\": \"rds-inc-share.aliyuncs.com\", \"Api\": \"ReleaseInstancePublicConnection\"} | Parameter permintaan atau konteks event. |
| EventReason | String | FROM_USER | Sumber event. Untuk informasi selengkapnya, lihat Lihat riwayat event instans ApsaraDB RDS. |
| ResourceName | String | rm-bp1z3065m9976ix8a | Nama resource yang terkait dengan event. Hanya ID instans yang didukung untuk parameter ini. |
Contoh
Contoh permintaan
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>
Contoh respons sukses
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"
}
Kode kesalahan
| Kode status HTTP | Kode kesalahan | Pesan kesalahan | Description |
| 400 | InvalidStartTime.Format | Specified start time is not valid. | Pesan kesalahan yang dikembalikan karena waktu mulai yang ditentukan tidak valid. |
| 400 | InvalidParameterCombination | The end time must be greater than the start time | Pesan kesalahan yang dikembalikan karena waktu akhir harus lebih baru daripada waktu mulai. |
| 400 | RegionNotSupport | The region is not supported. | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung di Wilayah tersebut. |
Untuk daftar kode kesalahan, kunjungi API Error Center.