ニフクラAPI (コンピューティング: DescribeSecurityActivities)

DescribeSecurityActivities

処理概要

指定したファイアウォールグループのログ情報を取得します。

ファイアウォールグループを指定するためには、ファイアウォールグループ名が必要です。

ActivityDateに”all”を指定した場合は、Range設定を無視し取得可能な最大件数のログを取得します。
(この場合に返却されるログの件数については 技術仕様/制限値 ファイアウォール：ログ をご参照ください。)

指定するパラメーター

パラメーター	型	説明	必須
GroupName	string	ファイアウォールグループ名	○
ActivityDate	string	取得するログの絞り込み条件（日） Default: 実行日 使用可能文字: yyyymmdd、yyyy-mm-dd、yyyy/mm/dd、all
Range.All	boolean	指定日内のログを全件取得 ActivityDateにallを指定している場合は、Range.Allに指定した値は無効になります。 値: true (全件取得) false (件数指定) Default: false (件数指定)
Range.StartNumber	integer	取得開始件数 ActivityDateにallを指定している場合は、Range.StartNumberに指定した値は無効になります。 Default: 1 (最新) 使用可能文字: 1 - 取得可能な最大件数
Range.EndNumber	integer	取得終了件数 ActivityDateにallを指定している場合は、Range.EndNumberに指定した値は無効になります。 Default: 100 (直近100件目) 使用可能文字: 1 - 取得可能な最大件数

応答フィールド

フィールド (項目)	型	説明
DescribeSecurityActivitiesResponse	-	DescribeSecurityActivities レスポンス
␣requestId	string	リクエスト識別子
␣groupName	string	ファイアウォールグループ名
␣log	string	指定範囲のログ情報(CDATA付)

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=DescribeSecurityActivities
  &GroupName=group01
  &ActivityDate=2011-06-08
  &Range.StartNumber=1
  &Range.EndNumber=30
  &CommonParams

  

応答サンプル

    <DescribeSecurityActivitiesResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <groupName>group01</groupName>
  <log><![CDATA["2011/06/08 08:53:29","xxx(xxxxx)","xxx.xxx.xxx.xxx","xxx.xxx.xxx.xxx"
    "2011/06/08 11:21:53","xxx(XX)","xxx.xxx.xx.xx","xxx.xxx.xxx.xxx"
  ]]></log>
</DescribeSecurityActivitiesResponse>