Citrix ADM NITRO API Reference

instance_score

Configuration for Instance Score resource.

Properties

(click to see Operations )

Name Data Type Permissions Description
data_nic_discards_in <Double> Read-write nic discards on incoming packets indicating device name and the number of nic discards.
data_rl_ssl_tps <Double> Read-write Number of times the SSL transactions/s(TPS) rate limit was reached.
num_rl_ssl_throughput <Integer> Read-write Number of times the SSL Throughput rate limit was reached from the last poll cycle.
num_rl_cpu <Integer> Read-write Number of packets dropped when the CPU rate limit was reached from the last poll cycle.
hostname <String> Read-write Assign hostname to managed device, if this is not provided, name will be set as host name .

Minimum length = 1

Maximum length = 256
ind_sslcert_notrecommended_algorithm <Integer> Read-write Indicates where ssl certs of not recommended algorithm exists or not.0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
vm_memory_total <Double> Read-write Total Memory of VM Instance in MB. 2048MB, 5120MB.
ind_rl_cpu <Integer> Read-write Indicates if the CPU rate limit was reached.
num_sslcert_notrecommended_keystrengh <Integer> Read-write Number of not recommended key strength certificates.
num_applications_total <Integer> Read-write Number of total applications.
data_pooled_license_events <String> Read-write List of categories from active_event table representing the current outstanding pooled license events.
ind_flash_error <Integer> Read-write Flash Indicator.0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
data_capacity_mem <String> Read-write MEM predicted values. Stores comma separated list of data.
ind_rule_networking <Integer> Read-write Indicates if errors related to networking rules on has occured or not.0 indicates no errors,1 indicates errors,-1 indicates not evaluated.
instance_state <String> Read-write State of device, UP only if device accessible.

Minimum length = 1

Maximum length = 64
data_cpu_used_mgmt <Double> Read-write Management Cpu usage percentage.
data_rl_rate <Double> Read-write Number of packets dropped when the throughput rate limit was reached.
ind_sslcert_expiry_due <Integer> Read-write Indicator of SSL Cert expiry in the next 7 days.
num_rule_capacity <Integer> Read-write Number of rules occuring in the poll cycle for Capacity category.
num_rule_networking <Integer> Read-write Number of rules occuring in the poll cycle for networking category.
ssl_transaction_rate <Double> Read-write ssltransactionsrate Value.
num_applications_managed <Integer> Read-write Number of managed applications.
ind_rl_pps <Integer> Read-write Indicates if the packet/s(PPS) rate limit was reached.
ind_rule_capacity <Integer> Read-write Indicates if errors related to Capacity rules on has occured or not.0 indicates no errors,1 indicates errors,-1 indicates not evaluated.
num_total_errors <Integer> Read-write Number of total failures.
ind_cpu_used <Integer> Read-write CPU Usage Indicator. 0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
num_critical_events <Integer> Read-write Number of total critical events.
data_disk0_total <Double> Read-write Disk0 total space in MB.
ind_power_error <Integer> Read-write Power Indicator. 0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
num_rl_ssl_tps <Integer> Read-write Number of times the SSL transactions/s(TPS) rate limit was reached from last poll cycle.
data_disk1_free <Double> Read-write Disk1 free space in MB.
current_instance_state <String> Read-write Current State of device, UP only if device accessible.

Minimum length = 1

Maximum length = 64
data_rl_pps <Double> Read-write Number of packets dropped when the packet/s(PPS) rate limit was reached.
tcpserver_connection <Double> Read-write tcpcurserverconnestablished Value .
httprequest_rate <Double> Read-write httprxrequestbytesrate Value.
data_rl_cpu <Double> Read-write Number of packets dropped when the CPU rate limit was reached.
num_config_deviation_errors <Integer> Read-write Number of total config drifts.
num_rl_rate <Integer> Read-write Number of packets dropped when the throughput rate limit was reached from the last poll cycle.
num_sslcert_expired <Integer> Read-write Number of ssl certs expired.
site_name <String> Read-write Datacenter Name.
data_disk0_free <Double> Read-write Disk0 Free space in MB.
ind_capacity_cpu <Integer> Read-write Indicates event occurs.0 indicates no ,1 indicates event occurs,-1 indicates not evaluated.
num_platform_pps_events <Integer> Read-write Total number of errors related to Platform PPS.
data_memory_used <Double> Read-write Data Memory used in percentage.
data_rl_ssl_throughput <Double> Read-write Number of times the SSL Throughput rate limit was reached.
rx_throughput <Double> Read-write rxmbitsrate Value.
datacenter_id <String> Read-write Datacenter Id.
version <String> Read-write version.
num_rule_security <Integer> Read-write Number of rules occuring in the poll cycle for Security category.
managed_device_id <String> Read-write id of the instance in managed device table.
num_capacity_mem <Integer> Read-write Number of occuring in the poll cycle.
data_rule_security <String> Read-write Rules triggered for Security errors. Stores comma separated list of rules data in the format ruleid:rulename.Example id1:name1,id2:name2.
data_platform_pps_events <String> Read-write List of categories from active_event table representing the current outstanding platform PPS events.
num_aggregate_bw_events <Integer> Read-write Total number of errors related to Aggregate Bandwidth.
num_systemresource_errors <Integer> Read-write Number of total system resource failures.
data_disk1_used <Double> Read-write Disk1 used space in percentage.
num_rule_system_resource <Integer> Read-write Number of rules occuring in the poll cycle for system resource category.
model <String> Read-write model.
num_configdrift_template <Integer> Read-write Number of RunningVsTemplate Diffs.
tcpclient_connection <Double> Read-write tcpcurclientconnestablished Value.
num_pooled_license_events <Integer> Read-write Total number of erros related to pooled license.
ind_sslcert_notrecommended_issuer <Integer> Read-write Indicates where ssl certs of not recommended issuer exists or not.0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
data_rule_networking <String> Read-write Rules triggered for Networking errors. Stores comma separated list of rules data in the format ruleid:rulename.Example id1:name1,id2:name2.
ind_sslcert_expired <Integer> Read-write Indicates if there are any expired SSL Certs.0 indicates no expiry, 1 indicates expiry and -1 indicates Not-Applicable or Unknown.
num_sslcert_expiry_due <Integer> Read-write Number of ssl certs to expire within the next 7 days.
uptime <String> Read-write Up time.
data_critical_events <String> Read-write List of categories from active_event table representing the current outstanding critical events.
id <String> Read-write Id is system generated key.
num_ssl_errors <Integer> Read-write Number of total errors related to SSL Certificates.
data_disk0_used <Double> Read-write Disk0 used space in percentage.
ind_memory_used <Integer> Read-write Memory Usage Indicator. 0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
ind_configdrift_default <Integer> Read-write SavedVsRunning diff state.0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
tx_throughput <Double> Read-write txmbitsrate Value.
num_rl_pps <Integer> Read-write Number of packets dropped when the packet/s(PPS) rate limit was reached from the last polll cycle.
is_clip <Boolean> Read-write Is Clip.
num_ssl_cards <Integer> Read-write Number of ssl cards.
data_rule_config <String> Read-write Rules triggered for Config errors. Stores comma separated list of rules data in the format ruleid:rulename.Example id1:name1,id2:name2.
poll_time <Double> Read-write Poll time in seconds.
httpresponse_rate <Double> Read-write httprxresponsebytesrate Value.
ind_rl_ssl_tps <Integer> Read-write Indicates if the SSL transactions/s(TPS) rate limit was reached.
ind_rl_rate <Integer> Read-write Indicates if the throughput rate limit was reached.
scale <String> Read-write Scale.
system_poll_time <Double> Read-write Time when the device score poll was initiated for this tenant in seconds.
type <String> Read-write Type.
num_capacity_cpu <Integer> Read-write Number of occuring in the poll cycle.
ind_rl_ssl_throughput <Integer> Read-write Indicates if the SSL Throughput rate limit was reached.
data_rule_capacity <String> Read-write Rules triggered for Capacity errors. Stores comma separated list of rules data in the format ruleid:rulename.Example id1:name1,id2:name2.
ind_configdrift_template <Integer> Read-write RunningVsTemplate diff state.
ind_rule_security <Integer> Read-write Indicates if errors related to Security rules on has occured or not.0 indicates no errors,1 indicates errors,-1 indicates not evaluated.
ind_harddiskdrive_error <Integer> Read-write Hard disk drive error indicator.0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
data_memory_free <Double> Read-write Memory Available in MB.
num_capacity_errors <Integer> Read-write Number of total system capacity failures.
ind_rule_system_resource <Integer> Read-write Indicates if errors related to system resource rules on has occured or not.0 indicates no errors,1 indicates errors,-1 indicates not evaluated.
num_vservers_total <Integer> Read-write Number of total vservers.
ind_sslcert_notrecommended_keystrengh <Integer> Read-write Not recommeded key strength certificates exists or not.0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
data_capacity_cpu <String> Read-write CPU predicted values. Stores comma separated list of data.
num_rule_config <Integer> Read-write Number of rules occuring in the poll cycle for config category.
cluster_node_ip_list <String> Read-write Comma separated list of cluster node IPs.
ip_address <String> Read-write IP Address for this managed device.

