vm_device
Configuration for VM Device resource.
Properties
(click to see Operations )
Name | Data Type | Permissions | Description |
---|---|---|---|
image_name |
|
Read-write | Image Name, This parameter is used while provisioning VM Instance with XVA image, template_name is given priority if provided along with image_name.
Minimum length = 1 Maximum length = 128 |
hostname |
|
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 |
std_bw_config |
|
Read-write | Standard Bandwidth running. |
vm_memory_total |
|
Read-write | Total Memory of VM Instance in MB. 2048MB, 5120MB. |
gateway_ipv6 |
|
Read-write | Gateway IPv6 Address. |
throughput_limit |
|
Read-write | Throughput Limit in Mbps set for VM Instance. |
vlan_id_0_1 |
|
Read-write | VLAN id for the management interface 0/1.
Maximum value = |
name |
|
Read-write | Name of managed device.
Minimum length = 1 Maximum length = 128 |
description |
|
Read-write | Description of managed device.
Minimum length = 1 Maximum length = 512 |
ent_bw_available |
|
Read-write | Enterprise Bandwidth configured. |
fips_partition_name |
|
Read-write | FIPS Partition Name.
Minimum length = 1 Maximum length = 128 |
mastools_version |
|
Read-write | Mastools version if the device is embedded agent. |
ent_bw_total |
|
Read-write | Enterprise Bandwidth Total. |
vcpu_config |
|
Read-write | Number of vCPU allocated for the device. |
burst_priority |
|
Read-write | Burst Priority of the VM Instance between 1 and 4. |
netmask |
|
Read-write | Netmask of managed device.
Minimum length = 1 Maximum length = 64 |
ent_bw_config |
|
Read-write | Enterprise Bandwidth configured. |
datacenter_id |
|
Read-write | Datacenter Id is system generated key for data center. |
is_managed |
|
Read-write | Is Managed. |
instance_mode |
|
Read-write | Denotes state- primary,secondary,clip,clusternode. |
nexthop_v6 |
|
Read-write | Next Hop IPv6 Address. |
ipv4_address |
|
Read-write | IPv4 Address.
Minimum length = 1 Maximum length = 64 |
profile_name |
|
Read-write | Device Profile Name that is attached with this managed device.
Minimum length = 1 Maximum length = 128 |
std_bw_available |
|
Read-write | Standard Bandwidth Available. |
internal_ip_address |
|
Read-write | Internal IP Address for this managed device.
Minimum length = 1 Maximum length = 64 |
network_interfaces | <network_interface[]> | Read-write | Network Interfaces. |
last_updated_time |
|
Read-write | Last Updated Time. |
plt_bw_total |
|
Read-write | Total Platinum Bandwidth. |
host_ip_address |
|
Read-write | Host IPAddress where VM is provisioned.
Minimum length = 1 Maximum length = 64 |
id |
|
Read-write | Id is system generated key for all the managed devices. |
ipv6_address |
|
Read-write | IPv6 Address. |
mgmt_ip_address |
|
Read-write | Management IP Address for this Managed Device.
Minimum length = 1 Maximum length = 64 |
license_edition |
|
Read-write | Edition of instance. |
number_of_acu |
|
Read-write | Assign number of asymmetric crypto units to VM Instance. |
plt_bw_available |
|
Read-write | Platinum Bandwidth Available. |
device_family |
|
Read-write | Device Family.
Minimum length = 1 Maximum length = 64 |
license_grace_time |
|
Read-write | Grace for this Citrix Instance.. |
la_mgmt |
|
Read-write | Bond consisting of management ports on VM Instance. |
vlan_id_0_2 |
|
Read-write | VLAN id for the management interface 0/2.
Maximum value = |
number_of_ssl_cores |
|
Read-write | Assign number of ssl virtual functions to VM Instance. |
type |
|
Read-write | Type of device, (Xen | NS).
Minimum length = 1 Maximum length = 64 |
throughput |
|
Read-write | Assign throughput in Mbps to VM Instance. |
template_name |
|
Read-write | Template Name, This parameter is used while provisioning VM Instance with template, template_name is given priority if provided along with image_name.
Minimum length = 1 Maximum length = 128 |
gateway |
|
Read-write | Default Gateway of managed device.
Minimum length = 1 Maximum length = 64 |
max_burst_throughput |
|
Read-write | Maximum burst throughput in Mbps of VM Instance. |
config_type |
|
Read-write | Configuration Type. Values: 0: IPv4, 1: IPv6, 2: Both.
Maximum value = |
if_internal_ip_enabled |
|
Read-write | Set as true if VPX is managed by internal network (not required to be set for SDWAN). |
node_id |
|
Read-write | Node identification of a device. |
ip_address |
|
Read-write | IP Address for this managed device.
Minimum length = 1 Maximum length = 64 |
throughput_allocation_mode |
|
Read-write | Throughput Allocation Mode: 0-Fixed, 1-Burst-able. |
number_of_scu |
|
Read-write | Assign number of asymmetric crypto units to VM Instance. |
number_of_cores |
|
Read-write | Number of cores that are assigned to VM Instance. |
display_name |
|
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 |
std_bw_total |
|
Read-write | Standard Bandwidth. |
domain_name |
|
Read-write | Domain name of VM Device.
Minimum length = 1 Maximum length = 128 |
nexthop |
|
Read-write | Next Hop IP address.
Minimum length = 1 Maximum length = 64 |
plt_bw_config |
|
Read-write | Platinum Bandwidth configured. |
vlan_1_2 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 1/2 on VM Instance.
Maximum value = |
vrid_list_ipv4_1_2 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/2 for IPV4 VMAC Generation. |
vlan_1_7 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 1/7 on VM Instance.
Maximum value = |
vrid_list_ipv6_1_2 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/2 for IPV6 VMAC Generation. |
vrid_list_ipv4_1_4 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/4 for IPV4 VMAC Generation. |
vrid_list_ipv6_10_6 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/6 for IPV6 VMAC Generation. |
if_10_4 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 10/4 on VM Instance. |
vlan_10_5 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 10/5 on VM Instance.
Maximum value = |
vrid_list_ipv6_10_3 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/3 for IPV6 VMAC Generation. |
vrid_list_ipv6_1_1 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/1 for IPV6 VMAC Generation. |
if_1_5 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 1/5 on VM Instance. |
receiveuntagged_1_4 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 1/4 on VM Instance. |
vrid_list_ipv6_10_4 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/4 for IPV6 VMAC Generation. |
vrid_list_ipv6_1_3 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/3for IPV6 VMAC Generation. |
if_10_3 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 10/3 on VM Instance. |
vrid_list_ipv6_10_5 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/5 for IPV6 VMAC Generation. |
receiveuntagged_10_4 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 10/4 on VM Instance. |
vrid_list_ipv6_1_8 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/8 for IPV6 VMAC Generation. |
vlan_10_6 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 10/6 on VM Instance.
Maximum value = |
if_10_5 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 10/5 on VM Instance. |
is_new_crypto |
|
Read-write | True if number_of_acu/number_of_scu are used, false if number_of_ssl_cores is used. |
vrid_list_ipv6_1_6 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/6 for IPV6 VMAC Generation. |
profile_username |
|
Read-write | User Name specified by the user for this Citrix ADC Instance..
Minimum length = 1 Maximum length = 128 |
if_10_7 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 10/7 on VM Instance. |
receiveuntagged_10_8 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 10/8 on VM Instance. |
vrid_list_ipv6_1_4 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/4 for IPV6 VMAC Generation. |
receiveuntagged_1_6 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 1/6 on VM Instance. |
vlan_1_4 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 1/4 on VM Instance.
Maximum value = |
if_1_2 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 1/2 on VM Instance. |
receiveuntagged_1_5 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 1/5 on VM Instance. |
receiveuntagged_10_6 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 10/6 on VM Instance. |
receiveuntagged_10_1 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 10/1 on VM Instance. |
vrid_list_ipv4_1_6 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/6 for IPV4 VMAC Generation. |
vrid_list_ipv6_1_5 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/5 for IPV6 VMAC Generation. |
vrid_list_ipv6_10_8 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/8 for IPV6 VMAC Generation. |
vrid_list_ipv4_1_7 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/7 for IPV4 VMAC Generation. |
receiveuntagged_10_2 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 10/2 on VM Instance. |
profile_password |
|
Read-write | Password specified by the user for this Citrix ADC Instance..
Minimum length = 1 Maximum length = 128 |
vrid_list_ipv4_1_5 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/5 for IPV4 VMAC Generation. |
receiveuntagged_1_7 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 1/7 on VM Instance. |
vlan_10_4 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 10/4 on VM Instance.
Maximum value = |
if_1_7 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 1/7 on VM Instance. |
receiveuntagged_1_1 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 1/1 on VM Instance. |
vrid_list_ipv6_1_7 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/7 for IPV6 VMAC Generation. |
if_10_1 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 10/1 on VM Instance. |
if_10_8 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 10/8 on VM Instance. |
l2_enabled |
|
Read-write | L2mode status of VM Instance. |
vlan_10_7 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 10/7 on VM Instance.
Maximum value = |
vlan_10_1 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 10/1 on VM Instance.
Maximum value = |
receiveuntagged_1_2 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 1/2 on VM Instance. |
reboot_vm_on_cpu_change |
|
Read-write | Reboot VMs on CPU change during resource allocation. |
vlan_1_6 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 1/6 on VM Instance.
Maximum value = |
vrid_list_ipv4_1_3 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/3for IPV4 VMAC Generation. |
receiveuntagged_10_7 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 10/7 on VM Instance. |
vrid_list_ipv4_1_1 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/1 for IPV4 VMAC Generation. |
vlan_1_1 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 1/1 on VM Instance.
Maximum value = |
vrid_list_ipv6_10_7 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/7 for IPV6 VMAC Generation. |
vlan_1_8 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 1/8 on VM Instance.
Maximum value = |
vlan_10_2 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 10/2 on VM Instance.
Maximum value = |
receiveuntagged_10_5 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 10/5 on VM Instance. |
vrid_list_ipv4_10_3 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/3 for IPV4 VMAC Generation. |
vrid_list_ipv4_10_6 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/6 for IPV4 VMAC Generation. |
vrid_list_ipv4_1_8 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 1/8 for IPV4 VMAC Generation. |
receiveuntagged_1_8 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 1/8 on VM Instance. |
vrid_list_ipv4_10_4 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/4 for IPV4 VMAC Generation. |
vlan_1_3 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 1/3 on VM Instance.
Maximum value = |
receiveuntagged_10_3 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 10/3 on VM Instance. |
if_10_6 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 10/6 on VM Instance. |
if_1_6 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 1/6 on VM Instance. |
vlan_10_3 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 10/3 on VM Instance.
Maximum value = |
vlan_1_5 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 1/5 on VM Instance.
Maximum value = |
if_1_3 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 1/3 on VM Instance. |
vrid_list_ipv4_10_5 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/5 for IPV4 VMAC Generation. |
if_1_4 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 1/4 on VM Instance. |
vrid_list_ipv4_10_8 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/8 for IPV4 VMAC Generation. |
if_1_1 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 1/1 on VM Instance. |
vrid_list_ipv4_10_7 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/7 for IPV4 VMAC Generation. |
vlan_10_8 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtVLAN for Network 10/8 on VM Instance.
Maximum value = |
receiveuntagged_1_3 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtReceive Untagged Packets on 1/3 on VM Instance. |
crypto_change_requires_reboot |
|
Read-write | True if the current changes made by user requires a reboot of the VM else false. |
vrid_list_ipv4_10_2 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/2 for IPV4 VMAC Generation. |
if_1_8 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 1/8 on VM Instance. |
vrid_list_ipv4_10_1 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/1 for IPV4 VMAC Generation. |
vrid_list_ipv6_10_2 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/2 for IPV6 VMAC Generation. |
if_10_2 |
|
Read-write | This property is deprecated by network_interfaces;ltbr;gtNetwork 10/2 on VM Instance. |
vrid_list_ipv6_10_1 | <String[]> | Read-write | This property is deprecated by network_interfaces;ltbr;gtVRID List for Interface 10/1 for IPV6 VMAC Generation. |
sdxtools_http_port |
|
Read-only | Http Port number to communicate to SDXTools. |
instance_state |
|
Read-only | State of device, UP only if device accessible. |
reason |
|
Read-only | Reason of failure for this managed device. |
virtual_functions |
|
Read-only | Virtual Functions assigned to VM Instance depending on SDX platform. |
disk_space |
|
Read-only | Show Disk Space (GB) available to VM Instance. |
upsince |
|
Read-only | Upsince of managed device. |
domid |
|
Read-only | DOM Id assigned to VM Instance viewed in hypervisor. |
cpu_core_pe |
|
Read-only | Packet Engine cores assigned to VM Instance. |
tenant_id |
|
Read-only | Tenant ID. |
preferred_cpu_socket |
|
Read-only | Preferred CPU Socket. |
device_uuid |
|
Read-only | Device UUID. |
do_config |
|
Read-only | Do default config for managed device. |
version |
|
Read-only | Device Version. |
host_id |
|
Read-only | Host ID. |
has_sdxtools |
|
Read-only | True if SDX Tools are installed on this VM. |
vm_memory_used |
|
Read-only | Memory Used (MB) by VM Instance. |
number_of_cpu |
|
Read-only | Number of CPU that is assigned to VM Instance. |
is_swg |
|
Read-only | Boolean to indicate whether a VM is SWG. |
sysid |
|
Read-only | System ID. |
vm_state |
|
Read-only | State of Virtual Machine (Running | Halted). |
uuid |
|
Read-only | UUID of VM Instance generated by Hypervisor. |
cpu_core_mgmt |
|
Read-only | Management CPU cores assigned to VM Instance. |
ssl_virtual_functions |
|
Read-only | SSL Virtual Functions assigned to VM Instance. |
uptime |
|
Read-only | Uptime of device. |
cpu_license_type |
|
Read-only | VCPU license 0 = No VCPU License, 1 = VCPU Pool license. |
assigned_cpu_socket |
|
Read-only | Assigned CPU Socket 0 or 1. |
sdxtools_public_key |
|
Read-only | SDXTools HTTPS Public Key. |
status |
|
Read-only | Status of managed device. |
vm_description |
|
Read-only | Description of the VM instance. |
systemname |
|
Read-only | Device System Name. |
mac_eth0 |
|
Read-only | MAC Address of eth0 on VM Instance. |
vm_rx |
|
Read-only | In Throughput of VM Instance in Mbps. |
disk_allocation |
|
Read-only | Disk allocation for VM Instance. |
vm_tx |
|
Read-only | Out Throughput of VM Instance in Mbps. |
vm_memory_free |
|
Read-only | Free Memory (MB) available in VM Instance. |
vm_memory_usage |
|
Read-only | Memory Usage (%) of VM Instance. |
sdxtools_version |
|
Read-only | SDXTools version running on VM Instance. |
vm_cpu_usage |
|
Read-only | CPU Usage (%) of VM Instance. |
act_id |
|
Read-only | Activity Id. |
Operations
(click to see Properties )
- GET (ALL)
- GET
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/vm_device Query-parameters:
filter https://<MGMT-IP>/nitro/v2/config/vm_device ?filter=property-name1:property-value1,property-name2:property-value2 Use this query-parameter to get the filtered set of vm_device 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/vm_device ?pagesize=#no;pageno=#no Use this query-parameter to get the vm_device resources in chunks.
count https://<MGMT-IP>/nitro/v2/config/vm_device ?count=yes Use this query-parameter to get the count of vm_device 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, "vm_device":[{
"image_name":<String_value>,
"is_grace":<Boolean_value>,
"hostname":<String_value>,
"std_bw_config":<Integer_value>,
"vm_memory_total":<Double_value>,
"is_internal_intf_added":<Boolean_value>,
"gateway_ipv6":<String_value>,
"throughput_limit":<Double_value>,
"sdxtools_http_port":<Integer_value>,
"instance_state":<String_value>,
"vlan_id_0_1":<Integer_value>,
"vnc_console_url":<String_value>,
"provision_with_xva":<Boolean_value>,
"name":<String_value>,
"reason":<String_value>,
"virtual_functions":<String_value>,
"disk_space":<Double_value>,
"description":<String_value>,
"ent_bw_available":<Integer_value>,
"is_pooled_license":<Boolean_value>,
"upsince":<String_value>,
"fips_partition_name":<String_value>,
"domid":<Double_value>,
"cpu_core_pe":<String_value>,
"user_driven":<Boolean_value>,
"mastools_version":<String_value>,
"ent_bw_total":<Integer_value>,
"host_type":<String_value>,
"tenant_id":<String_value>,
"vcpu_config":<Integer_value>,
"preferred_cpu_socket":<String_value>,
"burst_priority":<Integer_value>,
"netmask":<String_value>,
"device_uuid":<String_value>,
"ent_bw_config":<Integer_value>,
"do_config":<Boolean_value>,
"version":<String_value>,
"host_id":<String_value>,
"datacenter_id":<String_value>,
"has_sdxtools":<Boolean_value>,
"is_managed":<Boolean_value>,
"old_max_burst_throughput":<Double_value>,
"instance_mode":<String_value>,
"vm_memory_used":<Double_value>,
"number_of_cpu":<Integer_value>,
"nexthop_v6":<String_value>,
"ipv4_address":<String_value>,
"profile_name":<String_value>,
"std_bw_available":<Integer_value>,
"seq_no":<Double_value>,
"is_swg":<Boolean_value>,
"internal_ip_address":<String_value>,
"dns":<String_value>,
"sysid":<String_value>,
"network_interfaces":[{
"device_channel_name":<String_value>,
"is_mgmt_ifc":<Boolean_value>,
"name_server":<String_value>,
"vrid_list_ipv6":<String_value>,
"gateway":<String_value>,
"channel_tag_all_vlans":<Boolean_value>,
"xen_vf_index":<Integer_value>,
"parent_id":<String_value>,
"vrid_list_ipv4":<String_value>,
"is_member_ifc":<Boolean_value>,
"mac_address":<String_value>,
"parent_channel_id":<String_value>,
"channel_type":<String_value>,
"l2_enabled":<Boolean_value>,
"id":<String_value>,
"ip_address":<String_value>,
"netmask":<String_value>,
"port_name":<String_value>,
"parent_name":<String_value>,
"channel_timeout":<String_value>,
"mac_mode":<String_value>,
"channel_ha_monitoring":<Boolean_value>,
"managed_device_id":<String_value>,
"vlan":<Integer_value>,
"receiveuntagged":<Boolean_value>,
"sdx_formation_network_id":<String_value>,
"vlan_whitelist":<String_value>
"interface_name":<String_value>
"vrid_list_ipv4_array":<String_value>
"vrid_list_ipv6_array":<String_value>
"vlan_whitelist_array":<String_value>
"is_vlan_applied":<Boolean_value>}],
"vm_state":<String_value>,
"uuid":<String_value>,
"last_updated_time":<Double_value>,
"cpu_core_mgmt":<String_value>,
"ssl_virtual_functions":<String_value>,
"old_throughput":<Double_value>,
"uptime":<String_value>,
"plt_bw_total":<Integer_value>,
"host_ip_address":<String_value>,
"id":<String_value>,
"ipv6_address":<String_value>,
"mgmt_ip_address":<String_value>,
"license_edition":<String_value>,
"number_of_acu":<Integer_value>,
"plt_bw_available":<Integer_value>,
"cpu_license_type":<Integer_value>,
"device_family":<String_value>,
"license_grace_time":<Integer_value>,
"la_mgmt":<Boolean_value>,
"assigned_cpu_socket":<String_value>,
"vlan_id_0_2":<Integer_value>,
"number_of_ssl_cores":<Integer_value>,
"type":<String_value>,
"throughput":<Double_value>,
"sdxtools_public_key":<String_value>,
"template_name":<String_value>,
"status":<String_value>,
"gateway":<String_value>,
"vm_description":<String_value>,
"max_burst_throughput":<Double_value>,
"config_type":<Integer_value>,
"systemname":<String_value>,
"mac_eth0":<String_value>,
"if_internal_ip_enabled":<Boolean_value>,
"vm_rx":<Double_value>,
"node_id":<String_value>,
"privStr":<String_value>,
"disk_allocation":<String_value>,
"vm_tx":<Double_value>,
"ip_address":<String_value>,
"throughput_allocation_mode":<Integer_value>,
"number_of_scu":<Integer_value>,
"ping_state":<Integer_value>,
"number_of_cores":<Integer_value>,
"display_name":<String_value>,
"std_bw_total":<Integer_value>,
"domain_name":<String_value>,
"nexthop":<String_value>,
"vm_memory_free":<Double_value>,
"plt_bw_config":<Integer_value>,
"formation_instance_id":<String_value>,
"vm_memory_usage":<Double_value>,
"sdxtools_version":<String_value>,
"vm_cpu_usage":<Double_value>,
"parent_inventory":<Boolean_value>,
"vlan_1_2":<Integer_value>,
"vrid_list_ipv4_1_2":<String_value>,
"vlan_1_7":<Integer_value>,
"vrid_list_ipv6_1_2":<String_value>,
"vrid_list_ipv4_1_4":<String_value>,
"act_id":<String_value>,
"vrid_list_ipv6_10_6":<String_value>,
"if_10_4":<Boolean_value>,
"vlan_10_5":<Integer_value>,
"vrid_list_ipv6_10_3":<String_value>,
"vrid_list_ipv6_1_1":<String_value>,
"if_1_5":<Boolean_value>,
"receiveuntagged_1_4":<Boolean_value>,
"vrid_list_ipv6_10_4":<String_value>,
"vrid_list_ipv6_1_3":<String_value>,
"if_10_3":<Boolean_value>,
"xva_desc_present":<Boolean_value>,
"vrid_list_ipv6_10_5":<String_value>,
"receiveuntagged_10_4":<Boolean_value>,
"advertise_vm_uuid":<String_value>,
"vrid_list_ipv6_1_8":<String_value>,
"vlan_10_6":<Integer_value>,
"if_10_5":<Boolean_value>,
"is_new_crypto":<Boolean_value>,
"delete_template_name":<String_value>,
"vrid_list_ipv6_1_6":<String_value>,
"profile_username":<String_value>,
"if_10_7":<Boolean_value>,
"default_password":<String_value>,
"receiveuntagged_10_8":<Boolean_value>,
"vrid_list_ipv6_1_4":<String_value>,
"receiveuntagged_1_6":<Boolean_value>,
"vlan_1_4":<Integer_value>,
"if_1_2":<Boolean_value>,
"receiveuntagged_1_5":<Boolean_value>,
"receiveuntagged_10_6":<Boolean_value>,
"receiveuntagged_10_1":<Boolean_value>,
"vrid_list_ipv4_1_6":<String_value>,
"vrid_list_ipv6_1_5":<String_value>,
"vrid_list_ipv6_10_8":<String_value>,
"vrid_list_ipv4_1_7":<String_value>,
"make_vm_ready":<Boolean_value>,
"receiveuntagged_10_2":<Boolean_value>,
"profile_password":<String_value>,
"vrid_list_ipv4_1_5":<String_value>,
"receiveuntagged_1_7":<Boolean_value>,
"vlan_10_4":<Integer_value>,
"if_1_7":<Boolean_value>,
"receiveuntagged_1_1":<Boolean_value>,
"vrid_list_ipv6_1_7":<String_value>,
"if_10_1":<Boolean_value>,
"if_10_8":<Boolean_value>,
"l2_enabled":<Boolean_value>,
"vlan_10_7":<Integer_value>,
"vlan_10_1":<Integer_value>,
"receiveuntagged_1_2":<Boolean_value>,
"reboot_vm_on_cpu_change":<Boolean_value>,
"vlan_1_6":<Integer_value>,
"vrid_list_ipv4_1_3":<String_value>,
"receiveuntagged_10_7":<Boolean_value>,
"vrid_list_ipv4_1_1":<String_value>,
"vlan_1_1":<Integer_value>,
"vrid_list_ipv6_10_7":<String_value>,
"vlan_1_8":<Integer_value>,
"vlan_10_2":<Integer_value>,
"receiveuntagged_10_5":<Boolean_value>,
"vrid_list_ipv4_10_3":<String_value>,
"vrid_list_ipv4_10_6":<String_value>,
"vrid_list_ipv4_1_8":<String_value>,
"receiveuntagged_1_8":<Boolean_value>,
"sync_operation":<Boolean_value>,
"additional_info":<String_value>,
"vrid_list_ipv4_10_4":<String_value>,
"vlan_1_3":<Integer_value>,
"receiveuntagged_10_3":<Boolean_value>,
"if_10_6":<Boolean_value>,
"if_1_6":<Boolean_value>,
"vlan_10_3":<Integer_value>,
"vlan_1_5":<Integer_value>,
"if_1_3":<Boolean_value>,
"vpx_image_dir":<String_value>,
"vrid_list_ipv4_10_5":<String_value>,
"if_1_4":<Boolean_value>,
"vrid_list_ipv4_10_8":<String_value>,
"if_1_1":<Boolean_value>,
"vrid_list_ipv4_10_7":<String_value>,
"vlan_10_8":<Integer_value>,
"convert_template_name":<String_value>,
"receiveuntagged_1_3":<Boolean_value>,
"crypto_change_requires_reboot":<Boolean_value>,
"vrid_list_ipv4_10_2":<String_value>,
"if_1_8":<Boolean_value>,
"vrid_list_ipv4_10_1":<String_value>,
"vrid_list_ipv6_10_2":<String_value>,
"if_10_2":<Boolean_value>,
"vrid_list_ipv6_10_1":<String_value>}]}
get
URL: https://<MGMT-IP>/nitro/v2/config/vm_device/id_value<String> 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, "vm_device":[{
"image_name":<String_value>,
"is_grace":<Boolean_value>,
"hostname":<String_value>,
"std_bw_config":<Integer_value>,
"vm_memory_total":<Double_value>,
"is_internal_intf_added":<Boolean_value>,
"gateway_ipv6":<String_value>,
"throughput_limit":<Double_value>,
"sdxtools_http_port":<Integer_value>,
"instance_state":<String_value>,
"vlan_id_0_1":<Integer_value>,
"vnc_console_url":<String_value>,
"provision_with_xva":<Boolean_value>,
"name":<String_value>,
"reason":<String_value>,
"virtual_functions":<String_value>,
"disk_space":<Double_value>,
"description":<String_value>,
"ent_bw_available":<Integer_value>,
"is_pooled_license":<Boolean_value>,
"upsince":<String_value>,
"fips_partition_name":<String_value>,
"domid":<Double_value>,
"cpu_core_pe":<String_value>,
"user_driven":<Boolean_value>,
"mastools_version":<String_value>,
"ent_bw_total":<Integer_value>,
"host_type":<String_value>,
"tenant_id":<String_value>,
"vcpu_config":<Integer_value>,
"preferred_cpu_socket":<String_value>,
"burst_priority":<Integer_value>,
"netmask":<String_value>,
"device_uuid":<String_value>,
"ent_bw_config":<Integer_value>,
"do_config":<Boolean_value>,
"version":<String_value>,
"host_id":<String_value>,
"datacenter_id":<String_value>,
"has_sdxtools":<Boolean_value>,
"is_managed":<Boolean_value>,
"old_max_burst_throughput":<Double_value>,
"instance_mode":<String_value>,
"vm_memory_used":<Double_value>,
"number_of_cpu":<Integer_value>,
"nexthop_v6":<String_value>,
"ipv4_address":<String_value>,
"profile_name":<String_value>,
"std_bw_available":<Integer_value>,
"seq_no":<Double_value>,
"is_swg":<Boolean_value>,
"internal_ip_address":<String_value>,
"dns":<String_value>,
"sysid":<String_value>,
"network_interfaces":[{
"device_channel_name":<String_value>,
"is_mgmt_ifc":<Boolean_value>,
"name_server":<String_value>,
"vrid_list_ipv6":<String_value>,
"gateway":<String_value>,
"channel_tag_all_vlans":<Boolean_value>,
"xen_vf_index":<Integer_value>,
"parent_id":<String_value>,
"vrid_list_ipv4":<String_value>,
"is_member_ifc":<Boolean_value>,
"mac_address":<String_value>,
"parent_channel_id":<String_value>,
"channel_type":<String_value>,
"l2_enabled":<Boolean_value>,
"id":<String_value>,
"ip_address":<String_value>,
"netmask":<String_value>,
"port_name":<String_value>,
"parent_name":<String_value>,
"channel_timeout":<String_value>,
"mac_mode":<String_value>,
"channel_ha_monitoring":<Boolean_value>,
"managed_device_id":<String_value>,
"vlan":<Integer_value>,
"receiveuntagged":<Boolean_value>,
"sdx_formation_network_id":<String_value>,
"vlan_whitelist":<String_value>
"interface_name":<String_value>
"vrid_list_ipv4_array":<String_value>
"vrid_list_ipv6_array":<String_value>
"vlan_whitelist_array":<String_value>
"is_vlan_applied":<Boolean_value>}],
"vm_state":<String_value>,
"uuid":<String_value>,
"last_updated_time":<Double_value>,
"cpu_core_mgmt":<String_value>,
"ssl_virtual_functions":<String_value>,
"old_throughput":<Double_value>,
"uptime":<String_value>,
"plt_bw_total":<Integer_value>,
"host_ip_address":<String_value>,
"id":<String_value>,
"ipv6_address":<String_value>,
"mgmt_ip_address":<String_value>,
"license_edition":<String_value>,
"number_of_acu":<Integer_value>,
"plt_bw_available":<Integer_value>,
"cpu_license_type":<Integer_value>,
"device_family":<String_value>,
"license_grace_time":<Integer_value>,
"la_mgmt":<Boolean_value>,
"assigned_cpu_socket":<String_value>,
"vlan_id_0_2":<Integer_value>,
"number_of_ssl_cores":<Integer_value>,
"type":<String_value>,
"throughput":<Double_value>,
"sdxtools_public_key":<String_value>,
"template_name":<String_value>,
"status":<String_value>,
"gateway":<String_value>,
"vm_description":<String_value>,
"max_burst_throughput":<Double_value>,
"config_type":<Integer_value>,
"systemname":<String_value>,
"mac_eth0":<String_value>,
"if_internal_ip_enabled":<Boolean_value>,
"vm_rx":<Double_value>,
"node_id":<String_value>,
"privStr":<String_value>,
"disk_allocation":<String_value>,
"vm_tx":<Double_value>,
"ip_address":<String_value>,
"throughput_allocation_mode":<Integer_value>,
"number_of_scu":<Integer_value>,
"ping_state":<Integer_value>,
"number_of_cores":<Integer_value>,
"display_name":<String_value>,
"std_bw_total":<Integer_value>,
"domain_name":<String_value>,
"nexthop":<String_value>,
"vm_memory_free":<Double_value>,
"plt_bw_config":<Integer_value>,
"formation_instance_id":<String_value>,
"vm_memory_usage":<Double_value>,
"sdxtools_version":<String_value>,
"vm_cpu_usage":<Double_value>,
"parent_inventory":<Boolean_value>,
"vlan_1_2":<Integer_value>,
"vrid_list_ipv4_1_2":<String_value>,
"vlan_1_7":<Integer_value>,
"vrid_list_ipv6_1_2":<String_value>,
"vrid_list_ipv4_1_4":<String_value>,
"act_id":<String_value>,
"vrid_list_ipv6_10_6":<String_value>,
"if_10_4":<Boolean_value>,
"vlan_10_5":<Integer_value>,
"vrid_list_ipv6_10_3":<String_value>,
"vrid_list_ipv6_1_1":<String_value>,
"if_1_5":<Boolean_value>,
"receiveuntagged_1_4":<Boolean_value>,
"vrid_list_ipv6_10_4":<String_value>,
"vrid_list_ipv6_1_3":<String_value>,
"if_10_3":<Boolean_value>,
"xva_desc_present":<Boolean_value>,
"vrid_list_ipv6_10_5":<String_value>,
"receiveuntagged_10_4":<Boolean_value>,
"advertise_vm_uuid":<String_value>,
"vrid_list_ipv6_1_8":<String_value>,
"vlan_10_6":<Integer_value>,
"if_10_5":<Boolean_value>,
"is_new_crypto":<Boolean_value>,
"delete_template_name":<String_value>,
"vrid_list_ipv6_1_6":<String_value>,
"profile_username":<String_value>,
"if_10_7":<Boolean_value>,
"default_password":<String_value>,
"receiveuntagged_10_8":<Boolean_value>,
"vrid_list_ipv6_1_4":<String_value>,
"receiveuntagged_1_6":<Boolean_value>,
"vlan_1_4":<Integer_value>,
"if_1_2":<Boolean_value>,
"receiveuntagged_1_5":<Boolean_value>,
"receiveuntagged_10_6":<Boolean_value>,
"receiveuntagged_10_1":<Boolean_value>,
"vrid_list_ipv4_1_6":<String_value>,
"vrid_list_ipv6_1_5":<String_value>,
"vrid_list_ipv6_10_8":<String_value>,
"vrid_list_ipv4_1_7":<String_value>,
"make_vm_ready":<Boolean_value>,
"receiveuntagged_10_2":<Boolean_value>,
"profile_password":<String_value>,
"vrid_list_ipv4_1_5":<String_value>,
"receiveuntagged_1_7":<Boolean_value>,
"vlan_10_4":<Integer_value>,
"if_1_7":<Boolean_value>,
"receiveuntagged_1_1":<Boolean_value>,
"vrid_list_ipv6_1_7":<String_value>,
"if_10_1":<Boolean_value>,
"if_10_8":<Boolean_value>,
"l2_enabled":<Boolean_value>,
"vlan_10_7":<Integer_value>,
"vlan_10_1":<Integer_value>,
"receiveuntagged_1_2":<Boolean_value>,
"reboot_vm_on_cpu_change":<Boolean_value>,
"vlan_1_6":<Integer_value>,
"vrid_list_ipv4_1_3":<String_value>,
"receiveuntagged_10_7":<Boolean_value>,
"vrid_list_ipv4_1_1":<String_value>,
"vlan_1_1":<Integer_value>,
"vrid_list_ipv6_10_7":<String_value>,
"vlan_1_8":<Integer_value>,
"vlan_10_2":<Integer_value>,
"receiveuntagged_10_5":<Boolean_value>,
"vrid_list_ipv4_10_3":<String_value>,
"vrid_list_ipv4_10_6":<String_value>,
"vrid_list_ipv4_1_8":<String_value>,
"receiveuntagged_1_8":<Boolean_value>,
"sync_operation":<Boolean_value>,
"additional_info":<String_value>,
"vrid_list_ipv4_10_4":<String_value>,
"vlan_1_3":<Integer_value>,
"receiveuntagged_10_3":<Boolean_value>,
"if_10_6":<Boolean_value>,
"if_1_6":<Boolean_value>,
"vlan_10_3":<Integer_value>,
"vlan_1_5":<Integer_value>,
"if_1_3":<Boolean_value>,
"vpx_image_dir":<String_value>,
"vrid_list_ipv4_10_5":<String_value>,
"if_1_4":<Boolean_value>,
"vrid_list_ipv4_10_8":<String_value>,
"if_1_1":<Boolean_value>,
"vrid_list_ipv4_10_7":<String_value>,
"vlan_10_8":<Integer_value>,
"convert_template_name":<String_value>,
"receiveuntagged_1_3":<Boolean_value>,
"crypto_change_requires_reboot":<Boolean_value>,
"vrid_list_ipv4_10_2":<String_value>,
"if_1_8":<Boolean_value>,
"vrid_list_ipv4_10_1":<String_value>,
"vrid_list_ipv6_10_2":<String_value>,
"if_10_2":<Boolean_value>,
"vrid_list_ipv6_10_1":<String_value>}]}