VMware Cloud Director API - PUT-NetworkConnectionSystemSection-vApp
PUT /vApp/{id}/networkConnectionSection
- Operation:
- PUT /vApp/{id}/networkConnectionSection
- Description:
- Update the network connection section of a VM.
- Since:
- 0.9
- Input parameters
-
- Consume media type(s):
- application/vnd.vmware.vcloud.networkConnectionSection+xml
application/vnd.vmware.vcloud.networkConnectionSection+json - Input type:
- NetworkConnectionSectionType
- Output parameters
-
TaskType
This operation is asynchronous and returns a task that you can monitor to track the progress of the request.
- Produce media type(s):
- application/vnd.vmware.vcloud.task+xml
application/vnd.vmware.vcloud.task+json - Output type:
- TaskType
- Examples
-
- Request
-
HTTP 1.1
PUT /api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/networkConnectionSection/
Headers:
Content-Length: 1143
Content-Type: application/vnd.vmware.vcloud.networkConnectionSection+xml; charset=ISO-8859-1
x-vcloud-authorization: uJ13vBx80VGzZ0KcClBqxHNDJr3QI0K5KaQ0YKn2YZ0=
Body:
<?xml version="1.0" encoding="UTF-8"?><vcloud:NetworkConnectionSection
xmlns:ovf="http://schemas.dmtf.org/ovf/envelope/1"
xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/networkConnectionSection/"
ovf:required="false"
type="application/vnd.vmware.vcloud.networkConnectionSection+xml">
<ovf:Info>Specifies the available VM network connections</ovf:Info>
<vcloud:PrimaryNetworkConnectionIndex>0</vcloud:PrimaryNetworkConnectionIndex>
<vcloud:NetworkConnection
needsCustomization="true"
network="VM Network">
<vcloud:NetworkConnectionIndex>0</vcloud:NetworkConnectionIndex>
<vcloud:IsConnected>false</vcloud:IsConnected>
<vcloud:MACAddress>00:50:56:8d:7f:21</vcloud:MACAddress>
<vcloud:IpAddressAllocationMode>DHCP</vcloud:IpAddressAllocationMode>
</vcloud:NetworkConnection>
<vcloud:Link
href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/networkConnectionSection/"
rel="edit"
type="application/vnd.vmware.vcloud.networkConnectionSection+xml"/>
</vcloud:NetworkConnectionSection>
- Response
-
HTTP/1.1 202 Accepted
Headers:
Content-Length: 1338
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.5
Location: https://vcloud.example.com/api/task/6bb73e14-8432-453c-be49-b8fca5aa063f
Vary: Accept-Encoding
Body:
<?xml version="1.0" encoding="UTF-8"?><Task
xmlns="http://www.vmware.com/vcloud/v1.5"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
cancelRequested="false"
expiryTime="2013-05-15T13:17:53.173+03:00"
href="https://vcloud.example.com/api/task/6bb73e14-8432-453c-be49-b8fca5aa063f"
id="urn:vcloud:task:6bb73e14-8432-453c-be49-b8fca5aa063f"
name="task"
operation="Updating Virtual Machine importedVapp(89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4)"
operationName="vappUpdateVm"
serviceNamespace="com.vmware.vcloud"
startTime="2013-02-14T13:17:53.173+02:00"
status="running"
type="application/vnd.vmware.vcloud.task+xml"
xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
<Link
href="https://vcloud.example.com/api/task/6bb73e14-8432-453c-be49-b8fca5aa063f/action/cancel"
rel="task:cancel"/>
<Owner
href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4"
name="importedVapp"
type="application/vnd.vmware.vcloud.vm+xml"/>
<User
href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
name="system"
type="application/vnd.vmware.admin.user+xml"/>
<Organization
href="https://vcloud.example.com/api/org/7b832bc5-3d65-45a2-8d35-da28388ab80a"
name="Default"
type="application/vnd.vmware.vcloud.org+xml"/>
<Details/>
</Task>