- URL:https://<site-url>/services
- Operations:Can Create Service, Create Folder, Create Service, Delete Services, Edit Folder, Exists, Export Services, Federate, Import Services, Rename Service, Start Services, Stop Services, Unfederate
- Child Resources:Report, Permissions, Types, Folders, Service, Properties, Webhooks
- Required Capability:Default administrator role | All authorized users
- Version Introduced:10.1
Description
The root folder is a container for all sub-folders and GIS services. A root folder can contain one or more sub-folders and GIS services. You can create a new sub-folder by using the Create Folder operation and a new GIS service by using the Create Service operation. The Permissions resource on the folder will let you set permissions on your GIS services and subfolders. Setting permissions on a folder is a convenient way to toggle permissions on a large number of services. The types resource returns a list of all the service types and their extensions supported on the ArcGIS Server.
Request parameters
| Parameter | Description |
|---|---|
| detail | Parameter to indicate that a detailed description is expected. The default value is false. Values: true | false |
| f | The response format. The default response format is html. Values: html | json | pjson |
Example usage
Below is a sample request URL for the services resource:
https://machine.domain.com/webadaptor/admin/services?detail=true&f=jsonJSON Response syntax
{
"folderName": "/",
"description": "Root folder",
"webEncrypted": <webEncrypted>,
"isDefault": <isDefault>,
"folders": [
"<folderName1>",
"<folderName2>"
],
"foldersDetail": [
{
"folderName": "<folderName>",
"description": "<description>",
"webEncrypted": <webEncrypted>,
"isDefault": <isDefault>
}
],
"services": [
{
"folderName": "<folderName>",
"serviceName": "<serviceName>",
"type": "<serviceType>",
"description": "<description>"
}
]
}The full name of a service is represented in JSON as follows
{
"folderName”: <folderName>,
"serviceName”: <name>,
"serviceType”: <type>,
"description”: <description>
}JSON Response example
{
"folderName": "/",
"description": "Root folder",
"webEncrypted": false,
"isDefault": false,
"folders": [
"System",
"Utilities"
],
"foldersDetail": [
{
"folderName": "System",
"description": "The System folder contains automatically deployed services that are used by ArcGIS Server.",
"webEncrypted": false,
"isDefault": true
},
{
"folderName": "Utilities",
"description": "The Utilities folder contains automatically deployed services that can be used by application developers.",
"webEncrypted": false,
"isDefault": true
}
],
"services": [
{
"folderName": "/",
"serviceName": "SampleWorldCities",
"type": "MapServer",
"description": "The SampleWorldCities service is provided so you can quickly and easily preview the
functionality of the GIS server. Click the thumbnail image to open in a web application.
This sample service is optional and can be deleted."
}
]
}