diff --git a/docs/api/role-management-v2.md b/docs/api/role-management-v2.md index 9f0376dcee..405b0ef5a9 100644 --- a/docs/api/role-management-v2.md +++ b/docs/api/role-management-v2.md @@ -1,8 +1,8 @@ --- id: role-management-v2 -title: Role Management APIs v2 (Beta) -sidebar_label: Roles -description: Role Management APIs v2 (Beta) allow you to manage roles from HTTP endpoints. +title: Role Management APIs V2 (Beta) +sidebar_label: Roles V2 +description: Role Management APIs V2 (Beta) allow you to manage roles from HTTP endpoints. --- import useBaseUrl from '@docusaurus/useBaseUrl'; @@ -13,7 +13,7 @@ import ApiRoles from '../reuse/api-roles.md';
-Roles determine the functions that users are able to perform in Sumo Logic. The Role Management API (v2) allows you to configure access on partitions and manage roles from HTTP endpoints. +Roles determine the functions that users are able to perform in Sumo Logic. The Role Management API (V2) allows you to configure access on partitions and manage roles from HTTP endpoints. To manage roles, you must have an administrator role or your role must have been assigned the [Manage Users and Roles](/docs/manage/users-roles/) capability. @@ -34,6 +34,46 @@ To manage roles, you must have an administrator role or your role must have been | US1 | https://api.sumologic.com/docs/#tag/roleManagementV2 | | US2 | https://api.us2.sumologic.com/docs/#tag/roleManagementV2 | +## Migrate audit logs queries from Role Management API V1 to V2 + +If you use role-based [audit data filtering](/docs/manage/users-roles/roles/create-manage-roles/#create-a-role), we recommend you migrate the search from V1 to V2 audit logging. + +With advanced search filters added, you can obtain more granular information about the selected role. The `filterPredicate` field in V1 audit logging is replaced with `logAnalyticsFilter`, `auditDataFilter`, and `securityDataFilter` fields in V2. In addition, we have also added `selectionType` and `selectedViews` fields to apply for audit data filtering. + +Currently, Role Management APIs V2 records both the V1 and V2 log line changes. + +:::note +V2 changes are **only** applicable for `RoleUpdate` and `RoleCreated` events. +::: + +