本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
DescribeEvents
傳回過去 14 天內與執行個體、安全群組、快照和資料庫參數群組相關的事件。您可以透過提供名稱作為參數,以取得特定資料庫執行個體、安全群組、快照或參數群組特有的事件。依預設,會傳回過去一小時的事件。
請求參數
如需所有動作的一般參數資訊,請參閱《Common Parameters》。
- Duration
-
擷取事件的分鐘數。
預設:60
類型:整數
必要:否
- EndTime
-
擷取事件的時間間隔終點,以 ISO 8601 格式指定。
範例:2009-07-08T18:00Z
類型:Timestamp
必要:否
- EventCategories。 EventCategory.N
-
觸發事件通知訂閱通知的事件類別清單。
類型:字串陣列
必要:否
- 篩選器. N
-
目前不支援此參數。
類型:Filter 物件陣列
必要:否
- Marker
-
前一個請求提供的選用分頁字符。若指定此參數,則回應只會包含超過標記的記錄,直到
MaxRecords
指定的值為止。類型:字串
必要:否
- MaxRecords
-
要在回應中包含的記錄數量上限。如果存在的記錄多於指定
MaxRecords
值,則響應中包含分頁令牌(標記),以便可以檢索剩餘的結果。預設:100
限制條件:最小 20,最大 100。
類型:整數
必要:否
- SourceIdentifier
-
要傳回其事件的事件來源識別碼。如未指定,回應中會包含所有來源。
約束:
-
如果
SourceIdentifier
有提供,也SourceType
必須提供。 -
如果來源類型為
DBInstance
,則DBInstanceIdentifier
必須提供。 -
如果來源類型為
DBSecurityGroup
,則DBSecurityGroupName
必須提供。 -
如果來源類型為
DBParameterGroup
,則DBParameterGroupName
必須提供。 -
如果來源類型為
DBSnapshot
,則DBSnapshotIdentifier
必須提供。 -
不能以連字號結尾或連續包含兩個連字號。
類型:字串
必要:否
-
- SourceType
-
事件擷取來源的事件來源。如未指定任何值,則會傳回所有事件。
類型:字串
有效值:
db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot
必要:否
- StartTime
-
擷取事件的時間間隔起點,以 ISO 8601 格式指定。
範例:2009-07-08T18:00Z
類型:Timestamp
必要:否
回應元素
服務會傳回下列元素。
- 活動事件 N
-
有關一個或多個事件的詳細信息。
類型:Event 物件陣列
- Marker
-
前一個請求提供的選用分頁字符。若指定此參數,則回應只會包含超過標記的記錄,直到
MaxRecords
指定的值為止。類型:字串
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: