Getting Audit Items
You can get a list of audit items, that is, a list of users and groups for which Veeam Backup for Microsoft 365 sends audit notifications.
Request
GET https://<hostname>:4443/v6/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 Microsoft 365 organization. For more information on how to get this parameter, see Getting Organizations. |
Request Body
None.
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
In the response body, the server returns a resource representation of the /Organizations/{organizationId}/AuditItems resource. The response body contains the following properties:
Property | Type | Description |
---|---|---|
user | Specifies a user added as an audit item. | |
group | Specifies a group added as an audit item. | |
id | string | Specifies an identification number of the audit item. |
type | string | Specifies the audit item type. The following types are available:
|
_links | Dictionary of string [key] and Object [value] | Links to related resources (navigation property). |
Example
The example returns a resource representation of audit items created in Veeam Backup for Microsoft 365.
Request: GET https://abc.tech.local:4443/v6/Organizations/967093a9-cf39-43e5-84cb-646ccd4993df/AuditItems
Request Header: Authorization: Bearer <Access-Token>
Response: 200 OK
Response Body: [ { "user": { "id": "fac93c3f-9f27-426a-97e6-c607c4610e7200000000-0000-0000-0000-000000000000", "displayName": "Admin", "name": "Admin@abc.onmicrosoft.com", "type": "User", "locationType": "Cloud", "_links": {} }, "id": "a581ee43-e944-4976-8bf1-2f7479ab918efac93c3f-9f27-426a-97e6-c607c4610e7200000000-0000-0000-0000-000000000000", "type": "User", "_links": { "organization": { "href": "/v6/organizations/967093a9-cf39-43e5-84cb-646ccd4993df" }, "user": { "href": "/v6/organizations/967093a9-cf39-43e5-84cb-646ccd4993df/users/fac93c3f-9f27-426a-97e6-c607c4610e7200000000-0000-0000-0000-000000000000" } } } ] |