Query Network Moments

URL:
https://<root>/<serviceName>/traceNetworkServer/queryNetworkMoments
Methods:
GETPOST
Version Introduced:
10.9

Description

The queryNetworkMoments operation returns the moments related to the network topology and operations against the topology. This includes when the topology was initially enabled, when it was last validated, when it was last disabled (and later enabled), and when the definition of the trace network was last modified.

Request parameters

ParameterDetails

f

The output format of the response. The default format is html.

1
f=html | json | pjson

gdbVersion

Description: Optional parameter specifying the name of the geodatabase version. The default is DEFAULT.

Syntax: gdbVersion=<version>

sessionId

Description: Optional parameter specifying the sessionId (GUID) used to lock the version. If the calling client has previously started a service session (editing) and holds an exclusive lock on the specified version, the request will fail if the sessionId is not provided. If the specified version is currently locked by any other session, the request will fail if the sessionId is not provided or does not match the sessionId that holds the exclusive lock.

Syntax: sessionId=<guid>

moment

(Optional)

Specifies the session moment. The default is the version current moment. This should only be specified by the client when they do not want to use the current moment.

Syntax: moment=<Epoch time in seconds>

Example: moment=1603109606

momentsToReturn

Description: Optional parameter representing the collection of validate moments to return. The default is all. This is provided as an array of strings.

Values:

1
2
3
["initialEnableTopology" | "fullValidateTopology" |
"partialValidateTopology" | "enableTopology" | "disableTopology" |
 "definitionModification" | "indexUpdate" | "all" ]

Example: momentsToReturn=["enableTopology","initialEnableTopology"]

JSON Response syntax

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "networkMoments" : [
    {
      "moment" : <momentType>,
      "time" : <datetime>,
      "duration" : <double>      // in milliseconds
    }
  ],
  "validNetworkTopology" : <true | false>,
  "success" : <true | false>,
  "error" : {                   // only if success is false
    "extendedCode" : <HRESULT>,
    "message" : <error message>,
    "details" : [ <detail> ]
  }
}

Example usage

For the current state of a trace network, return the moment the network topology was initially enabled and the last time it was enabled using the queryNetworkMoments operation.

Request URL and parameters:

https://myserver.esri.com/server/rest/services/LandUse/TraceNetworkServer/queryNetworkMoments

1
2
f=json
momentsToReturn=["enableTopology","initialEnableTopology"]

JSON response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
 "networkMoments": [
  {
   "moment": "enableTopology",
   "time": 0,
   "duration": 0
  },
  {
   "moment": "initialEnableTopology",
   "time": 1601505461,
   "duration": 4099
  }
 ],
 "validNetworkTopology": true,
 "success": true
}

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

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close