- URL:
- https://<root>/machines/<machine>/edit
- Methods:
POST
- Required Capability:
- Access allowed with the "Security and Infrastructure" privilege
- Version Introduced:
- 10.1
Description
This edit
operation makes changes to the configuration of the specified server machine in an ArcGIS Server site.
Request parameters
Parameter | Description |
---|---|
| The URL where the Administrator API is running on the server machine. Example
|
| This property defines the maximum file size (in MB) that the web server's Java process can send to ArcGIS Server. The default value is -1 MB, meaning the web server will use one-fourth of the available system memory as the maximum heap size. If you are observing a server performance impact and you have additional system memory, you can increase the heap size of the web server by updating this value from the default of -1 MB to an appropriate value. Note that doing so will potentially increase the amount of memory assigned to ArcGIS Server processes by your operating system. If you have a multiple-machine site, this property should be identical on each of your machines. Example
|
| The alias of the web server SSL certificate. Example
|
| This property defines the maximum file size (in MB) that an individual ArcSOC process can send to the ArcGIS Server internal web server. The default value is 64 MB. You may choose to increase this property if you are experiencing performance impacts in your services, for example, if a service is failing to pass a very large JSON file to the server site. If you only want to change the maximum heap size for a specific service, you can do so by specifying the If you have a multiple-machine site, this property should be identical on each of your machines. Example
|
| This property is a flag you can use to designate the machine as being under maintenance (by you, not by the ArcGIS Server site itself). The default value is A machine under maintenance will still honor administrative changes and publishing events made to the site through other ArcGIS Server machines. You can implement similar logic in your third-party load balancer or reverse proxy server to avoid forwarding service requests to machines that fail the health check. This allows you to make changes to the machine (such as updating its OS) without causing service requests to fail. When you are done performing maintenance on the machine, change this property back to Values: |
| The response format. The default response format is Values: |
Example usage
The following is a sample POST request for the edit
operation:
POST /webadaptor/admin/machines/MACHINE.DOMAIN.COM/edit HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
adminURL=https://SERVER1.DOMAIN.COM:port/arcgis/admin&webServerMaxHeapSize=-1&webServerCertificateAlias=server1&socMaxHeapSize=64&underMaintenance=false&f=json
JSON Response example
{"status": "success"}