Class RolesApi
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic classManage optional parameters to listPermissions.static classManage optional parameters to listRoles.static classManage optional parameters to listRoleUsers. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionaddPermissionToRole(String roleId, RelationshipToPermission body) Grant permission to a role.addPermissionToRoleAsync(String roleId, RelationshipToPermission body) Grant permission to a role.addPermissionToRoleWithHttpInfo(String roleId, RelationshipToPermission body) Adds a permission to a role.Grant permission to a role.addUserToRole(String roleId, RelationshipToUser body) Add a user to a role.addUserToRoleAsync(String roleId, RelationshipToUser body) Add a user to a role.addUserToRoleWithHttpInfo(String roleId, RelationshipToUser body) Adds a user to a role.addUserToRoleWithHttpInfoAsync(String roleId, RelationshipToUser body) Add a user to a role.cloneRole(String roleId, RoleCloneRequest body) Create a new role by cloning an existing role.cloneRoleAsync(String roleId, RoleCloneRequest body) Create a new role by cloning an existing role.cloneRoleWithHttpInfo(String roleId, RoleCloneRequest body) Clone an existing rolecloneRoleWithHttpInfoAsync(String roleId, RoleCloneRequest body) Create a new role by cloning an existing role.createRole(RoleCreateRequest body) Create role.Create role.Create a new role for your organization.Create role.voiddeleteRole(String roleId) Delete role.deleteRoleAsync(String roleId) Delete role.deleteRoleWithHttpInfo(String roleId) Disables a role.deleteRoleWithHttpInfoAsync(String roleId) Delete role.Get the API client.Get a role.getRoleAsync(String roleId) Get a role.getRoleWithHttpInfo(String roleId) Get a role in the organization specified by the role’srole_id.getRoleWithHttpInfoAsync(String roleId) Get a role.List permissions.List permissions.List permissions.List permissions.Returns a list of all permissions, including name, description, and ID.List permissions.listRolePermissions(String roleId) List permissions for a role.listRolePermissionsAsync(String roleId) List permissions for a role.Returns a list of all permissions for a single role.List permissions for a role.List roles.listRoles(RolesApi.ListRolesOptionalParameters parameters) List roles.List roles.listRolesAsync(RolesApi.ListRolesOptionalParameters parameters) List roles.Returns all roles, including their names and their unique identifiers.List roles.List role templates.List role templates.List all role templatesList role templates.listRoleUsers(String roleId) Get all users of a role.listRoleUsers(String roleId, RolesApi.ListRoleUsersOptionalParameters parameters) Get all users of a role.listRoleUsersAsync(String roleId) Get all users of a role.listRoleUsersAsync(String roleId, RolesApi.ListRoleUsersOptionalParameters parameters) Get all users of a role.listRoleUsersWithHttpInfo(String roleId, RolesApi.ListRoleUsersOptionalParameters parameters) Gets all users of a role.listRoleUsersWithHttpInfoAsync(String roleId, RolesApi.ListRoleUsersOptionalParameters parameters) Get all users of a role.removePermissionFromRole(String roleId, RelationshipToPermission body) Revoke permission.removePermissionFromRoleAsync(String roleId, RelationshipToPermission body) Revoke permission.Removes a permission from a role.Revoke permission.removeUserFromRole(String roleId, RelationshipToUser body) Remove a user from a role.removeUserFromRoleAsync(String roleId, RelationshipToUser body) Remove a user from a role.removeUserFromRoleWithHttpInfo(String roleId, RelationshipToUser body) Removes a user from a role.removeUserFromRoleWithHttpInfoAsync(String roleId, RelationshipToUser body) Remove a user from a role.voidsetApiClient(ApiClient apiClient) Set the API client.updateRole(String roleId, RoleUpdateRequest body) Update a role.updateRoleAsync(String roleId, RoleUpdateRequest body) Update a role.updateRoleWithHttpInfo(String roleId, RoleUpdateRequest body) Edit a role.updateRoleWithHttpInfoAsync(String roleId, RoleUpdateRequest body) Update a role.
-
Constructor Details
-
RolesApi
public RolesApi() -
RolesApi
-
-
Method Details
-
getApiClient
Get the API client.- Returns:
- API client
-
setApiClient
Set the API client.- Parameters:
apiClient- an instance of API client
-
addPermissionToRole
public PermissionsResponse addPermissionToRole(String roleId, RelationshipToPermission body) throws ApiException Grant permission to a role.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- PermissionsResponse
- Throws:
ApiException- if fails to make API call
-
addPermissionToRoleAsync
public CompletableFuture<PermissionsResponse> addPermissionToRoleAsync(String roleId, RelationshipToPermission body) Grant permission to a role.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<PermissionsResponse>
-
addPermissionToRoleWithHttpInfo
public ApiResponse<PermissionsResponse> addPermissionToRoleWithHttpInfo(String roleId, RelationshipToPermission body) throws ApiException Adds a permission to a role.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- ApiResponse<PermissionsResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 404 Not found - 429 Too many requests -
-
addPermissionToRoleWithHttpInfoAsync
public CompletableFuture<ApiResponse<PermissionsResponse>> addPermissionToRoleWithHttpInfoAsync(String roleId, RelationshipToPermission body) Grant permission to a role.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<ApiResponse<PermissionsResponse>>
-
addUserToRole
Add a user to a role.See
addUserToRoleWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.RelationshipToUser).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- UsersResponse
- Throws:
ApiException- if fails to make API call
-
addUserToRoleAsync
Add a user to a role.See
addUserToRoleWithHttpInfoAsync(java.lang.String, com.datadog.api.client.v2.model.RelationshipToUser).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<UsersResponse>
-
addUserToRoleWithHttpInfo
public ApiResponse<UsersResponse> addUserToRoleWithHttpInfo(String roleId, RelationshipToUser body) throws ApiException Adds a user to a role.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- ApiResponse<UsersResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 404 Not found - 429 Too many requests -
-
addUserToRoleWithHttpInfoAsync
public CompletableFuture<ApiResponse<UsersResponse>> addUserToRoleWithHttpInfoAsync(String roleId, RelationshipToUser body) Add a user to a role.See
addUserToRoleWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.RelationshipToUser).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<ApiResponse<UsersResponse>>
-
cloneRole
Create a new role by cloning an existing role.See
cloneRoleWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.RoleCloneRequest).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- RoleResponse
- Throws:
ApiException- if fails to make API call
-
cloneRoleAsync
Create a new role by cloning an existing role.See
cloneRoleWithHttpInfoAsync(java.lang.String, com.datadog.api.client.v2.model.RoleCloneRequest).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<RoleResponse>
-
cloneRoleWithHttpInfo
public ApiResponse<RoleResponse> cloneRoleWithHttpInfo(String roleId, RoleCloneRequest body) throws ApiException Clone an existing role- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- ApiResponse<RoleResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 404 Not found - 409 Conflict - 429 Too many requests -
-
cloneRoleWithHttpInfoAsync
public CompletableFuture<ApiResponse<RoleResponse>> cloneRoleWithHttpInfoAsync(String roleId, RoleCloneRequest body) Create a new role by cloning an existing role.See
cloneRoleWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.RoleCloneRequest).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<ApiResponse<RoleResponse>>
-
createRole
- Parameters:
body- (required)- Returns:
- RoleCreateResponse
- Throws:
ApiException- if fails to make API call
-
createRoleAsync
- Parameters:
body- (required)- Returns:
- CompletableFuture<RoleCreateResponse>
-
createRoleWithHttpInfo
public ApiResponse<RoleCreateResponse> createRoleWithHttpInfo(RoleCreateRequest body) throws ApiException Create a new role for your organization.The following read permissions are automatically added to every new role, even if they are not included in the request:
- Dashboards Read
- Notebooks Read
- Monitors Read
- APM Read
- Vulnerability Management Read
- RUM Apps Read
- Incidents Read
- SLOs Read
- CI Visibility Read
- CD Visibility Read
- Parameters:
body- (required)- Returns:
- ApiResponse<RoleCreateResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 429 Too many requests -
-
createRoleWithHttpInfoAsync
public CompletableFuture<ApiResponse<RoleCreateResponse>> createRoleWithHttpInfoAsync(RoleCreateRequest body) - Parameters:
body- (required)- Returns:
- CompletableFuture<ApiResponse<RoleCreateResponse>>
-
deleteRole
Delete role.- Parameters:
roleId- The unique identifier of the role. (required)- Throws:
ApiException- if fails to make API call
-
deleteRoleAsync
Delete role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- CompletableFuture
-
deleteRoleWithHttpInfo
Disables a role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- ApiResponse<Void>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 204 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
deleteRoleWithHttpInfoAsync
Delete role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- CompletableFuture<ApiResponse<Void>>
-
getRole
Get a role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- RoleResponse
- Throws:
ApiException- if fails to make API call
-
getRoleAsync
Get a role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- CompletableFuture<RoleResponse>
-
getRoleWithHttpInfo
Get a role in the organization specified by the role’srole_id.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- ApiResponse<RoleResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
getRoleWithHttpInfoAsync
Get a role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- CompletableFuture<ApiResponse<RoleResponse>>
-
listPermissions
List permissions.- Returns:
- PermissionsResponse
- Throws:
ApiException- if fails to make API call
-
listPermissionsAsync
List permissions.- Returns:
- CompletableFuture<PermissionsResponse>
-
listPermissions
public PermissionsResponse listPermissions(RolesApi.ListPermissionsOptionalParameters parameters) throws ApiException List permissions.- Parameters:
parameters- Optional parameters for the request.- Returns:
- PermissionsResponse
- Throws:
ApiException- if fails to make API call
-
listPermissionsAsync
public CompletableFuture<PermissionsResponse> listPermissionsAsync(RolesApi.ListPermissionsOptionalParameters parameters) List permissions.- Parameters:
parameters- Optional parameters for the request.- Returns:
- CompletableFuture<PermissionsResponse>
-
listPermissionsWithHttpInfo
public ApiResponse<PermissionsResponse> listPermissionsWithHttpInfo(RolesApi.ListPermissionsOptionalParameters parameters) throws ApiException Returns a list of all permissions, including name, description, and ID.- Parameters:
parameters- Optional parameters for the request.- Returns:
- ApiResponse<PermissionsResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 429 Too many requests -
-
listPermissionsWithHttpInfoAsync
public CompletableFuture<ApiResponse<PermissionsResponse>> listPermissionsWithHttpInfoAsync(RolesApi.ListPermissionsOptionalParameters parameters) List permissions.- Parameters:
parameters- Optional parameters for the request.- Returns:
- CompletableFuture<ApiResponse<PermissionsResponse>>
-
listRolePermissions
List permissions for a role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- PermissionsResponse
- Throws:
ApiException- if fails to make API call
-
listRolePermissionsAsync
List permissions for a role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- CompletableFuture<PermissionsResponse>
-
listRolePermissionsWithHttpInfo
public ApiResponse<PermissionsResponse> listRolePermissionsWithHttpInfo(String roleId) throws ApiException Returns a list of all permissions for a single role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- ApiResponse<PermissionsResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
listRolePermissionsWithHttpInfoAsync
public CompletableFuture<ApiResponse<PermissionsResponse>> listRolePermissionsWithHttpInfoAsync(String roleId) List permissions for a role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- CompletableFuture<ApiResponse<PermissionsResponse>>
-
listRoles
List roles.See
listRolesWithHttpInfo(com.datadog.api.client.v2.api.RolesApi.ListRolesOptionalParameters).- Returns:
- RolesResponse
- Throws:
ApiException- if fails to make API call
-
listRolesAsync
List roles.See
listRolesWithHttpInfoAsync(com.datadog.api.client.v2.api.RolesApi.ListRolesOptionalParameters).- Returns:
- CompletableFuture<RolesResponse>
-
listRoles
List roles.See
listRolesWithHttpInfo(com.datadog.api.client.v2.api.RolesApi.ListRolesOptionalParameters).- Parameters:
parameters- Optional parameters for the request.- Returns:
- RolesResponse
- Throws:
ApiException- if fails to make API call
-
listRolesAsync
public CompletableFuture<RolesResponse> listRolesAsync(RolesApi.ListRolesOptionalParameters parameters) List roles.See
listRolesWithHttpInfoAsync(com.datadog.api.client.v2.api.RolesApi.ListRolesOptionalParameters).- Parameters:
parameters- Optional parameters for the request.- Returns:
- CompletableFuture<RolesResponse>
-
listRolesWithHttpInfo
public ApiResponse<RolesResponse> listRolesWithHttpInfo(RolesApi.ListRolesOptionalParameters parameters) throws ApiException Returns all roles, including their names and their unique identifiers.- Parameters:
parameters- Optional parameters for the request.- Returns:
- ApiResponse<RolesResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 429 Too many requests -
-
listRolesWithHttpInfoAsync
public CompletableFuture<ApiResponse<RolesResponse>> listRolesWithHttpInfoAsync(RolesApi.ListRolesOptionalParameters parameters) List roles.See
listRolesWithHttpInfo(com.datadog.api.client.v2.api.RolesApi.ListRolesOptionalParameters).- Parameters:
parameters- Optional parameters for the request.- Returns:
- CompletableFuture<ApiResponse<RolesResponse>>
-
listRoleTemplates
List role templates.- Returns:
- RoleTemplateArray
- Throws:
ApiException- if fails to make API call
-
listRoleTemplatesAsync
List role templates.- Returns:
- CompletableFuture<RoleTemplateArray>
-
listRoleTemplatesWithHttpInfo
List all role templates- Returns:
- ApiResponse<RoleTemplateArray>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 429 Too many requests -
-
listRoleTemplatesWithHttpInfoAsync
List role templates.- Returns:
- CompletableFuture<ApiResponse<RoleTemplateArray>>
-
listRoleUsers
Get all users of a role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- UsersResponse
- Throws:
ApiException- if fails to make API call
-
listRoleUsersAsync
Get all users of a role.- Parameters:
roleId- The unique identifier of the role. (required)- Returns:
- CompletableFuture<UsersResponse>
-
listRoleUsers
public UsersResponse listRoleUsers(String roleId, RolesApi.ListRoleUsersOptionalParameters parameters) throws ApiException Get all users of a role.- Parameters:
roleId- The unique identifier of the role. (required)parameters- Optional parameters for the request.- Returns:
- UsersResponse
- Throws:
ApiException- if fails to make API call
-
listRoleUsersAsync
public CompletableFuture<UsersResponse> listRoleUsersAsync(String roleId, RolesApi.ListRoleUsersOptionalParameters parameters) Get all users of a role.- Parameters:
roleId- The unique identifier of the role. (required)parameters- Optional parameters for the request.- Returns:
- CompletableFuture<UsersResponse>
-
listRoleUsersWithHttpInfo
public ApiResponse<UsersResponse> listRoleUsersWithHttpInfo(String roleId, RolesApi.ListRoleUsersOptionalParameters parameters) throws ApiException Gets all users of a role.- Parameters:
roleId- The unique identifier of the role. (required)parameters- Optional parameters for the request.- Returns:
- ApiResponse<UsersResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 403 Authentication error - 404 Not found - 429 Too many requests -
-
listRoleUsersWithHttpInfoAsync
public CompletableFuture<ApiResponse<UsersResponse>> listRoleUsersWithHttpInfoAsync(String roleId, RolesApi.ListRoleUsersOptionalParameters parameters) Get all users of a role.- Parameters:
roleId- The unique identifier of the role. (required)parameters- Optional parameters for the request.- Returns:
- CompletableFuture<ApiResponse<UsersResponse>>
-
removePermissionFromRole
public PermissionsResponse removePermissionFromRole(String roleId, RelationshipToPermission body) throws ApiException Revoke permission.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- PermissionsResponse
- Throws:
ApiException- if fails to make API call
-
removePermissionFromRoleAsync
public CompletableFuture<PermissionsResponse> removePermissionFromRoleAsync(String roleId, RelationshipToPermission body) Revoke permission.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<PermissionsResponse>
-
removePermissionFromRoleWithHttpInfo
public ApiResponse<PermissionsResponse> removePermissionFromRoleWithHttpInfo(String roleId, RelationshipToPermission body) throws ApiException Removes a permission from a role.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- ApiResponse<PermissionsResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 404 Not found - 429 Too many requests -
-
removePermissionFromRoleWithHttpInfoAsync
public CompletableFuture<ApiResponse<PermissionsResponse>> removePermissionFromRoleWithHttpInfoAsync(String roleId, RelationshipToPermission body) Revoke permission.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<ApiResponse<PermissionsResponse>>
-
removeUserFromRole
Remove a user from a role.See
removeUserFromRoleWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.RelationshipToUser).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- UsersResponse
- Throws:
ApiException- if fails to make API call
-
removeUserFromRoleAsync
public CompletableFuture<UsersResponse> removeUserFromRoleAsync(String roleId, RelationshipToUser body) Remove a user from a role.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<UsersResponse>
-
removeUserFromRoleWithHttpInfo
public ApiResponse<UsersResponse> removeUserFromRoleWithHttpInfo(String roleId, RelationshipToUser body) throws ApiException Removes a user from a role.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- ApiResponse<UsersResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 404 Not found - 429 Too many requests -
-
removeUserFromRoleWithHttpInfoAsync
public CompletableFuture<ApiResponse<UsersResponse>> removeUserFromRoleWithHttpInfoAsync(String roleId, RelationshipToUser body) Remove a user from a role.See
removeUserFromRoleWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.RelationshipToUser).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<ApiResponse<UsersResponse>>
-
updateRole
Update a role.See
updateRoleWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.RoleUpdateRequest).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- RoleUpdateResponse
- Throws:
ApiException- if fails to make API call
-
updateRoleAsync
Update a role.See
updateRoleWithHttpInfoAsync(java.lang.String, com.datadog.api.client.v2.model.RoleUpdateRequest).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<RoleUpdateResponse>
-
updateRoleWithHttpInfo
public ApiResponse<RoleUpdateResponse> updateRoleWithHttpInfo(String roleId, RoleUpdateRequest body) throws ApiException Edit a role. Can only be used with application keys belonging to administrators.- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- ApiResponse<RoleUpdateResponse>
- Throws:
ApiException- if fails to make API call- Http Response Details:
Response details Status Code Description Response Headers 200 OK - 400 Bad Request - 403 Authentication error - 404 Not found - 422 Unprocessable Entity - 429 Too many requests -
-
updateRoleWithHttpInfoAsync
public CompletableFuture<ApiResponse<RoleUpdateResponse>> updateRoleWithHttpInfoAsync(String roleId, RoleUpdateRequest body) Update a role.See
updateRoleWithHttpInfo(java.lang.String, com.datadog.api.client.v2.model.RoleUpdateRequest).- Parameters:
roleId- The unique identifier of the role. (required)body- (required)- Returns:
- CompletableFuture<ApiResponse<RoleUpdateResponse>>
-