Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


17.6 監査ログの転送先情報を取得する

ストレージシステムに設定された、監査ログのsyslogサーバへの転送設定の情報を取得します。

実行権限

監査ログ管理者(参照)

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/auditlog-syslog-servers/instance

リクエストメッセージ

オブジェクトID

instanceを指定します。

instanceは、単一のインスタンスしか持たないオブジェクトの場合に、オブジェクトIDとして指定する固定の値です。

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ
{
  "transferProtocol": "TLS",
  "locationName": "836000123456",
  "retries": true,
  "retryInterval": 30,
  "isDetailed": true,
  "primarySyslogServer": {
    "isEnabled": true,
    "ipAddress": "192.0.1.100",
    "port": 12345
  },
  "secondarySyslogServer": {
    "isEnabled": true,
    "ipAddress": "192.0.1.200",
    "port": 12345
  }
}

属性

説明

transferProtocol

string

監査ログをSyslogサーバへ転送する際に使用するプロトコル

  • TLS:TLS1.2/RFC5424
  • UDP:UDP/RFC3164

監査ログの転送先が未設定の場合、ストレージシステムがVSP 5000 シリーズのときはundefinedが、VSP E シリーズVSP Gx00 モデルまたはVSP Fx00 モデルのときはUDPが出力されます。

locationName

string

監査ログ情報の転送元のストレージシステムを識別する名称

retries

boolean

Syslog サーバとの通信に失敗した場合、リトライするかどうか

transferProtocol属性がTLSの場合に表示されます。
  • true:リトライする
  • false:リトライしない

retryInterval

int

Syslog サーバとの通信に失敗した場合のリトライ間隔(秒)

retries属性がtrueの場合に表示されます。

isDetailed

boolean

監査ログの詳細情報をSyslog サーバに転送するかどうか
  • true:詳細情報を転送する
  • false:詳細情報を転送しない

primarySyslogServer

object

プライマリ側のSyslogサーバの設定

プライマリ側のSyslogサーバについて、次の情報が表示されます。
  • isEnabled(boolean)

    Syslogサーバに監査ログを転送するかどうか

    • true:監査ログを転送する
    • false:監査ログを転送しない
  • ipAddress(string)

    IPアドレスまたはホスト名

    isEnabled属性がtrueの場合に表示されます。

  • port(int)

    ポート番号

    isEnabled属性がtrueの場合に表示されます。

secondarySyslogServer

object

セカンダリ側のsyslogサーバの設定

セカンダリ側のSyslogサーバについて、次の情報が表示されます。
  • isEnabled(boolean)

    Syslogサーバに監査ログを転送するかどうか

    • true:監査ログを転送する
    • false:監査ログを転送しない
  • ipAddress(string)

    IPアドレスまたはホスト名

    isEnabled属性がtrueの場合に表示されます。

  • port(int)

    ポート番号

    isEnabled属性がtrueの場合に表示されます。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/auditlog-syslog-servers/instance