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.

Request parameters

ParameterDetails
f

The response format. The default response format is html.

Values: html | json

Example usage

Below is an example URL for the "USA" feature service:

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>,
}

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
    }
  }
]

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.