- URL:
- https://<root>/machines/rename
- Methods:
POST- Required Capability:
- Access allowed with the "Security and Infrastructure" privilege
- Version Introduced:
- 10.1
Description
The rename operation updates any references to the machine when a ArcGIS Server site is renamed. This operation is not automatically called when a registered machine's name is changed. Rather, you must manually call this operation aftering changing a machine's name.
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 |
|---|---|
| The former name of the server machine that is registered with the site. Example |
| The new name of the server machine. Example |
| The response format. The default response format is Values: |
Example usage
The following is a sample POST request for the rename operation:
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"}