Table of Contents

Search

  1. Preface
  2. Informatica Intelligent Cloud Services REST API
  3. Platform REST API version 2 resources
  4. Platform REST API version 3 resources
  5. Data Integration REST API
  6. File Ingestion and Replication REST API
  7. Streaming Ingestion and Replication REST API
  8. Model Serve REST API
  9. RunAJob utility
  10. ParamSetCli utility
  11. REST API codes
  12. REST API resource quick references

REST API Reference

REST API Reference

Getting role details

Getting role details

You can request the details for all of your organization's roles or request the details for a particular role.

GET request

To get role details, use the following URI:
/public/core/v3/roles
To get the details for a particular role, you can include the following query parameters in the URI:
Parameter
Type
Description
q
String
Query filter. You can filter using one of the following fields:
  • roleId. Unique identifier for the role.
  • roleName. Name of the role.
expand
String
Returns the privileges associated with the role specified in the query filter.
Include the following phrase in the query:
expand=privileges
For example, to get details for the Business Manager role including privileges, you might use the following request:
/public/core/v3/roles?q=roleName=="Business Manager"&expand=privileges

GET response

If successful, returns the following information for each role:
Field
Type
Description
id
String
Role ID.
orgId
String
ID of the organization the role belongs to.
createdBy
String
User who created the role.
updatedBy
String
User who last updated the role.
createTime
String
Date and time the role was created.
updateTime
String
Date and time the role was last updated.
roleName
String
Name of the role.
description
String
Description of the role.
displayName
String
Role name displayed in the user interface.
displayDescription
String
Description displayed in the user interface.
systemRole
Boolean
Whether the role is a system-defined role. Returns one of the following values:
  • True. Role is a system-defined role.
  • False. Role is a custom role.
status
String
Whether the organization's license to use the role is valid or has expired. Returns one of the following values:
  • Enabled
  • Disabled
privileges
Array
Privileges assigned to the role.
Returned only when the URI includes
?expand=privileges
in a query.
id
String
Included in the privileges object.
Privilege ID.
name
String
Included in the privileges object.
Privilege name.
description
String
Included in the privileges object.
Description of the privilege.
service
String
Included in the privileges object.
The
Informatica Intelligent Cloud Services
service that uses the privilege.
status
String
Included in the privileges object.
Whether the organization's license to use the privilege is valid or has expired. Returns one of the following values:
  • Enabled
  • Disabled

GET response example

You might receive a response similar to the following example:
[ { "id": "7EjAMAHsiOTcg8v29z0Gsl", "orgId": "52ZSTB0IDK6dXxaEQLUaQu", "createdBy": "ops-post-deploy-user", "updatedBy": "ops-post-deploy-user", "createTime": "2019-03-22T21:26:46.000Z", "updateTime": "2019-03-22T21:26:52.000Z", "roleName": "Business Manager", "description": "Role used for business managers", "displayName": "Application Integration Business Manager", "displayDescription": "Role used for business managers", "systemRole": true, "status": "Disabled", "privileges": [ { "id": "5Cgp0GcsmRejyxIgV4eXy1", "name": "view.ai.console", "description": "View application integration console", "service": "ApplicationIntegration", "status": "Disabled" }, { "id": "aReU2uciLYglcq0Ntvc2Ob", "name": "view.ai.assets", "description": "View application integration assets", "service": "ApplicationIntegration", "status": "Disabled" }, { "id": "8zDel5v89cKfeMtM2FHFEw", "name": "view.ai.designer", "description": "View application integration designer", "service": "ApplicationIntegration", "status": "Disabled" } ] } ]

0 COMMENTS

We’d like to hear from you!