Skip To Content
ArcGIS Developers
Dashboard

Rename Machine

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

ParameterDescription
machineName

The former name of the server machine that is registered with the site.

Example

machineName=MACHINE.DOMAIN.COM
newMachineName

The new name of the server machine.

Example

newMachineName=CHANGED.DOMAIN.COM
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=json

JSON Response example

{"status": "success"}