1. Types
2. vcenter
3. vm
4. hardware
5. serial

## vcenter vm hardware serial: create spec

The `create_spec` structure provides a specification for the configuration of a newly-created virtual serial port.

### Representations:

- JSON
- XML

{
"allow_guest_control": true,
"backing": {
"file": "string",
"host_device": "string",
"network_location": "http://myurl.com",
"no_rx_loss": true,
"pipe": "string",
"proxy": "http://myurl.com",
"type": "FILE"
},
"start_connected": true,
"yield_on_poll": true
}
<?xml version="1.0" ?>
<ns0:CreateSpec xmlns:ns0="http://vmware.com/vcenter/vm/hardware/serial" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<allow_guest_control>true</allow_guest_control>
<yield_on_poll>true</yield_on_poll>
<backing>
<network_location>http://myurl.com</network_location>
<file>string</file>
<proxy>http://myurl.com</proxy>
<type>FILE</type>
<no_rx_loss>true</no_rx_loss>
<pipe>string</pipe>
<host_device>string</host_device>
</backing>
<start_connected>true</start_connected>
</ns0:CreateSpec>

#### Attributes:

Name | Type | Description
--- | --- | ---
Optional
yield_on_poll | boolean | CPU yield behavior. If set to true, the virtual machine will periodically relinquish the processor if its sole task is polling the virtual serial port. The amount of time it takes to regain the processor will depend on the degree of other virtual machine activity on the host. Optional. If unset, defaults to false.
backing | backing_spec | Physical resource backing for the virtual serial port. Optional. If unset, defaults to automatic detection of a suitable host device.
start_connected | boolean | Flag indicating whether the virtual device should be connected whenever the virtual machine is powered on. Optional. Defaults to false if unset.
allow_guest_control | boolean | Flag indicating whether the guest can connect and disconnect the device. Optional. Defaults to false if unset.