REST API Reference

Back Next

Privileges

Use the privileges resource to obtain a list of privileges that you can use for custom roles.

For information on adding and updating privileges in custom roles, see Roles

GET request

You can request a list of the privileges that you are currently licensed to use. Or, you can request a list of all of the privileges, including the privileges that are disabled due to expired licenses.

To request a list of enabled and default privileges, use the following URI:

/public/core/v3/privileges

To request a complete list of privileges that includes enabled, disabled, default, and unassigned privileges, include a query parameter in the URI as shown in this example:

/public/core/v3/privileges?q=status==All

GET response

If successful, returns the following information for each privilege:

Field	Type	Description
id	String	Privilege ID.
name	String	Name of the privilege.
description	String	Description of the privilege.
service	String	The Informatica Intelligent Cloud Services service that applies to the privilege.
status	String	Status of the privilege. Returns one of the following values: Enabled. License to use the privilege is valid. Disabled. License to use the privilege has expired. Unassigned. No license to use this privilege. Default. Privilege included by default.

GET response example

If you send a request to get all privileges, you might receive a response similar to the following example:

[
    {
        "id": "0aoGhY1lAG0iS0PUeLMwoz",
        "name": "changeperm.bservice",
        "description": "",
        "service": "DI",
        "status": "Enabled"
    },
    {
        "id": "0bsvE8I4soacaMt8RHx1yT",
        "name": "update.RULE_SPECIFICATION",
        "description": "update RULE_SPECIFICATION",
        "service": "DQ",
        "status": "Unassigned"
    },
    {
        "id": "0CFJVGBp7Cae8o9EVFakYz",
        "name": "view.RULE_SPECIFICATION",
        "description": "view RULE_SPECIFICATION",
        "service": "DQ",
        "status": "Disabled"
    },
    {
        "id": "11Ai6CJ2PU8jaJwiAwyR0I",
        "name": "changeperm.folder",
        "description": "Change Permission Folder",
        "service": "Admin",
        "status": "Default"
    },
    {
        "id": "11ertBcF3aUkT7vqmn23a3",
        "name": "view.auditLog",
        "description": "view audit log",
        "service": "Admin",
        "status": "Default"
    },
....
]

Platform REST API version 3 resources

Download Guide

Watch

Comments

Cloud Data Integration Homepage