DescribeEvents操作を呼び出して、ApsaraDB RDSインスタンスの履歴イベントを照会できます。

イベント履歴機能を使用すると、特定の時間範囲でリージョン内で発生したイベントを表示できます。 履歴イベントには、インスタンスの作成とパラメータの変更が含まれます。 詳細については、「ApsaraDB RDSインスタンスのイベント履歴の表示」をご参照ください。

この操作を呼び出す前に、イベント履歴機能が有効になっていることを確認してください。 そうでない場合、この操作は失敗します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 DescribeEvents

実行する操作です。 値をDescribeEventsに設定します。

RegionId String 必須 cn-hangzhou

インスタンスのリージョン ID です。 DescribeRegionsを呼び出して、リージョンのIDを照会できます。

StartTime String 任意 2019-06-11T15:00:00Z

クエリする期間の開始時刻です。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

EndTime String 任意 2019-06-12T15:00:00Z

クエリする期間の終了時刻を設定します。 終了時刻は開始時刻よりも後の時刻にする必要があります。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

PageSize Integer いいえ 30

各ページで返されるエントリ数。 有効な値：

  • 30
  • 50
  • 100

既定値： 30.

PageNumber Integer いいえ 1

返されるページ数。 有効値：0 以外の正の整数。

既定値：1

レスポンスパラメーター

項目 データ型 例: 説明　
PageNumber Integer 1

返されたページ数。

RequestId String A103039D-B1B2-4C57-B989-7D7C0DA95426

リクエストの ID です。

PageSize Integer 30

1 ページあたりで返されるエントリ数。

TotalRecordCount Integer 40

返されたエントリの総数。

EventItems EventItemsの配列

イベントの詳細。

EventItems
EventName String ModifySecurityIPList

イベント名。 詳細については、「ApsaraDB RDSインスタンスのイベント履歴の表示」をご参照ください。

EventTime String 2019-08-20T01:08:22Z

イベントが発生した時刻。

EventUserType String SYSTEM

イベントを実行したユーザーのタイプ。

EventRecordTime String 2019-08-20T01:12:49Z

イベントが記録された時刻。 時間は、イベントが発生した時間よりわずかに遅れています。

CallerUid Long 22973492 **********

イベントを実行したユーザーのID。

RegionId String cn-hangzhou

インスタンスのリージョン ID です。

EventId Integer 11000053

イベントの ID。

EventType String ネットワーク管理

イベントのタイプ。 詳細については、「ApsaraDB RDSインスタンスのイベント履歴の表示」をご参照ください。

ResourceType String インスタンス

イベントに関連付けられているリソースのタイプ。 このパラメーターでは、インスタンスのみがサポートされます。

EventPayload String {\"Domain\": \"rds-inc-share.aliyuncs.com\", \"Api\": \"ReleaseInstancePublicConnection\"}

イベントのリクエストまたはコンテキストパラメーター。

EventReason String FROM_USER

イベントの発生源。 詳細については、「ApsaraDB RDSインスタンスのイベント履歴の表示」をご参照ください。

ResourceName String rm-bp1z3065m9976ix8a

イベントに関連付けられているリソースの名前。 このパラメーターでは、インスタンスIDのみがサポートされます。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeEvents
&リージョン=cn-hangzhou
&StartTime=2019-08-20T01:30:00Z
&EndTime=2019-08-20T01:35:00Z
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeEventsResponse>
    <EventItems>
        <EventItems>
            <EventName>ModifySecurityIPList</EventName>
            <EventUserType> システム </EventUserType>
            <ResourceType> インスタンス </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> システム </EventUserType>
            <ResourceType> インスタンス </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>
    <ページ番号> 1 </ PAGENUMBER>
    <PageSize>20</PageSize>
    <RequestId>B5FF9EE6-830E-4DBE-8498-9890A62D2875</RequestId>
</DescribeEventsResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "EventItems" : {
    "EventItems" : [ {
      "EventName" : "ModifySecurityIPList" 、
      "EventUserType" : "SYSTEM" 、
      "ResourceType" : "インスタンス" 、
      "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" : "インスタンス" 、
      "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"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 InvalidStartTime. フォーマット 指定された開始時刻は無効です。 指定された開始時間が無効な場合に返されるエラーメッセージ。
400 InvalidParameterCombination 終了時間は開始時間より大きくなければなりません 終了時刻が開始時刻より後である必要がある場合に返されるエラーメッセージ。
400 RegionNotSupport このリージョンはサポートされていません。 操作がリージョンでサポートされていない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。