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

# DescribeEvents
<a name="API_DescribeEvents"></a>

傳回過去 14 天內與執行個體、安全群組、快照和資料庫參數群組相關的事件。您可以提供名稱做為參數，以取得特定資料庫執行個體、安全群組、快照或參數群組的特定事件。根據預設，會傳回過去一小時的事件。

## 請求參數
<a name="API_DescribeEvents_RequestParameters"></a>

 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。

 ** Duration **   
擷取事件的分鐘數。  
預設：60  
類型：整數  
必要：否

 ** EndTime **   
 擷取事件的時間間隔終點，以 ISO 8601 格式指定。  
範例：2009-07-08T18:00Z  
類型：Timestamp  
必要：否

 **EventCategories.EventCategory.N**   
觸發事件通知訂閱通知的事件類別清單。  
類型：字串陣列  
必要：否

 **Filters.Filter.N**   
目前不支援此參數。  
類型：[Filter](API_Filter.md) 物件陣列  
必要：否

 ** 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  
必要：否

## 回應元素
<a name="API_DescribeEvents_ResponseElements"></a>

服務會傳回下列元素。

 **Events.Event.N**   
一或多個事件的詳細資訊。  
類型：[Event](API_Event.md) 物件陣列

 ** Marker **   
前一個請求提供的選用分頁字符。若指定此參數，則回應只會包含超過標記的記錄，直到 `MaxRecords` 指定的值為止。  
類型：字串

## 錯誤
<a name="API_DescribeEvents_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。

## 另請參閱
<a name="API_DescribeEvents_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeEvents) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeEvents) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeEvents) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeEvents) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeEvents) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeEvents) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeEvents) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeEvents) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeEvents) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeEvents)