Skip To Content

Hosted Feature Service

Description

A feature service can contain datasets (e.g. tables, views) with and without a spatial column. Datasets with a spatial column are considered layers and without a spatial column are considered tables. A feature service allows clients to query and edit feature geometry and attributes.

This resource provides basic information about the feature service including the feature layers and tables that it contains, the service description, etc. The administrative feature service resource maintains a set of operations that manage the state and contents of the service. Note, query and edit operations are not available via the administrative resource.

Note:

Wait for the operation response and do not attempt concurrent administrative operations.

In ArcGIS Online, and at ArcGIS Enterprise 10.8, it is possible to add and update the default datum transformations for hosted feature services. These are applied to operations executed on the service. See examples and syntax below that can be used with the addToDefinition, updateDefinition, and deleteFromDefinition operations.

New at 11.2

A service's administrative resource now returns a list of supported field types for the layer-level supportedFieldTypes property.

New at 11.1

A service's administrative resource now returns a list of both supported options for service admin operations (serviceAdminOperationsOptions property) and supported options for layer admin operations (layerAdminOperationsOptions property).

Request parameters

ParameterDetails
f

The response format. The default response format is html.

Values: html | json

Example usage

The following is a sample request URL used to access a hosted feature service resource:

https://services.myserver.com/arcgis/rest/admin/services/WorldDataService/FeatureServer?f=pjson

JSON Response syntax


{
  "adminServiceInfo": {
    "name": <serviceName>, 
    "type": <serviceType>, 
    "status": <status>, 
    "database": {
      "datasource": {
        "name": <databaseName>}
    }
  }, 
  "currentVersion": <currentVersion>, 
  "serviceDescription": "<serviceDescription>",
  "hasVersionedData": <true | false>, 
  "supportsDisconnectedEditing": <true | false>, 
  "hasStaticData": <true | false>, 
  "maxRecordCount": "<maxRecordCount>", , 
  "supportedQueryFormats": "<supportedQueryFormats>", 
  "capabilities": "<capabilities>", 
  "description": "<description>", 
  "copyrightText": "<copyrightText>", 
  "spatialReference": {<spatialReference>}, 
  "initialExtent": {<envelope>}, 
  "fullExtent": {<envelope>}, 
  "allowGeometryUpdates": <true | false>, 
  "units": "<units>", 
  "syncEnabled": true, 
  "syncCapabilities": {
    "supportsASync": <true | false>,
    "supportsRegisteringExistingData": <true | false>,
    "supportsSyncDirectionControl": <true | false>,
    "supportsPerLayerSync": <true | false>,
    "supportsPerReplicaSync": <true | false>, 
    "supportsSyncModelNone": <true | false>,
    "supportsRollbackOnFailure": <true | false>,
    "supportsAttachmentsSyncDirection": <true | false>
  },
  "editorTrackingInfo": {
    "enableEditorTracking": <true | false>,
    "enableOwnershipAccessControl": <true | false>, 
				"allowOthersToQuery": <true | false>,
    "allowOthersToUpdate": <true | false>,
    "allowOthersToDelete": <true | false>
  }, 
  "documentInfo": { 
   "<key1>": "<value1>",
   "<key2>": "<value2>"
   },
  //the feature layers published by this service
  "layers": [
     <layer1>, 
     <layer2>],
  //the non-spatial tables published by this service
  "tables": [
     <table1>, 
     <table2>],
  "enableZDefaults": <true | false>,
  "zDefault": <zDefaultValue>,
  "supportedFieldTypes": [<fieldytpe1>,<fieldtype2]
}

JSON Response example


{
  "adminServiceInfo": {
    "name": "LoadTestSoil", 
    "type": "FeatureServer", 
    "status": "Started", 
    "database": {
      "datasource": {
        "name": "db"
      }
    }
  }, 
  "currentVersion": 10.3, 
  "serviceItemId": "a64c781191d2456bb60a84128853d293", 
  "serviceDescription": "", 
  "hasVersionedData": false, 
  "supportsDisconnectedEditing": false, 
  "hasStaticData": false, 
  "maxRecordCount": 1000, 
  "supportedQueryFormats": "JSON", 
  "capabilities": "Create,Delete,Query,Update,Editing,Extract,Sync", 
  "description": "", 
  "copyrightText": "", 
  "spatialReference": {
    "wkid": 102100, 
    "latestWkid": 3857
  }, 
  "initialExtent": {
    "xmin": -13090714.767112788, 
    "ymin": 3841739.0914657288, 
    "xmax": -12922032.654624918, 
    "ymax": 3962581.2727843975, 
    "spatialReference": {
      "wkid": 102100, 
      "latestWkid": 3857
    }
  }, 
  "fullExtent": {
    "xmin": -13090714.767112788, 
    "ymin": 3841739.0914657288, 
    "xmax": -12922032.654624918, 
    "ymax": 3962581.2727843975, 
    "spatialReference": {
      "wkid": 102100, 
      "latestWkid": 3857
    }
  }, 
  "allowGeometryUpdates": true, 
  "units": "esriMeters", 
  "size": 20922368, 
  "syncEnabled": true, 
  "syncCapabilities": {
    "supportsAsync": true, 
    "supportsRegisteringExistingData": true, 
    "supportsSyncDirectionControl": true, 
    "supportsPerLayerSync": true, 
    "supportsPerReplicaSync": true, 
    "supportsSyncModelNone": true, 
    "supportsRollbackOnFailure": true, 
    "supportsAttachmentsSyncDirection": true
  }, 
  "supportsApplyEditsWithGlobalIds": true, 
  "editorTrackingInfo": {
    "enableEditorTracking": true, 
    "enableOwnershipAccessControl": true, 
    "allowOthersToQuery": false, 
    "allowOthersToUpdate": false, 
    "allowOthersToDelete": false
  }, 
  "xssPreventionInfo": {
    "xssPreventionEnabled": true, 
    "xssPreventionRule": "InputOnly", 
    "xssInputRule": "rejectInvalid"
  }, 
  "layers": [
    {
      "adminLayerInfo": {
        "tableName": "db_10.user_10.LOADTESTSOIL_LOADTESTSOIL", 
        "geometryField": {"name": "Shape"}, 
        "xssTrustedFields": ""
      }, 
      "id": 0, 
      "name": "LoadTestSoil", 
      "type": "Feature Layer", 
      "displayField": "", 
      "description": "", 
      "copyrightText": "", 
      "defaultVisibility": true, 
      "ownershipBasedAccessControlForFeatures": {
        "allowOthersToQuery": false, 
        "allowOthersToDelete": false, 
        "allowOthersToUpdate": false
      }, 
      "editFieldsInfo": {
        "creationDateField": "CreationDate", 
        "creatorField": "Creator", 
        "editDateField": "EditDate", 
        "editorField": "Editor"
      }, 
      "editingInfo": {
        "lastEditDate": 1455126059440
      }, 
      "relationships": [], 
      "isDataVersioned": false, 
      "supportsCalculate": true, 
      "supportsAttachmentsByUploadId": true, 
      "supportsRollbackOnFailureParameter": true, 
      "supportsStatistics": true, 
      "supportsAdvancedQueries": true, 
      "supportsValidateSql": true, 
      "supportsCoordinatesQuantization": true, 
      "supportsApplyEditsWithGlobalIds": true, 
      "advancedQueryCapabilities": {
        "supportsPagination": true, 
        "supportsQueryWithDistance": true, 
        "supportsReturningQueryExtent": true, 
        "supportsStatistics": true, 
        "supportsOrderBy": true, 
        "supportsDistinct": true, 
        "supportsQueryWithResultType": true, 
        "supportsSqlExpression": true, 
        "supportsReturningGeometryCentroid": true
      }, 
      "useStandardizedQueries": false, 
      "geometryType": "esriGeometryPolygon", 
      "minScale": 2311163, 
      "maxScale": 1128, 
      "extent": {
        "xmin": -13090714.767112788, 
        "ymin": 3841739.0914657288, 
        "xmax": -12922032.654624918, 
        "ymax": 3962581.2727843975, 
        "spatialReference": {
          "wkid": 102100, 
          "latestWkid": 3857
        }
      }, 
      "drawingInfo": {
        "renderer":{ 
          "type": "simple",
          "symbol": {
            "type": "esriSFS",
            "style": "esriSFSSolid",
            "color": [76,129,205,191],
            "outline": {
              "type": "esriSLS",
              "style": "esriSLSSolid",
              "color": [0,0,0,255],
              "width":0.75
            }
          }
        },
        "transparency":0,
        "labelingInfo":null
      }, 
      "allowGeometryUpdates": true, 
      "hasAttachments": false, 
      "htmlPopupType": "esriServerHTMLPopupTypeNone", 
      "hasM": false, 
      "hasZ": false, 
      "objectIdField": "FID", 
      "globalIdField": "GlobalID", 
      "typeIdField": "", 
      "fields": [
        {
          "name": "FID", 
          "type": "esriFieldTypeInteger", 
          "actualType": "int", 
          "alias": "FID", 
          "sqlType": "sqlTypeInteger", 
          "length": 4, 
          "nullable": false, 
          "editable": false, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "AREA", 
          "type": "esriFieldTypeDouble", 
          "actualType": "float", 
          "alias": "AREA", 
          "sqlType": "sqlTypeFloat", 
          "nullable": true, 
          "editable": true, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "PERIMETER", 
          "type": "esriFieldTypeDouble", 
          "actualType": "float", 
          "alias": "PERIMETER", 
          "sqlType": "sqlTypeFloat", 
          "nullable": true, 
          "editable": true, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "MUSYM", 
          "type": "esriFieldTypeString", 
          "actualType": "nvarchar", 
          "alias": "MUSYM", 
          "sqlType": "sqlTypeNVarchar", 
          "length": 8, 
          "nullable": true, 
          "editable": true, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "MUKEY", 
          "type": "esriFieldTypeString", 
          "actualType": "nvarchar", 
          "alias": "MUKEY", 
          "sqlType": "sqlTypeNVarchar", 
          "length": 30, 
          "nullable": true, 
          "editable": true, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "DESCRIPTIO", 
          "type": "esriFieldTypeString", 
          "actualType": "nvarchar", 
          "alias": "DESCRIPTIO", 
          "sqlType": "sqlTypeNVarchar", 
          "length": 100, 
          "nullable": true, 
          "editable": true, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "CATEGORY", 
          "type": "esriFieldTypeString", 
          "actualType": "nvarchar", 
          "alias": "CATEGORY", 
          "sqlType": "sqlTypeNVarchar", 
          "length": 40, 
          "nullable": true, 
          "editable": true, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "OBJECTID_1", 
          "type": "esriFieldTypeInteger", 
          "actualType": "int", 
          "alias": "OBJECTID_1", 
          "sqlType": "sqlTypeInteger", 
          "nullable": true, 
          "editable": true, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "SHP_ID_ARE", 
          "type": "esriFieldTypeDouble", 
          "actualType": "float", 
          "alias": "SHP_ID_ARE", 
          "sqlType": "sqlTypeFloat", 
          "nullable": true, 
          "editable": true, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "SHP_ID_LEN", 
          "type": "esriFieldTypeDouble", 
          "actualType": "float", 
          "alias": "SHP_ID_LEN", 
          "sqlType": "sqlTypeFloat", 
          "nullable": true, 
          "editable": true, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "GlobalID", 
          "type": "esriFieldTypeGlobalID", 
          "alias": "GlobalID", 
          "sqlType": "sqlTypeOther", 
          "length": 38, 
          "nullable": false, 
          "editable": false, 
          "domain": null, 
          "defaultValue": "NEWID() WITH VALUES"
        }, 
        {
          "name": "CreationDate", 
          "type": "esriFieldTypeDate", 
          "alias": "CreationDate", 
          "sqlType": "sqlTypeOther", 
          "length": 8, 
          "nullable": true, 
          "editable": false, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "Creator", 
          "type": "esriFieldTypeString", 
          "alias": "Creator", 
          "sqlType": "sqlTypeOther", 
          "length": 50, 
          "nullable": true, 
          "editable": false, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "EditDate", 
          "type": "esriFieldTypeDate", 
          "alias": "EditDate", 
          "sqlType": "sqlTypeOther", 
          "length": 8, 
          "nullable": true, 
          "editable": false, 
          "domain": null, 
          "defaultValue": null
        }, 
        {
          "name": "Editor", 
          "type": "esriFieldTypeString", 
          "alias": "Editor", 
          "sqlType": "sqlTypeOther", 
          "length": 50, 
          "nullable": true, 
          "editable": false, 
          "domain": null, 
          "defaultValue": null
        }
      ], 
      "indexes": [
        {
          "name": "PK__LOADTEST__C1BEA5A20995BF60", 
          "fields": "FID", 
          "isAscending": true, 
          "isUnique": true, 
          "description": "clustered, unique, primary key"
        }, 
        {
          "name": "user_10.LOADTESTSOIL_LOADTESTSOIL_Shape_sidx", 
          "fields": "Shape", 
          "isAscending": false, 
          "isUnique": false, 
          "description": "Shape Index"
        }, 
        {
          "name": "GlobalID_Index", 
          "fields": "GlobalID", 
          "isAscending": false, 
          "isUnique": true, 
          "description": ""
        }, 
        {
          "name": "CreationDateIndex", 
          "fields": "CreationDate", 
          "isAscending": true, 
          "isUnique": false, 
          "description": "CreationDate Field index"
        }, 
        {
          "name": "CreatorIndex", 
          "fields": "Creator", 
          "isAscending": false, 
          "isUnique": false, 
          "description": "Creator Field index"
        }, 
        {
          "name": "EditDateIndex", 
          "fields": "EditDate", 
          "isAscending": true, 
          "isUnique": false, 
          "description": "EditDate Field index"
        }, 
        {
          "name": "EditorIndex", 
          "fields": "Editor", 
          "isAscending": false, 
          "isUnique": false, 
          "description": "Editor Field index"
        }
      ], 
      "types": [], 
      "templates": [
        {
          "name": "New Feature", 
          "description": "", 
          "drawingTool": "esriFeatureEditToolPolygon", 
          "prototype": {
            "attributes": {
              "AREA": null, 
              "PERIMETER": null, 
              "MUSYM": null, 
              "MUKEY": null, 
              "DESCRIPTIO": null, 
              "CATEGORY": null, 
              "OBJECTID_1": null, 
              "SHP_ID_ARE": null, 
              "SHP_ID_LEN": null
            }
          }
        }
      ], 
      "supportedQueryFormats": "JSON", 
      "hasStaticData": false, 
      "maxRecordCount": 1000, 
      "standardMaxRecordCount": 4000, 
      "tileMaxRecordCount": 4000, 
      "maxRecordCountFactor": 1, 
      "capabilities": "Create,Delete,Query,Update,Editing,Extract,Sync", 
      "exceedsLimitFactor": 1
    }
  ]
}

Below is sample datum transformation information that could be included in a hosted feature layer response. When you go from one coordinate system to another, such as when you specify replicaSR for createReplica, or outSR for query, a datum transformation is selected for you and is automatically applied by default in some specific cases. For example, if you go from NAD 27 to WGS 84, a datum transformation will be applied automatically for you, shifting the coordinates. However, if you were to go from NAD 83 to WGS 84, no datum transformation would be applied and no coordinates would be shifted. In cases where there is no default datum transformation applied, or if you one a different transformation to be applied, there are two ways where you can apply a specific datum transformation.

You can either publish the feature service with a datumTransformation that is authored in the map that will automatically be applied each time you specify outSR as 3857 (WGS 84). Alternatively, each time you specify query, queryRelated, or applyEdits, you can use the datumTransformation parameter to specify the transformation. If the feature service was published with a datum transformation, you can still use the datumTransformation parameter. The datumTransformation parameter will be used and the transformation published with the feature service will be ignored.


"datumTransformations": [
  {
    "wkid": 1901,
    "transformJson": "",
    "transformDirection": "forward",
    "fromSR": {
      "wkid": 4152,
      "latestWkid": 4152
    },
    "toSR": {
      "wkid": 4326,
      "latestWkid": 4326
    }
  },
  {
    "wkid": 1901,
    "transformJson": "",
    "transformDirection": "reverse",
    "fromSR": {
      "wkid": 4152,
      "latestWkid": 4152
    },
    "toSR": {
      "wkid": 4326,
      "latestWkid": 4326
    }
  }
]

