- URL:
- https://<adminservicecatalog-url>/services/<serviceName>/KnowledgeGraphServer
- Methods:
GET
- Operations:
- Refresh, Status, Update Definition
- Child Resources:
- Data Model
Description
A knowledge graph service is associated with several resources. One resource is a graph, which contains entities and relationships. Another resource is the data model that defines the types of entities and relationships that can be created in the graph.
The administrative knowledge graph service resource maintains a set of operations that manage the state of the service and some aspects of its data model. Operations that query, search, and edit the content graph are not available from the administrative resource.
Request parameters
Parameter | Details |
---|---|
| The response format. The default response format is Values: |
Example usage
Most requests made to and responses received from knowledge graph services will involve data encoded using protocol buffers. Protocol buffers are a language-neutral, platform-independent mechanism for serializing structured data that was designed by Google.
Sending a request to a knowledge graph service involves creating an http client in the programming language of your choice, and using it to create and send an http POST request. The POST request will include a protocol buffer defining the operation that will be performed. Similarly, the response will include a protocol buffer containing data returned by the service. The protocol buffers must be encoded and decoded. Protocol buffers are created using a *.proto
file. Different requests and responses are associated with different .proto
files. For details, refer to the complete Protocol Buffer Format (PBF) specification.
The following is a sample request URL for a knowledge graph service named Supply
:
https://machine.domain.com/webadaptor/rest/admin/services/Hosted/SupplyChain/KnowledgeGraphServer?f=json
JSON Response syntax
When an JSON request is sent to the knowledge graph service, a JSON response is returned outlining the capabilities of the service. The following example represents the syntax for describing the capabilities of a knowledge graph service.
{
"capabilities": "<comma-separated list of supported operations>",
"adminServiceInfo": {
"database": {
"datasource": {"name": <graphStoreName>}
},
"databaseName": <service name>,
"systemDB": {
"datasource": {"name": <graphStoreName>}
},
"name": <service name>,
"type": "KnowledgeGraphServer",
"status": <service status>
},
"supportedQueryFormats": "PBF",
"allowGeometryUpdates": <boolean>,
"searchMaxRecordCount": <integer>,
"serviceCapabilities": {
"indexCapabilities": {
"supportsDescendingIndex": <boolean>,
"supportsUniqueRelationshipConstraint": <boolean>,
"supportsRelationshipIndex": <boolean>
},
"searchCapabilities": {
"searchTypeFilterCapabilities": [
"esriTypeEntity", "esriTypeRelationship", "esriTypeBoth"
],
"allowLeadingWildcardQueries": <boolean>
}
"geometryCapabilities": {
"supportsMValues": <boolean>,
"supportsZValues": <boolean>,
"supportedGeometryTypes": [
"Point",
"MultiPoint",
"Polyline",
"Polygon",
"Envelope"
]
}
},
"maxRecordCount": <integer>,
"description": "<string>",
"copyrightText": "<string>",
"units": "esriDecimalDegrees",
"spatialReference": {"wkid": 4326},
"currentVersion": <version number>,
"name": <service name>,
"dateFieldsTimeReference": {
"respectsDaylightSaving": <boolean>,
"timeZone": "UTC"
},
"serviceItemId": "<portal item ID>"
}
JSON Response example
This example illustrates the response to the example query shown above.
{
"capabilities": "Delete,Query,Create,Editing,Update",
"adminServiceInfo": {
"database": {
"datasource": {"name": "/nosqlDatabases/AGSDataStore_graph_hdb1a1"}
},
"databaseName": "SupplyChain",
"systemDB": {
"datasource": {"name": "/nosqlDatabases/AGSDataStore_graph_hdb1a1"}
},
"name": "SupplyChain",
"type": "KnowledgeGraphServer",
"status": "STARTED"
},
"supportedQueryFormats": "PBF",
"allowGeometryUpdates": false,
"searchMaxRecordCount": 2000,
"serviceCapabilities": {
"indexCapabilities": {
"supportsDescendingIndex": false,
"supportsUniqueRelationshipConstraint": false,
"supportsRelationshipIndex": true
},
"searchCapabilities": {
"searchTypeFilterCapabilities": [
"esriTypeEntity", "esriTypeRelationship", "esriTypeBoth"
],
"allowLeadingWildcardQueries": true
}
"geometryCapabilities": {
"supportsMValues": true,
"supportsZValues": true,
"supportedGeometryTypes": [
"Point",
"MultiPoint",
"Polyline",
"Polygon",
"Envelope"
]
}
},
"maxRecordCount": 2000,
"description": "",
"copyrightText": "",
"units": "esriDecimalDegrees",
"spatialReference": {"wkid": 4326},
"currentVersion": 10.91,
"name": "SupplyChain",
"dateFieldsTimeReference": {
"respectsDaylightSaving": false,
"timeZone": "UTC"
},
"serviceItemId": "e69a705b47824987994122d6d78c795c"
}