1. Operations
2. vcenter
3. vm
4. hardware
5. parallel

## vcenter vm hardware parallel: get

Returns information about a virtual parallel port.

### Request:

#### HTTP request

GET https://{server}/rest/vcenter/vm/{vm}/hardware/parallel/{port}

#### Path Parameters

Name | Type | Description
--- | --- | ---
Required
vm | string | Virtual machine identifier.
port | string | Virtual parallel port identifier.

### Response:

#### HTTP Status Code: 200

#### Representations:

- JSON
- XML

{
"value": {
"allow_guest_control": true,
"backing": {
"auto_detect": true,
"file": "string",
"host_device": "string",
"type": "FILE"
},
"label": "string",
"start_connected": true,
"state": "CONNECTED"
}
}
<?xml version="1.0" ?>
<ns0:Get-Result xmlns:ns0="http://vmware.com/vcenter/vm/hardware/parallel" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value>
<state>CONNECTED</state>
<label>string</label>
<allow_guest_control>true</allow_guest_control>
<backing>
<auto_detect>true</auto_detect>
<file>string</file>
<type>FILE</type>
<host_device>string</host_device>
</backing>
<start_connected>true</start_connected>
</value>
</ns0:Get-Result>

#### Response Type:

Name | Type | Description
--- | --- | ---
bold = required
value | info | Information about the specified virtual parallel port.
value.label | string | Device label.
value.backing | backing_info | Physical resource backing for the virtual parallel port.
value.backing.type | string | Backing type for the virtual parallel port. Defines the valid backing types for a virtual parallel port. Value is one of: FILE: Virtual parallel port is backed by a file. HOST_DEVICE: Virtual parallel port is backed by a device on the host where the virtual machine is running.
value.backing.file | string | Path of the file backing the virtual parallel port. Optional. It is only relevant when type has value FILE. This field is optional and it is only relevant when the value of `type` is FILE.
value.backing.host_device | string | Name of the device backing the virtual parallel port. Optional. It is only relevant when type has value HOST_DEVICE. This field will be unset if `auto_detect` is true and the virtual parallel port is not connected or no suitable device is available on the host.
value.backing.auto_detect | boolean | Flag indicating whether the virtual parallel port is configured to automatically detect a suitable host device. Optional. It is only relevant when type has value HOST_DEVICE. This field is optional and it is only relevant when the value of `type` is HOST_DEVICE.
value.state | string | Connection status of the virtual device. Defines the valid states for a removable device that is configured to be connected. Value is one of: CONNECTED: The device is connected and working correctly. RECOVERABLE_ERROR: Device connection failed due to a recoverable error; for example, the virtual device backing is currently in use by another virtual machine. UNRECOVERABLE_ERROR: Device connection failed due to an unrecoverable error; for example, the virtual device backing does not exist. NOT_CONNECTED: The device is not connected. UNKNOWN: The device status is unknown.
value.start_connected | boolean | Flag indicating whether the virtual device should be connected whenever the virtual machine is powered on.
value.allow_guest_control | boolean | Flag indicating whether the guest can connect and disconnect the device.

#### Errors:

HTTP Status Code | Type | Description
--- | --- | ---
500 | error | if the system reports an error while responding to the request.
404 | not_found | if the virtual machine or virtual parallel port is not found.
400 | resource_inaccessible | if the virtual machine's configuration state cannot be accessed.
503 | service_unavailable | if the system is unable to communicate with a service to complete the request.
401 | unauthenticated | if the user can not be authenticated.
403 | unauthorized | if the user doesn't have the required privileges.