Modify Vcenter Server Settings; Register A Vcenter Server And Vshield Manager - VMware VCLOUD API 1.0 - API Programming Manual

Table of Contents

Advertisement

vCloud API Programming Guide
<vmext:VimObjectType>RESOURCE_POOL</vmext:VimObjectType>
<vmext:DataStoreRefs>
<vmext:VimObjectRef>
</vmext:VimObjectRef>
<vmext:VimObjectRef>
</vmext:VimObjectRef>
<vmext:VimObjectRef>
</vmext:VimObjectRef>
</vmext:DataStoreRefs>
</vmext:ResourcePool>
</vmext:ResourcePoolList>

Modify vCenter Server Settings

A system administrator can change the values of name, Description, and IsEnabled for a vCenter server by 
making a PUT request to the server's edit URL. A system administrator must also modify the values of 
Username, Password, and URL when any of those are changed on the server host. You cannot change those 
values for the vCenter server by modifying its VimServer element, but you must update the element if you 
make these changes to the server.
Example 7‐5 disables the vCenter server shown in Example
Example 7-5. Modify vCenter Server Settings
Request:
PUT http://vcloud.example.com/api/v1.0/admin/extension/vimServer/100
Content-Type: application/vnd.vmware.admin.vmwvirtualcenter+xml
...
<vmext:VimServer xmlns:vmext="http://www.vmware.com/vcloud/extension/v1"
<vcloud:Description>Temporarily disabled for maintenance</vcloud:Description>
<vmext:Username>administrator</vmext:Username>
<vmext:Url>http://10.147.40.234:443</vmext:Url>
<vmext:IsEnabled>false</vmext:IsEnabled>
</vmext:VimServer>
Response:
202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task ... operation="Updating VirtualCenter (100)" ...>
...
</Task>

Register a vCenter Server and vShield Manager

A system administrator can register a vCenter server and a companion vShield manager server for use with a 
vCloud by making a POST request to the vCloud's action/registervimserver URL and supplying a 
RegisterVimServerParams request body, as shown in Example
122
<vmext:MoRef>datastore-10</vmext:MoRef>
<vmext:VimObjectType>DATASTORE</vmext:VimObjectType>
<vmext:MoRef>datastore-11</vmext:MoRef>
<vmext:VimObjectType>DATASTORE</vmext:VimObjectType>
<vmext:MoRef>datastore-12</vmext:MoRef>
<vmext:VimObjectType>DATASTORE</vmext:VimObjectType>
xmlns:vcloud="http://www.vmware.com/vcloud/v1" name="VC-02"
type="application/vnd.vmware.admin.vmwvirtualcenter+xml">
7‐3 and also changes its Description.
7‐6.
VMware, Inc.

Advertisement

Table of Contents
loading

Table of Contents