Interface ConfluenceRestClientAuditApi
ConfluenceRestClientAuditApi
-
Method Summary
Modifier and TypeMethodDescriptionByte[]GetAuditExportV1(@Nullable String startDate, @Nullable String endDate, @Nullable String searchString, @Nullable String format) GetAuditExportV1 Export audit records Exports audit records as a CSV file or ZIP file.GetAuditRetentionV1 Get retention period Returns the retention period for records in the audit log.GetAuditSinceV1(@Nullable Long number, @Nullable String units, @Nullable String searchString, @Nullable Integer start, @Nullable Integer limit) GetAuditSinceV1 Get audit records for time period Returns records from the audit log, for a time period back from the current date.GetAuditV1(@Nullable String startDate, @Nullable String endDate, @Nullable String searchString, @Nullable Integer start, @Nullable Integer limit) GetAuditV1 Get audit records Returns all records in the audit log, optionally for a certain date range.PostAuditV1(@NotNull AuditRecordCreate payload) PostAuditV1 Create audit record Creates a record in the audit log.PutAuditRetentionV1(@NotNull RetentionPeriod payload) PutAuditRetentionV1 Set retention period Sets the retention period for records in the audit log.
-
Method Details
-
GetAuditV1
AuditRecordArray GetAuditV1(@Nullable @Nullable String startDate, @Nullable @Nullable String endDate, @Nullable @Nullable String searchString, @Nullable @Nullable Integer start, @Nullable @Nullable Integer limit) GetAuditV1 Get audit records Returns all records in the audit log, optionally for a certain date range. This contains information about events like space exports, group membership changes, app installations, etc. For more information, see [Audit log](https://confluence.atlassian.com/confcloud/audit-log-802164269.html) in the Confluence administrator's guide. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission.- Parameters:
startDate- Filters the results to the records on or after the `startDate`. The `startDate` must be specified as [epoch time](https://www.epochconverter.com/) in milliseconds.endDate- Filters the results to the records on or before the `endDate`. The `endDate` must be specified as [epoch time](https://www.epochconverter.com/) in milliseconds.searchString- Filters the results to records that have string property values matching the `searchString`.start- The starting index of the returned records.limit- The maximum number of records to return per page. Note, this may be restricted by fixed system limits.
-
PostAuditV1
PostAuditV1 Create audit record Creates a record in the audit log. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission.- Parameters:
payload- The record to be created in the audit log.
-
GetAuditExportV1
Byte[] GetAuditExportV1(@Nullable @Nullable String startDate, @Nullable @Nullable String endDate, @Nullable @Nullable String searchString, @Nullable @Nullable String format) GetAuditExportV1 Export audit records Exports audit records as a CSV file or ZIP file. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission.- Parameters:
startDate- Filters the exported results to the records on or after the `startDate`. The `startDate` must be specified as [epoch time](https://www.epochconverter.com/) in milliseconds.endDate- Filters the exported results to the records on or before the `endDate`. The `endDate` must be specified as [epoch time](https://www.epochconverter.com/) in milliseconds.searchString- Filters the exported results to records that have string property values matching the `searchString`.format- The format of the export file for the audit records.
-
GetAuditRetentionV1
RetentionPeriod GetAuditRetentionV1()GetAuditRetentionV1 Get retention period Returns the retention period for records in the audit log. The retention period is how long an audit record is kept for, from creation date until it is deleted. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission. -
PutAuditRetentionV1
PutAuditRetentionV1 Set retention period Sets the retention period for records in the audit log. The retention period can be set to a maximum of 1 year. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission.- Parameters:
payload- The updated retention period.
-
GetAuditSinceV1
AuditRecordArray GetAuditSinceV1(@Nullable @Nullable Long number, @Nullable @Nullable String units, @Nullable @Nullable String searchString, @Nullable @Nullable Integer start, @Nullable @Nullable Integer limit) GetAuditSinceV1 Get audit records for time period Returns records from the audit log, for a time period back from the current date. For example, you can use this method to get the last 3 months of records. This contains information about events like space exports, group membership changes, app installations, etc. For more information, see [Audit log](https://confluence.atlassian.com/confcloud/audit-log-802164269.html) in the Confluence administrator's guide. **[Permissions](https://confluence.atlassian.com/x/_AozKw) required**: 'Confluence Administrator' global permission.- Parameters:
number- The number of units for the time period.units- The unit of time that the time period is measured in.searchString- Filters the results to records that have string property values matching the `searchString`.start- The starting index of the returned records.limit- The maximum number of records to return per page. Note, this may be restricted by fixed system limits.
-