DescribeEvents - Amazon DocumentDB

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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 的詳細資訊,請參閱下列內容: