This is an archive version of the document. To get the most up-to-date information, see the current version.Creating Audit Items
You can create an audit item, that is, select a user or group for audit. Veeam Backup for Microsoft Office 365 will send audit notifications for operations performed by the specified users and users of the specified groups.
Request
POST https://<hostname>:4443/v5/Organizations/{organizationId}/AuditItems |
Request Headers
The request header must contain an authorization token of the current session.
Request Parameters
The following parameter must be specified in the URL of the request:
Parameter | Type | Description |
|---|---|---|
organizationId | string | Specifies the identification number of the Office 365 organization. For more information on how to get this parameter, see Getting Organizations. |
Request Body
The following table lists available request properties:
Property | Type | Description |
|---|---|---|
type | string | Specifies the type of the audit item. Possible values:
|
user | Specifies the user for which Veeam Backup for Microsoft Office 365 will send audit notifications. | |
group | Specifies the group for which Veeam Backup for Microsoft Office 365 will send audit notifications. |
For example:
Request Body: [ { "type": "user", "user": { "id": "a54b55d8-4a07-4755-9889-5001ded697f000000000-0000-0000-0000-000000000000", "displayName": "admin", "name": "admin@abc.onmicrosoft.com", } } ] |
Response
The server returns the following response to the client.
Response Codes
A successfully completed operation returns a response code 200 OK.
Response Headers
The response to this request contains the following headers. The response may also include additional standard HTTPS headers.
Header | Description |
|---|---|
Content-length | The length of the response body. |
Content-type | The media type and syntax of the response body message: application/json; charset=utf-8 |
Response Body
None.
Examples
Example 1
The example shows how to add a user to the list of audit items.
Request: POST https://abc.tech.local:4443/v5/Organizations/967093a9-cf39-43e5-84cb-646ccd4993df/AuditItems
Request Header: Authorization: Bearer <Access-Token>
Request Body: [ { "type": "user", "user": { "id": "a54b55d8-4a07-4755-9889-5001ded697f000000000-0000-0000-0000-000000000000", "displayName": "admin", "name": "admin@abc.onmicrosoft.com", } } ]
Response: 200 OK |