WindowsAuditLogConfiguration - Amazon FSx
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

WindowsAuditLogConfiguration

The configuration that Amazon FSx for Windows File Server uses to audit and log user accesses of files, folders, and file shares on the Amazon FSx for Windows File Server file system. For more information, see File access auditing.

Contents

AuditLogDestination

The Amazon Resource Name (ARN) for the destination of the audit logs. The destination can be any Amazon CloudWatch Logs log group ARN or Amazon Kinesis Data Firehose delivery stream ARN.

The name of the Amazon CloudWatch Logs log group must begin with the /aws/fsx prefix. The name of the Amazon Kinesis Data Firehouse delivery stream must begin with the aws-fsx prefix.

The destination ARN (either CloudWatch Logs log group or Kinesis Data Firehose delivery stream) must be in the same Amazon partition, Amazon Web Services Region, and Amazon Web Services account as your Amazon FSx file system.

Type: String

Length Constraints: Minimum length of 8. Maximum length of 1024.

Pattern: ^arn:[^:]{1,63}:[^:]{0,63}:[^:]{0,63}:(?:|\d{12}):[^/].{0,1023}$

Required: No

FileAccessAuditLogLevel

Sets which attempt type is logged by Amazon FSx for file and folder accesses.

  • SUCCESS_ONLY - only successful attempts to access files or folders are logged.

  • FAILURE_ONLY - only failed attempts to access files or folders are logged.

  • SUCCESS_AND_FAILURE - both successful attempts and failed attempts to access files or folders are logged.

  • DISABLED - access auditing of files and folders is turned off.

Type: String

Valid Values: DISABLED | SUCCESS_ONLY | FAILURE_ONLY | SUCCESS_AND_FAILURE

Required: Yes

FileShareAccessAuditLogLevel

Sets which attempt type is logged by Amazon FSx for file share accesses.

  • SUCCESS_ONLY - only successful attempts to access file shares are logged.

  • FAILURE_ONLY - only failed attempts to access file shares are logged.

  • SUCCESS_AND_FAILURE - both successful attempts and failed attempts to access file shares are logged.

  • DISABLED - access auditing of file shares is turned off.

Type: String

Valid Values: DISABLED | SUCCESS_ONLY | FAILURE_ONLY | SUCCESS_AND_FAILURE

Required: Yes

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: