17.6 監査ログの転送先情報を取得する
実行権限
監査ログ管理者(参照)
リクエストライン
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