ニフクラAPI (RDB: DescribeUserActivities)

DescribeUserActivities

処理概要

RDBの利用履歴の情報を取得します。
マルチアカウントの子アカウントでは、自身の利用履歴のみ取得されます。
取得開始位置は1が最新レコードとなります。
本APIのみタイムゾーンはJSTです。
取得されるのは、2026年1月13日～1月15日以降のHTTPステータスコード 200（成功）のAPI実行のログです。
取得開始が可能な日は、リージョンによって異なります。
2026年1月16日以降、RDBの利用が可能になったリージョンは提供開始日から取得できます。

• 2026年1月13日：east-2, east-3, jp-east-4, west-1
• 2026年1月15日：east-1

指定するパラメーター

パラメーター	型	説明	必須
YearMonth	string	取得対象年月 ※5か月前から当月まで指定可能 ※形式 : yyyymm | yyyy-mm | yyyy/mm	○
Range.StartNumber	integer	取得開始位置 Default: 1 使用可能文字: 1〜2147483647
Range.EndNumber	integer	取得終了位置 Default: 1000 使用可能文字: 1〜2147483647

応答フィールド

フィールド (項目)	型	説明
DescribeUserActivitiesResponse	-	ルート
␣DescribeUserActivitiesResult	-	結果
␣␣UserActivitiesSet	-	ログ情報セット
␣␣␣Item	-	ログ情報
␣␣␣␣DateTime	timestamp	日時
␣␣␣␣IpAddress	string	実行元IPアドレス
␣␣␣␣CategoryName	string	カテゴリ名
␣␣␣␣Operator	string	実行者
␣␣␣␣Operation	string	操作内容
␣␣␣␣Result	boolean	実行結果 値: true (正常) false (異常)
␣␣␣␣Uuid	string	※空を返却
␣␣␣␣ServiceId	string	※空を返却
␣ResponseMetadata	structure	共通メタ情報
␣␣RequestId	string	リクエスト識別子

エラー

コード	メッセージ	タイプ	HTTPステータスコード	説明
Client.InvalidParameterIllegalInput.YearMonth	YearMonth is invalid.	Sender	400	YearMonthに不正な値を指定した場合
Client.InvalidParameterIllegalInput.Range.StartNumber	Range.StartNumber is invalid.	Sender	400	Range.StartNumberに不正な値を指定した場合 1－2147483647でない値を指定した場合
Client.InvalidParameterIllegalInput.Range.EndNumber	Range.EndNumber is invalid.	Sender	400	Range.EndNumberに不正な値を指定した場合 1－2147483647でない値を指定した場合
Client.InvalidParameterCombination.Range.StartNumber.and.Range.EndNumber	The parameter Range.EndNumber must be greater than Range.StartNumber.	Sender	400	Range.StartNumberにRange.EndNumberより大きい値を指定した場合
Client.InvalidParameterRequired.YearMonth	YearMonth is required.	Sender	400	必須のYearMonthを指定しなかった場合
Client.InvalidParameterOutOfRange.YearMonth	The specified YearMonth is out of range. YearMonth must be from 5 months ago to the current month.	Sender	400	YearMonthに5か月より前、または翌月以降の値を指定した場合
Client.InvalidParameterOutOfRange.Range.StartNumber.and.Range.EndNumber	The range between Range.StartNumber and Range.EndNumber is too large. The maximum range is 1000.	Sender	400	Range.StartNumberとRange.EndNumberの値の範囲が1,000件より大きい場合

リクエストサンプル

    https://jp-east-1.rdb.api.nifcloud.com/
  ?Action=DescribeUserActivities
  &YearMonth=202511
  &Range.StartNumber=1
  &Range.EndNumber=100
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2025-11-07T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

  

応答サンプル

    <DescribeUserActivitiesResponse>
    <DescribeUserActivitiesResult>
      <UserActivitiesSet>
        <Item>
          <DateTime>2025-11-06T14:18:17.000+09:00</DateTime>
          <IpAddress>111.11.111.11</IpAddress>
          <CategoryName>API（DBサーバー）</CategoryName>
          <Operator>XXX00001</Operator>
          <Operation>RebootDBInstance[DBInstanceIdentifier:testdb]</Operation>
          <Result>true</Result>
          <Uuid/>
          <ServiceId/>
        </Item>
    </UserActivitiesSet>
  </DescribeUserActivitiesResult>
  <ResponseMetadata>
    <RequestId>4838a0d1-e2ff-4da9-b675-0e3f9eb21c10</RequestId>
  </ResponseMetadata>
</DescribeUserActivitiesResponse>