Reset (Unit Identifiers) | ArcGIS REST APIs

URL:: https://<root>/<serviceName>/UtilityNetworkServer/unitIdentifiers/reset
Methods:: GETPOST
Version Introduced:: 12.1

Description

The reset operation on the unitIdentifiers resource is used to reset the unit identifiers associated with a unit container feature in a telecom domain network. This is done to condense the unit identifier space or overcome unit identifier sequence exhaustion.

Request parameters

Parameter Details

Parameter	Details
`f`	The output format of the response. The default response format is `html`. Values: `html` \| `json` \| `pjson`
`gdbVersion` (Optional)	Specifies the name of the geodatabase version. The default value is `sde.DEFAULT`. Syntax: Use dark colors for code blocksCopy `1 2 gdbVersion=<version>`
`sessionID` (Optional)	Specifies the token guid used to lock the version. If the calling client is editing a named version, the `sessionId` value must be provided; if the client is editing `DEFAULT`, the version may not be locked and the `sessionId` value should not be specified. Syntax: Use dark colors for code blocksCopy `1 2 sessionId=<guid>`
`objects` (Required)	Array containing the unit identifiable features or objects to be reset. Syntax: Use dark colors for code blocksCopy `1 2 3 4 5 6 [ { "sourceId": <short>, "globalIds": ["<guid>"] } ]` Example: Use dark colors for code blocksCopy `1 2 3 4 5 6 7 8 [ { "sourceId": 9, "globalIds": [ "{BE504BEE-F6AB-4474-A632-BC94E35DCD2A}" ] } ]`

f

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

Values: html | json | pjson

gdbVersion

(Optional)

Specifies the name of the geodatabase version. The default value is sde.DEFAULT.

Syntax:

Use dark colors for code blocksCopy

gdbVersion=<version>

sessionID

(Optional)

Specifies the token guid used to lock the version. If the calling client is editing a named version, the sessionId value must be provided; if the client is editing DEFAULT, the version may not be locked and the sessionId value should not be specified.

Syntax:

Use dark colors for code blocksCopy

sessionId=<guid>

objects

(Required)

Array containing the unit identifiable features or objects to be reset.

Syntax:

Use dark colors for code blocksCopy
[
  {
    "sourceId": <short>,
    "globalIds": ["<guid>"]
  }
]

Example:

Use dark colors for code blocksCopy
[
  {
    "sourceId": 9,
    "globalIds": [
      "{BE504BEE-F6AB-4474-A632-BC94E35DCD2A}"
    ]
  }
]

Example usage

Request URL and parameters:

Use dark colors for code blocksCopy

https://myserver.esri.com/server/rest/services/Telco/UtilityNetworkServer/unitIdentifiers/reset

Use dark colors for code blocksCopy
f=json
gdbVersion=sde.Default
objects= [
  {
    "sourceId": 9,
    "globalIds": [
      "{BE504BEE-F6AB-4474-A632-BC94E35DCD2A}"
    ]
  }
]

JSON response syntax

Use dark colors for code blocksCopy
{
  "exceededTransferLimit": false,
  "serviceEdits": [
    {
      "id": 5,
      "editedFeatures": {
        "spatialReference": {
          "wkid": 3498,
          "latestWkid": 3498,
          "xyTolerance": 0.003280833333333333,
          "zTolerance": 0.001,
          "mTolerance": 0.001,
          "falseX": -117608900,
          "falseY": -91881400,
          "xyUnits": 3048.0060960121929,
          "falseZ": -100000,
          "zUnits": 10000,
          "falseM": -100000,
          "mUnits": 10000
        },
        "updates": [
          [
            {
              "attributes": {
                "objectid": 68,
                "assetgroup": 1,
                "assettype": 2,
                "associationstatus": 33,
                "containersourceid": null,
                "containerglobalid": null,
                "nextunitid": 13,
                "conflictcontainerstate": null,
                "partitionid": null,
                "globalid": "{7BABDB1B-C611-4FD4-8F15-0D9115B1F623}",
                "clusterkey": null,
                "creator": null,
                "creationdate": null,
                "updatedby": "unadmin",
                "lastupdate": 1772226629000
              },
              "geometry": {
                "x": 6812012.94376564,
                "y": 1842394.2167348117,
                "z": 0,
                "m": null
              }
            },
            {
              "attributes": {
                "objectid": 68,
                "assetgroup": 1,
                "assettype": 2,
                "associationstatus": 33,
                "containersourceid": null,
                "containerglobalid": null,
                "nextunitid": 1,
                "conflictcontainerstate": null,
                "partitionid": null,
                "globalid": "{7BABDB1B-C611-4FD4-8F15-0D9115B1F623}",
                "clusterkey": null,
                "creator": null,
                "creationdate": null,
                "updatedby": "unadmin",
                "lastupdate": 1772226676000
              },
              "geometry": {
                "x": 6812012.94376564,
                "y": 1842394.2167348117,
                "z": 0,
                "m": null
              }
            }
          ]
        ]
      }
    }
  ],
  "moment": 1772226675988,
  "success": true
}