VMware Cloud Director API - PUT-VirtualCenter

PUT /admin/extension/vimServer/{id}

Operation:

PUT /admin/extension/vimServer/{id}

Description:

Update the representation of a registered vCenter server. This will not make any edits to, add, or remove the vCenter's Shield Manager. If you would like to do this, use cloud API's PUT /1.0.0/virtualCenters/{vcUrn}

Since:

0.9

Deprecated:

36.0

Input parameters

Consume media type(s):: application/vnd.vmware.admin.vmwvirtualcenter+xml
application/vnd.vmware.admin.vmwvirtualcenter+json
Input type:: VimServerType

Output parameters

TaskType This operation is asynchronous and the user should monitor the returned task status in order to check when it is completed.

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/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3

Headers:
Content-Length: 4006
Content-Type: application/vnd.vmware.admin.vmwvirtualcenter+xml; charset=ISO-8859-1
x-vcloud-authorization: X600Twh81GezzqBm3B3GXTe8r9U8+U5kIrA3X4H2ctE=

Body:

<?xml version="1.0" encoding="UTF-8"?><vmext:VimServer
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
    href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
    id="urn:vcloud:vimserver:3691f5d6-32eb-44f6-804a-1d30d17068c3"
    name="VC-2"
    type="application/vnd.vmware.admin.vmwvirtualcenter+xml">
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServerReferences"
        rel="up"
        type="application/vnd.vmware.admin.vmwVimServerReferences+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/vmsList"
        rel="down"
        type="application/vnd.vmware.admin.vmsObjectRefsList+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/hostReferences"
        rel="down"
        type="application/vnd.vmware.admin.vmwHostReferences+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/resourcePoolList"
        rel="down"
        type="application/vnd.vmware.admin.resourcePoolList+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/networks"
        rel="down"
        type="application/vnd.vmware.admin.vimServerNetworks+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/storageProfiles"
        rel="down"
        type="application/vnd.vmware.admin.vmwStorageProfiles+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/importVmAsVApp"
        rel="add"
        type="application/vnd.vmware.admin.importVmAsVAppParams+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/importVmAsVAppTemplate"
        rel="add"
        type="application/vnd.vmware.admin.importVmAsVAppTemplateParams+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/importVmIntoExistingVApp"
        rel="add"
        type="application/vnd.vmware.admin.importVmIntoExistingVAppParams+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/importMedia"
        rel="add"
        type="application/vnd.vmware.admin.importMediaParams+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
        rel="edit"
        type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/action/unregister"
        rel="unregister"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/action/forcevimserverreconnect"
        rel="reconnect"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/action/refreshStorageProfiles"
        rel="refreshStorageProfiles"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3/action/refresh"
        rel="refreshVirtualCenter"/>
    <vcloud:Link
        href="https://vcloud.example.com/api/admin/extension/vsm/e4db19ad-8e30-40bc-bd08-d0d259d40a30"
        rel="down"
        type="application/vnd.vmware.admin.vshieldmanager+xml"/>
    <vmext:Username>administrator</vmext:Username>
    <vmext:Url>https://10.26.61.46:443</vmext:Url>
    <vmext:IsEnabled>false</vmext:IsEnabled>
    <vmext:IsConnected>true</vmext:IsConnected>
    <vmext:ShieldManagerHost>10.26.61.51</vmext:ShieldManagerHost>
    <vmext:ShieldManagerUserName>admin</vmext:ShieldManagerUserName>
    <vmext:Uuid>77D76EBF-6A56-4D4A-A48C-EF3FFCA4590E</vmext:Uuid>
    <vmext:VcProxy>stpetkov</vmext:VcProxy>
    <vmext:VcVersion>5.0.0</vmext:VcVersion>
    <vmext:UseVsphereService>false</vmext:UseVsphereService>
</vmext:VimServer>
Response: HTTP/1.1 202 Accepted

Headers:
Content-Length: 1351
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.1
Location: https://vcloud.example.com/api/task/480ad63f-9878-4aa8-8ef9-ee170ecfddd8
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-13T16:58:34.657+03:00"
    href="https://vcloud.example.com/api/task/480ad63f-9878-4aa8-8ef9-ee170ecfddd8"
    id="urn:vcloud:task:480ad63f-9878-4aa8-8ef9-ee170ecfddd8"
    name="task"
    operation="Updating VirtualCenter (3691f5d6-32eb-44f6-804a-1d30d17068c3)"
    operationName="systemUpdateVimserver"
    serviceNamespace="com.vmware.vcloud"
    startTime="2013-02-12T16:58:34.657+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/480ad63f-9878-4aa8-8ef9-ee170ecfddd8/action/cancel"
        rel="task:cancel"/>
    <Owner
        href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
        name=""
        type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
    <User
        href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
        name="vcloud"
        type="application/vnd.vmware.admin.user+xml"/>
    <Organization
        href="https://vcloud.example.com/api/org/a93c9db9-7471-3192-8d09-a8f7eeda85f9"
        name="System"
        type="application/vnd.vmware.vcloud.org+xml"/>
    <Details/>
</Task>