Below are sample JSON responses that demonstrates the serviceAdminOperationsOptions and layerAdminOperationsOptions properties returned for a hosted feature service at ArcGIS Enterprise 11.1. These properties list the admin operations available for a given hosted feature service or layer. For example, the response below shows layers listed under addToDefinition. This means that the operation can be used to add layers to a service.

Note:

Lists returned for hosted feature service views and hosted feature service view layers may be different.

Example for service admin operation options


"serviceAdminOperationsOptions": {
  "deleteFromDefinition": [
    "layers",
    "tables"
  ],
  "addToDefiniton": [
    "layers",
    "tables"
  ],
  "updateDefinition": [
    "allowGeometryUpdates",
    "canUseTopologicalSortForRelationshipOrdering",
    "capabilities",
    "copyrightText",
    "datumTransformations",
    "description",
    "editorTrackingInfo",
    "enableZDefaults",
    "hasStaticData",
    "initialExtent",
    "maxRecordCount",
    "preferredTimeReference",
    "preserveLayerIds",
    "serviceDescription",
    "syncRowsMovedOutsideFilter",
    "xssPreventionInfo",
    "zDefault",
    "maxViewsCount",
    "supportsBiDirectionalSyncForServer",
    "layerOverridesEnabled",
    "maxIdsCount"
  ]
}

Example for layer admin operation options


"layerAdminOperationsOptions": {
  "deleteFromDefinition": [
    "xssTrustedFields",
    "fields",
    "indexes",
    "relationships",
    "lodInfoIndexes"
  ],
  "addToDefiniton": [
    "fields",
    "indexes"
  ],
  "updateDefinition": [
    "name",
    "displayField",
    "description",
    "copyrightText",
    "editFieldsInfo",
    "minScale",
    "maxScale",
    "fields",
    "maxRecordCount",
    "drawingInfo",
    "types",
    "templates",
    "indexes",
    "defaultVisibility",
    "hasAttachments",
    "typeIdField",
    "timeInfo",
    "xssTrustedFields",
    "allowUpdateWithoutMValues",
    "maxResultWindow",
    "maxRecordCountFactor",
    "tableMetadata",
    "propagateVisibleFields",
    "hasGeometryProperties",
    "layerCache",
    "attachmentProperties",
    "lodInfos",
    "lastEditDate",
    "capabilities",
    "allowGeometryUpdates",
    "ownershipBasedAccessControlForFeatures",
    "definitionQuery"
  ]
}