vcenter vm hardware adapter sata: create
Adds a virtual SATA adapter to the virtual machine.
Request:
HTTP request
POST https://{server}/rest/vcenter/vm/{vm}/hardware/adapter/sata
Path Parameters
| Name | Type | Description |
|---|---|---|
| Required | ||
| vm | string | Virtual machine identifier. |
Request Body Structure:
{
"spec": {
"bus": 1,
"pci_slot_number": 1,
"type": "AHCI"
}
}
"spec": {
"bus": 1,
"pci_slot_number": 1,
"type": "AHCI"
}
}
<?xml version="1.0" ?>
<ns0:Create-Input xmlns:ns0="http://vmware.com/vcenter/vm/hardware/adapter/sata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<spec>
<pci_slot_number>1</pci_slot_number>
<bus>1</bus>
<type>AHCI</type>
</spec>
</ns0:Create-Input>
<ns0:Create-Input xmlns:ns0="http://vmware.com/vcenter/vm/hardware/adapter/sata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<spec>
<pci_slot_number>1</pci_slot_number>
<bus>1</bus>
<type>AHCI</type>
</spec>
</ns0:Create-Input>
Request Body Parameters:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| spec | create_spec | Specification for the new virtual SATA adapter. |
| spec.type | string | Adapter type. Optional. If unset, a guest-specific default value will be used. |
| spec.bus | long | SATA bus number. Optional. If unset, the server will choose an available bus number; if none is available, the request will fail. |
| spec.pci_slot_number | long | Address of the SATA adapter on the PCI bus. Optional. If unset, the server will choose an available address when the virtual machine is powered on. |
Response:
HTTP Status Code: 200
Representations:
{
"value": "obj-103"
}
"value": "obj-103"
}
<?xml version="1.0" ?>
<ns0:Create-Result xmlns:ns0="http://vmware.com/vcenter/vm/hardware/adapter/sata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value>obj-103</value>
</ns0:Create-Result>
<ns0:Create-Result xmlns:ns0="http://vmware.com/vcenter/vm/hardware/adapter/sata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value>obj-103</value>
</ns0:Create-Result>
Response Type:
| Name | Type | Description |
|---|---|---|
| bold = required | ||
| value | string | Virtual SATA adapter identifier. |
Errors:
| HTTP Status Code | Type | Description |
|---|---|---|
| 500 | error | if the system reports an error while responding to the request. |
| 400 | not_allowed_in_current_state | if the virtual machine is suspended |
| 404 | not_found | if the virtual machine is not found. |
| 400 | unable_to_allocate_resource | if there are no more available SATA buses on the virtual machine. |
| 400 | resource_in_use | if the specified SATA bus or PCI address is in use. |
| 400 | invalid_argument | if the specified SATA bus or PCI address is out of bounds. |
| 400 | resource_busy | if the virtual machine is busy performing another operation. |
| 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. |
| 400 | unsupported | if the guest operating system of the virtual machine is not supported and spec includes unset fields that default to guest-specific values. |