Example usage
The following is a sample ArcGIS Online request URL used to access the roles
resource:
https://org.arcgis.com/sharing/rest/portals/0123456789ABCDEF/roles?returnPrivileges=true&f=pjson
The following is a sample ArcGIS Enterprise request URL used to access the roles
resource:
https://machine.domain.com/webadaptor/sharing/rest/portals/0123456789ABCDEF/roles?returnPrivileges=true&f=pjson
Description
The roles
resource lists the organization's custom roles.
Request parameters
Parameter | Details |
---|---|
| The number of the first entry in the result set response. The index number is 1-based. The default value of start is 1. Example
|
| The maximum number of results to be included in the result set response. The default value is 10, and the maximum allowed value is 100. Note that the actual number of returned results may be less than num. This happens when the number of results remaining after start is less than num. Example
|
| If Values: |
| The response format. The default format is Values: |
Response properties
Property | Details |
---|---|
| The total number of results found for the whole query. Example
|
| The number of the first entry in the result set for this response. The index number is 1-based. Example
|
| The number of results included in the result set for this response. Example
|
| The next entry index if the current result set doesn't contain all results, or Example
|
| A JSON array of role objects. See the response properties of role for details. The example below shows a role object when Example
|
JSON Response syntax
{
"total": <total number of roles for the organization>,
"start": <the first record index in the response>,
"num": <the number of roles included in the response>,
"nextStart": <the next entry index>,
"roles": [
{
<role1>
},
{
<role2>
},
{
<role3>
}
]
}
JSON Response example
{
"total": 6,
"start": 1,
"num": 10,
"nextStart": -1,
"roles": [
{
"id": "iAAAAAAAAAAAAAAA",
"name": "Viewer",
"description": "Viewer",
"created": 1615440392550,
"modified": 1615440392550,
"privileges": [
"portal:user:joinGroup",
"portal:user:viewOrgGroups",
"portal:user:viewOrgItems",
"portal:user:viewOrgUsers",
"premium:user:demographics",
"premium:user:elevation",
"premium:user:geocode",
"premium:user:networkanalysis"
]
},
{
"id": "iBBBBBBBBBBBBBBB",
"name": "Data Editor",
"description": "Data Editor",
"created": 1615440392550,
"modified": 1615440392550,
"privileges": [
"features:user:edit",
"portal:user:joinGroup",
"portal:user:viewOrgGroups",
"portal:user:viewOrgItems",
"portal:user:viewOrgUsers",
"premium:user:demographics",
"premium:user:elevation",
"premium:user:geocode",
"premium:user:networkanalysis"
]
},
{
"id": "FnjKvnmkg7dfFYJL",
"name": "Notebook_Adv",
"description": "For Advanced Notebook users",
"created": 1615441320983,
"modified": 1615441321237,
"privileges": [
"features:user:edit",
"portal:publisher:publishFeatures",
"portal:user:createItem",
"portal:user:joinGroup",
"portal:user:shareToGroup",
"portal:user:shareToOrg",
"portal:user:viewOrgGroups",
"portal:user:viewOrgItems",
"portal:user:viewOrgUsers",
"premium:publisher:createAdvancedNotebooks",
"premium:publisher:createNotebooks",
"premium:publisher:geoanalytics",
"premium:publisher:rasteranalysis",
"premium:publisher:scheduleNotebooks",
"premium:user:elevation",
"premium:user:geocode",
"premium:user:geoenrichment",
"premium:user:networkanalysis",
"premium:user:spatialanalysis"
]
},
{
"id": "QjZbbGVvJQi5BLVy",
"name": "Notebook_Std",
"description": "For Advanced Notebook users",
"created": 1615441321390,
"modified": 1615441321423,
"privileges": [
"features:user:edit",
"portal:publisher:publishFeatures",
"portal:user:createItem",
"portal:user:joinGroup",
"portal:user:shareToGroup",
"portal:user:shareToOrg",
"portal:user:viewOrgGroups",
"portal:user:viewOrgItems",
"portal:user:viewOrgUsers",
"premium:publisher:createNotebooks",
"premium:publisher:geoanalytics",
"premium:publisher:rasteranalysis",
"premium:publisher:scheduleNotebooks",
"premium:user:elevation",
"premium:user:geocode",
"premium:user:geoenrichment",
"premium:user:networkanalysis",
"premium:user:spatialanalysis"
]
},
{
"id": "H4PyrOyVjkDM9Ylu",
"name": "WebAppsPub",
"description": "For Web Apps Publisher users",
"created": 1615441321448,
"modified": 1615441321482,
"privileges": [
"features:user:edit",
"portal:publisher:bulkPublishFromDataStores",
"portal:publisher:publishFeatures",
"portal:publisher:publishScenes",
"portal:publisher:publishServerGPServices",
"portal:publisher:publishServerServices",
"portal:publisher:publishTiles",
"portal:publisher:registerDataStores",
"portal:user:createGroup",
"portal:user:createItem",
"portal:user:joinGroup",
"portal:user:shareGroupToOrg",
"portal:user:shareGroupToPublic",
"portal:user:shareToGroup",
"portal:user:shareToOrg",
"portal:user:shareToPublic",
"portal:user:viewOrgGroups",
"portal:user:viewOrgItems",
"portal:user:viewOrgUsers",
"premium:publisher:geoanalytics",
"premium:publisher:rasteranalysis",
"premium:user:elevation",
"premium:user:geocode",
"premium:user:geoenrichment",
"premium:user:networkanalysis",
"premium:user:spatialanalysis"
]
},
{
"id": "UtH97RjLjPG7s31W",
"name": "TrackView_Viewer",
"description": "For TrackView Viewers",
"created": 1615441321505,
"modified": 1615441321553,
"privileges": [
"portal:user:joinGroup",
"portal:user:viewOrgGroups",
"portal:user:viewOrgItems",
"portal:user:viewOrgUsers",
"portal:user:viewTracks",
"premium:user:elevation",
"premium:user:geocode",
"premium:user:networkanalysis"
]
}
]
}