- URL:
- https://<root>/<serviceName>/TraceNetworkServer/traceConfigurations/alter
- Methods:
POST- Required Capability:
- Requires the ArcGIS Advanced Editing user type extension license
- Version Introduced:
- 10.9
Description
The alter operation provides the ability to alter a single named trace configuration. A named trace configuration can only be altered by an administrator or the creator of the configuration. For example, you can update an existing trace configuration to accommodate changes in the network or address incorrectly set parameters without the need to delete and re-create a named trace configuration. This enables existing map services to continue use of the named trace configuration without requiring the map to be republished.
Request parameters
| Parameter | Details |
|---|---|
| Specifies the output format of the response. The default response format is Values: |
(Required) | Specifies the global ID of the named trace configuration to alter. |
(Optional) | Specifies the altered name of the named trace configuration. Syntax: |
| Specifies the altered description of the named trace configuration. Syntax: |
(Optional) | The trace type specifies the core algorithm that will be used to analyze the network. Trace types can be configured using the Values: Syntax: Example: |
(Optional) | Specifies the collection of altered trace configuration properties. To reference the collection of trace configuration properties, see traceConfiguration properties. Syntax: |
(Optional) | Specifies the altered types of results to return. Syntax: |
(Optional) | Specifies the altered user-provided tags as an array of strings. Syntax: |
JSON Response syntax
{
“success” : <true | false>,
“error” : { // only if success is false
“extendedCode” : <HRESULT>,
“message” : <error message>,
“details” : [ <detail> ]
}
}Example usage
Alter the name and description of a named trace configuration in a trace network and add two tags using the alter operation.
Request URL and parameters:
https:
f=json
globalId={51D30E0E-C37C-4D29-A572-659A5BCC0E2A}
name=ConnectedTrace_update
description=Connected trace example(updated 112020)
traceType=connected
traceConfiguration= {}
resultTypes=[]
tags=["newTag1", "newTag2"]JSON response:
{
"success": true
}