POST /config/deployment/hosts/{id}
Updates a host by ID and sends a JMS message to update the pipeline.
Updates a host by the given ID.
MIME Type |
---|
application/json |
Parameter | Type | Optionality | Data Type | MIME Type | Description |
---|---|---|---|---|---|
id |
path |
Required |
Number (Integer) |
text/plain |
Required - The ID of the staged host to be updated. |
fields |
header |
Optional |
String |
text/plain |
Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas. |
Parameter | Data Type | MIME Type | Description | Sample |
---|---|---|---|---|
host |
Object |
application/json |
Required - The host values to be updated. At the moment, the only writable properties are eps_allocation and fpm_allocation. |
{ "appliance": { "id": "String", "type": "String" }, "average_eps": 42, "average_fpm": 42, "components": [ "String <one of: eventcollectoringress, eventcollector, eventprocessor, dataNode, magistrate, ariel_query_server, ariel_proxy_server, vis, assetprofiler, qflow, hostcontext, tunnel, setuptunnel, ecs-ec-ingress, ecs-ec, ecs-ep, resolveragent, resolver_manager, offsiteSource, offsiteTarget, accumulator, data_export, offline_forwarder, qvm, qvmprocessor, qvmscanner, qvmhostedscanner, qvmsiteprotector, arc_builder, tomcat-rm, ziptie-server, qrm, asset_change_publisher, forensicsnode, forensics_realtime, masterdaemon>" ], "compression_enabled": true, "encryption_enabled": true, "eps_allocation": 42, "eps_rate_hardware_limit": 42, "fpm_allocation": 42, "fpm_rate_hardware_limit": 42, "hostname": "String", "id": 42, "license_serial_number": "String", "peak_eps": 42, "peak_fpm": 42, "primary_server_id": 42, "private_ip": "String", "public_ip": "String", "remote_tunnel_initiation_enabled": true, "secondary_server_id": 42, "status": "String <one of: Active, ADDING, Deleted, Deleting, ADD_FAILED, New, ADD_FAILED_VERSION_CHECK, ADD_FAILED_DEPLOY_IN_PROGRESS, ADD_FAILED_RETRY_CONNECTION, ADD_FAILED_HA, ADD_FAILED_CHECK_LOGS, ADD_FAILED_QVMPROCESSOR_ALREADY_EXISTS>", "version": "String" } |
HTTP Response Code | Unique Code | Description |
---|---|---|
200 |
The host was successfully updated. |
|
404 |
1010 |
Could not find the host to update. |
417 |
1011 |
EPS values are expected to be a multiple of the set EPS block. By default the block size is 500. |
417 |
1012 |
FPM values are expected to be a multiple of the set FPM block. By default the block size is 10000. |
417 |
1013 |
The EPS value given does not meet the minimum required EPS 200. |
417 |
1014 |
The FPM value given does not meet the minimum required FPM 200. |
417 |
1016 |
Can't change EPS/FPM values for a host with a serialized license. |
417 |
1017 |
EPS value exceeds hardware limit. |
417 |
1018 |
FPM value exceeds hardware limit. |
417 |
1019 |
EPS value is greater than that available in the license pool. |
417 |
1020 |
FPM value is greater than that available in the license pool. |
422 |
1009 |
null |
500 |
1021 |
null |
Response Description
- id - The ID of this managed host.
- hostname - The host name of this managed host.
- private_ip - The private IP of this managed host.
- public_ip - The public IP of this managed host.
- appliance - An object that represents the appliance type ID and description of this managed host.
- version - The installed version on this managed host.
- status - The status of this managed host.
- eps_rate_hardware_limit - The upper limit for eps_allocation based on hardware constraints for this managed host.
- eps_allocation - The allocated eps rate of this managed host.
- average_eps - The average eps rate of this managed host over the previous month.
- peak_eps - The peak eps rate that was experienced by this managed host over the previous month.
- fpm_rate_hardware_limit - The upper limit for fpm_allocation based on hardware constraints for this managed host.
- fpm_allocation - The allocated fpm rate of this managed host.
- average_fpm - The average fpm rate of this managed host over the previous month.
- peak_fpm - The peak fpm rate that was experienced by this managed host over the previous month.
- primary_server_id - The ID for the primary server host for this managed host.
- secondary_server_id - If configured, the ID for the secondary server host for this managed host.
- license_serial_number - The serial number associated with this managed host's license.
- components - A list of components that are associated with this managed host.
- compression_enabled - Whether or not compression is enabled for this managed host.
- remote_tunnel_initiation_enabled - Whether the tunnels for this host should be started on the remote host or not.
- encryption_enabled - Whether or not encryption is enabled for this managed host.
Response Sample
{
"app_memory": 42,
"appliance": {
"id": "String",
"type": "String"
},
"average_eps": 42,
"average_fpm": 42,
"components": [
"String <one of: eventcollectoringress, eventcollector, eventprocessor, dataNode, magistrate, ariel_query_server, ariel_proxy_server, vis, assetprofiler, qflow, hostcontext, tunnel, setuptunnel, ecs-ec-ingress, ecs-ec, ecs-ep, resolveragent, resolver_manager, offsiteSource, offsiteTarget, accumulator, data_export, offline_forwarder, qvm, qvmprocessor, qvmscanner, qvmhostedscanner, qvmsiteprotector, arc_builder, tomcat-rm, ziptie-server, qrm, asset_change_publisher, forensicsnode, forensics_realtime, masterdaemon>"
],
"compression_enabled": true,
"cpus": 42,
"encryption_enabled": true,
"eps_allocation": 42,
"eps_rate_hardware_limit": 42,
"fpm_allocation": 42,
"fpm_rate_hardware_limit": 42,
"hostname": "String",
"id": 42,
"license_serial_number": "String",
"peak_eps": 42,
"peak_fpm": 42,
"primary_server_id": 42,
"private_ip": "String",
"public_ip": "String",
"remote_tunnel_initiation_enabled": true,
"secondary_server_id": 42,
"status": "String <one of: Active, ADDING, Deleted, Deleting, ADD_FAILED, New, ADD_FAILED_VERSION_CHECK, ADD_FAILED_DEPLOY_IN_PROGRESS, ADD_FAILED_RETRY_CONNECTION, ADD_FAILED_HA, ADD_FAILED_CHECK_LOGS, ADD_FAILED_QVMPROCESSOR_ALREADY_EXISTS>",
"total_memory": 42,
"version": "String"
}