Enables scripted content fragments to use Roless

Methods

Create

Creates a role

Usage

#set($roleResponse = $core_v2_role.Create($name, $description))

Parameters

NameTypeDescriptionRequiredDefaultOptions
namestringNameRequired
descriptionstringDescriptionRequired

Return Type

Role

Create

Creates a role

Usage

#set($roleResponse = $core_v2_role.Create($name, $description, "%{GroupId = $groupIdArg, Include = $includeArg, RoleId = $roleIdArg, RoleName = $roleNameArg, UserId = $userIdArg, Username = $usernameArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
namestringNameRequired
descriptionstringDescriptionRequired
GroupIdintGroup IdOptional
IncludestringIncludeOptionaluser
RoleIdintEither RoleId or RoleName is required when using include=userOptional
RoleNamestringEither RoleId or RoleName is required when using include=userOptional
UserIdintEither UserId or Username is required when using include=userOptional
UsernamestringEither UserId or Username is required when using include=userOptional

Return Type

Role

CreateFromLdap

Creates a role based on an LDAP group

Usage

#set($roleResponse = $core_v2_role.CreateFromLdap($ldapGroupName))

Parameters

NameTypeDescriptionRequiredDefaultOptions
ldapGroupNamestringLdap Group NameRequired

Return Type

Role

CreateFromLdap

Creates a role based on an LDAP group

Usage

#set($roleResponse = $core_v2_role.CreateFromLdap($ldapGroupName, $distinguishedName))

Parameters

NameTypeDescriptionRequiredDefaultOptions
ldapGroupNamestringLdap Group NameRequired
distinguishedNamestringDistinguished NameRequired

Return Type

Role

Delete

Deletes a role

Usage

#set($additionalInfoResponse = $core_v2_role.Delete($roleId))

Parameters

NameTypeDescriptionRequiredDefaultOptions
roleIdintRole IdRequired

Return Type

AdditionalInfo

Delete

Deletes a role

Usage

#set($additionalInfoResponse = $core_v2_role.Delete($roleId, "%{Include = $includeArg, UserId = $userIdArg, Username = $usernameArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
roleIdintRole IdRequired
IncludestringIncludeOptional
UserIdintUser IdOptional
UsernamestringUsernameOptional

Return Type

AdditionalInfo

Find

Searches for a role

Usage

#set($apiListResponse = $core_v2_role.Find($matchText))

Parameters

NameTypeDescriptionRequiredDefaultOptions
matchTextstringMatch TextRequired

Return Type

ApiList<Role>

Get

Gets a role

Usage

#set($roleResponse = $core_v2_role.Get($application, $id, $roleId))

Parameters

NameTypeDescriptionRequiredDefaultOptions
applicationstringApplicationRequired
idint?IdRequired
roleIdintRole IdRequired

Return Type

Role

Get

Gets a role

Usage

#set($roleResponse = $core_v2_role.Get($application, $id, $roleId, "%{Include = $includeArg, IncludePermissions = $includePermissionsArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
applicationstringApplicationRequired
idint?IdRequired
roleIdintRole IdRequired
IncludestringIncludeOptional
IncludePermissionsboolInclude PermissionsOptional

Return Type

Role

List

Lists roles

Usage

#set($apiListResponse = $core_v2_role.List())

Return Type

ApiList<Role>

List

Lists roles for an application

Usage

#set($apiListResponse = $core_v2_role.List($application))

Parameters

NameTypeDescriptionRequiredDefaultOptions
applicationstringApplicationRequired

Return Type

ApiList<Role>

List

Lists roles

Usage

#set($apiListResponse = $core_v2_role.List("%{Application = $applicationArg, Id = $idArg, Include = $includeArg, IncludePermissions = $includePermissionsArg, PageIndex = $pageIndexArg, PageSize = $pageSizeArg, PermissionId = $permissionIdArg, UserId = $userIdArg, Username = $usernameArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
ApplicationstringApplicationOptional
IdintIdOptional
IncludestringIncludeOptionaldenied, granted, user
IncludePermissionsboolInclude PermissionsOptional
PageIndexintSpecify the page number of paged results to return. Zero-based index.Optional0
PageSizeintSpecify the number of results to return per page.Optional20
PermissionIdstringPermission IdOptional
UserIdintEither UserId or Username are required when using include=userOptional
UsernamestringEither UserId or Username are required when using include=userOptional

Return Type

ApiList<Role>

Update

Updates a role

Usage

#set($roleResponse = $core_v2_role.Update($roleId, $name, $description))

Parameters

NameTypeDescriptionRequiredDefaultOptions
roleIdintRole IdRequired
namestringNameRequired
descriptionstringDescriptionRequired

Return Type

Role

Update

Updates a role

Usage

#set($roleResponse = $core_v2_role.Update($roleId, $name, $description, "%{GroupId = $groupIdArg}"))

Parameters

NameTypeDescriptionRequiredDefaultOptions
roleIdintRole IdRequired
namestringNameRequired
descriptionstringDescriptionRequired
GroupIdintGroup IdOptional

Return Type

Role