Minimum length = 1

Maximum length = 64
data_rule_system_resource <String> Read-write Rules triggered for system resource errors. Stores comma separated list of rules data in the format ruleid:rulename.Example id1:name1,id2:name2.
data_aggregate_bw_events <String> Read-write List of categories from active_event table representing the current outstanding aggregate bandwidth events.
ind_nic_discards <Integer> Read-write Indicates if errors related to nic discards on incoming/outgoing packets has occured or not.
max_contribution <String> Read-write Instance score category contributing to the maximum errors.
ind_disk_used <Integer> Read-write Disk Usage Indicator. 0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
ind_platform_pps_events <Integer> Read-write Indicates if errors related to Platform PPS has occured or not.
num_vservers_active <Integer> Read-write Number of active vservers.
ind_rule_config <Integer> Read-write Indicates if errors related to Config rules on has occured or not.0 indicates no errors,1 indicates errors,-1 indicates not evaluated.
ind_aggregate_bw_events <Integer> Read-write Indicates if errors related to Aggregate Bandwidth has occurred or not.
score <Integer> Read-write Total Instance score.
display_name <String> Read-write Display Name for this managed device. For HA pair it will be A-B, and for Cluster it will be CLIP.

Minimum length = 1

Maximum length = 128
num_sslcert_notrecommended_algorithm <Integer> Read-write Number of sslcert with non recommended algorithm.
data_cpu_used_packet <Double> Read-write Packet Cpu usage percentage.
data_disk1_total <Double> Read-write Disk1 total space in MB.
ind_pooled_license_events <Integer> Read-write Indicates if erros related to pooled license has occured or not.
ind_ssl_card_error <Integer> Read-write SSL card failure state indicator.0 indicates no errors, 1 indicate error and -1 indicates Not-Applicable or Unknown.
data_nic_discards_out <Double> Read-write nic discards on outgoing packets indicating device name and the number of nic discards.
num_sslcert_notrecommended_issuer <Integer> Read-write Number of not recommended issuer certificates.
ind_capacity_mem <Integer> Read-write Indicates event occurs.0 indicates no ,1 indicates event occurs,-1 indicates not evaluated.
th_rl_pps_high <Double> Read-write RL PPS high threshold.
th_memory_used_high <Double> Read-write Memory high threshold.
th_nic_discards_high <Double> Read-write Nic discards high threshold.
th_rl_rate_high <Double> Read-write RL rate high threshold.
th_rl_ssl_throughput_high <Double> Read-write RL SSL Throughput high threshold.
th_cpu_used_low <Double> Read-write CPU low threshold.
th_disk_used_low <Double> Read-write Disk low threshold.
th_memory_used_low <Double> Read-write Memory low threshold.
th_cpu_used_high <Double> Read-write CPU high threshold.
th_rl_ssl_tps_high <Double> Read-write RL SSL TPS high threshold.
th_disk_used_high <Double> Read-write Disk high threshold.
entity_tag <property_map[]> Read-write Array of tag_name and tag_value pair associated with an instance.
th_rl_cpu_high <Double> Read-write RL CPU high threshold.
tenant_id <String> Read-only Tenant ID.

Operations

(click to see Properties )

  • GET (ALL)

Some options that you can use for each operations:

  • Getting warnings in response: NITRO allows you to get warnings in an operation by specifying the 'warning' query parameter as 'yes'. For example, to get warnings while connecting to the NetScaler appliance, the URL is as follows:

    http:// <netscaler-ip-address> /nitro/v1/config/login?warning=yes

    If any, the warnings are displayed in the response payload with the HTTP code '209 X-NITRO-WARNING'.

  • Authenticated access for individual NITRO operations: NITRO allows you to logon to the NetScaler appliance to perform individual operations. You can use this option instead of creating a NITRO session (using the login object) and then using that session to perform all operations,

    To do this, you must specify the username and password in the request header of the NITRO request as follows:

    X-NITRO-USER: <username>

    X-NITRO-PASS: <password>

    Note: In such cases, make sure that the request header DOES not include the following:

    Cookie:NITRO_AUTH_TOKEN= <tokenvalue>

*Note: * Mandatory parameters are marked in red and placeholder content is marked in green

The following parameters can be used in the nitro request : onerror <String_value>

Use this parameter to set the onerror status for nitro request. Applicable only for bulk requests.

Default value: EXIT

Possible values = EXIT, CONTINUE

get (all)

URL: https://<MGMT-IP>/nitro/v2/config/instance_score Query-parameters:

filter https://<MGMT-IP>/nitro/v2/config/instance_score ?filter=property-name1:property-value1,property-name2:property-value2 Use this query-parameter to get the filtered set of instance_score resources configured on the system. You can set a filter on any property of the resource.

pagesize=#no;pageno=#no https://<MGMT-IP>/nitro/v2/config/instance_score ?pagesize=#no;pageno=#no Use this query-parameter to get the instance_score resources in chunks.

count https://<MGMT-IP>/nitro/v2/config/instance_score ?count=yes Use this query-parameter to get the count of instance_score resources.

HTTPS Method: GET

Request Headers: Accept: application/json

X-NITRO-USER:username_value<String>

X-NITRO-PASS:password_value<String>

or

Cookie:NITRO_AUTH_TOKEN=token_value<String>

Response: HTTPS Status Code on Success: 200 OK HTTPS Status Code on Failure: 4xx (for general HTTPS errors) or 5xx (for NetScaler-MAS-specific errors). The response payload provides details of the error

Response Headers:

Content-Type:application/json

Response Payload:

{ "errorcode": 0, "message": "Done", "severity": ;ltString_value;gt, "instance_score":[{
"data_nic_discards_in":<Double_value>,
"data_rl_ssl_tps":<Double_value>,
"num_rl_ssl_throughput":<Integer_value>,
"num_rl_cpu":<Integer_value>,
"hostname":<String_value>,
"ind_sslcert_notrecommended_algorithm":<Integer_value>,
"vm_memory_total":<Double_value>,
"ind_rl_cpu":<Integer_value>,
"num_sslcert_notrecommended_keystrengh":<Integer_value>,
"num_applications_total":<Integer_value>,
"data_pooled_license_events":<String_value>,
"ind_flash_error":<Integer_value>,
"data_capacity_mem":<String_value>,
"ind_rule_networking":<Integer_value>,
"instance_state":<String_value>,
"data_cpu_used_mgmt":<Double_value>,
"data_rl_rate":<Double_value>,
"ind_sslcert_expiry_due":<Integer_value>,
"num_rule_capacity":<Integer_value>,
"num_rule_networking":<Integer_value>,
"ssl_transaction_rate":<Double_value>,
"num_applications_managed":<Integer_value>,
"ind_rl_pps":<Integer_value>,
"ind_rule_capacity":<Integer_value>,
"num_total_errors":<Integer_value>,
"ind_cpu_used":<Integer_value>,
"num_critical_events":<Integer_value>,
"data_disk0_total":<Double_value>,
"ind_power_error":<Integer_value>,
"num_rl_ssl_tps":<Integer_value>,
"data_disk1_free":<Double_value>,
"current_instance_state":<String_value>,
"data_rl_pps":<Double_value>,
"tcpserver_connection":<Double_value>,
"httprequest_rate":<Double_value>,
"tenant_id":<String_value>,
"data_rl_cpu":<Double_value>,
"num_config_deviation_errors":<Integer_value>,
"num_rl_rate":<Integer_value>,
"num_sslcert_expired":<Integer_value>,
"site_name":<String_value>,
"data_disk0_free":<Double_value>,
"ind_capacity_cpu":<Integer_value>,
"num_platform_pps_events":<Integer_value>,
"data_memory_used":<Double_value>,
"data_rl_ssl_throughput":<Double_value>,
"rx_throughput":<Double_value>,
"datacenter_id":<String_value>,
"version":<String_value>,
"num_rule_security":<Integer_value>,
"managed_device_id":<String_value>,
"num_capacity_mem":<Integer_value>,
"data_rule_security":<String_value>,
"data_platform_pps_events":<String_value>,
"num_aggregate_bw_events":<Integer_value>,
"num_systemresource_errors":<Integer_value>,
"data_disk1_used":<Double_value>,
"num_rule_system_resource":<Integer_value>,
"model":<String_value>,
"num_configdrift_template":<Integer_value>,
"tcpclient_connection":<Double_value>,
"num_pooled_license_events":<Integer_value>,
"ind_sslcert_notrecommended_issuer":<Integer_value>,
"data_rule_networking":<String_value>,
"ind_sslcert_expired":<Integer_value>,
"num_sslcert_expiry_due":<Integer_value>,
"uptime":<String_value>,
"data_critical_events":<String_value>,
"id":<String_value>,
"num_ssl_errors":<Integer_value>,
"data_disk0_used":<Double_value>,
"ind_memory_used":<Integer_value>,
"ind_configdrift_default":<Integer_value>,
"tx_throughput":<Double_value>,
"num_rl_pps":<Integer_value>,
"is_clip":<Boolean_value>,
"num_ssl_cards":<Integer_value>,
"data_rule_config":<String_value>,
"poll_time":<Double_value>,
"httpresponse_rate":<Double_value>,
"ind_rl_ssl_tps":<Integer_value>,
"ind_rl_rate":<Integer_value>,
"scale":<String_value>,
"system_poll_time":<Double_value>,
"type":<String_value>,
"num_capacity_cpu":<Integer_value>,
"ind_rl_ssl_throughput":<Integer_value>,
"data_rule_capacity":<String_value>,
"ind_configdrift_template":<Integer_value>,
"ind_rule_security":<Integer_value>,
"ind_harddiskdrive_error":<Integer_value>,
"data_memory_free":<Double_value>,
"num_capacity_errors":<Integer_value>,
"ind_rule_system_resource":<Integer_value>,
"num_vservers_total":<Integer_value>,
"ind_sslcert_notrecommended_keystrengh":<Integer_value>,
"data_capacity_cpu":<String_value>,
"num_rule_config":<Integer_value>,
"cluster_node_ip_list":<String_value>,
"ip_address":<String_value>,
"data_rule_system_resource":<String_value>,
"data_aggregate_bw_events":<String_value>,
"ind_nic_discards":<Integer_value>,
"max_contribution":<String_value>,
"ind_disk_used":<Integer_value>,
"ind_platform_pps_events":<Integer_value>,
"num_vservers_active":<Integer_value>,
"ind_rule_config":<Integer_value>,
"ind_aggregate_bw_events":<Integer_value>,
"score":<Integer_value>,
"display_name":<String_value>,
"num_sslcert_notrecommended_algorithm":<Integer_value>,
"data_cpu_used_packet":<Double_value>,
"data_disk1_total":<Double_value>,
"ind_pooled_license_events":<Integer_value>,
"ind_ssl_card_error":<Integer_value>,
"data_nic_discards_out":<Double_value>,
"num_sslcert_notrecommended_issuer":<Integer_value>,
"ind_capacity_mem":<Integer_value>,
"th_rl_pps_high":<Double_value>,
"th_memory_used_high":<Double_value>,
"th_nic_discards_high":<Double_value>,
"th_rl_rate_high":<Double_value>,
"th_rl_ssl_throughput_high":<Double_value>,
"th_cpu_used_low":<Double_value>,
"th_disk_used_low":<Double_value>,
"th_memory_used_low":<Double_value>,
"th_cpu_used_high":<Double_value>,
"th_rl_ssl_tps_high":<Double_value>,
"th_disk_used_high":<Double_value>,
"entity_tag":[{
"prop_value":<String_value>,
"prop_key":<String_value>}],
"th_rl_cpu_high":<Double_value>}]}

<!--NeedCopy-->
instance_score