- URL:https://<machines-url>/rename(POST only)
- Required Capability:Default administrator role | Security and Infrastructure
- Version Introduced:10.1
Description
When a machine in your ArcGIS Server site is renamed, this operation updates any references to the machine. It is a manual call, but you must use this operation if any of your registered machines undergoes a name change.
By default, when any server machine that participates in a site is restarted, it can identify a name change. When it does, it updates itself and all its references.
Request parameters
| Parameter | Description |
|---|---|
| machineName | The former name of the server machine that is registered with the site. Example |
| newMachineName | The new name of the server machine. Example |
| f | The response format. The default response format is html. Values: html | json | pjson |
Example usage
Below is a sample POST request for rename:
POST /webadaptor/admin/machines/rename HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
machineName=MACHINE.DOMAIN.COM&newMachineName=CHANGED.DOMAIN.COM&f=jsonJSON Response example
{"status": "success"}