VMware Cloud Director API - GET-ProviderVdc-ExtensionView
GET /admin/extension/providervdc/{id}
- Operation:
- GET /admin/extension/providervdc/{id}
- Description:
- Retrieve a system administrator view of a provider vDC.
- Since:
- 0.9
- Input parameters
-
- Consume media type(s):
- None
- Input type:
- None
- Output parameters
-
VMWProviderVdc
- Produce media type(s):
-
application/vnd.vmware.admin.vmwprovidervdc+xml
application/vnd.vmware.admin.vmwprovidervdc+json
- Output type:
- VMWProviderVdcType
- Examples
-
- Request
-
HTTP 1.1
GET /api/admin/extension/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7
Headers:
x-vcloud-authorization: jlfBniGOkcjcw1qWDpCYp6dhBJZ4LQW0m5Sp7UjZ/Vg=
Body:
- Response
-
HTTP/1.1 200 OK
Headers:
Content-Length: 8703
Content-Type: application/vnd.vmware.admin.vmwprovidervdc+xml;version=5.5
Vary: Accept-Encoding
Body:
<?xml version="1.0" encoding="UTF-8"?><vmext:VMWProviderVdc
xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
href="https://vcloud.example.com/api/admin/extension/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7"
id="urn:vcloud:providervdc:c54da61a-258f-457a-9fe4-45fa437901f7"
name="Provider vDC Name"
status="1"
type="application/vnd.vmware.admin.vmwprovidervdc+xml"
xsi:schemaLocation="http://www.vmware.com/vcloud/extension/v1.5 http://https://vcloud.example.com/api/v1.5/schema/vmwextensions.xsd http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providerVdcReferences"
rel="up"
type="application/vnd.vmware.admin.vmwProviderVdcReferences+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7/action/disable"
rel="disable"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7"
rel="edit"
type="application/vnd.vmware.admin.vmwprovidervdc+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7/storageProfiles"
rel="edit"
type="application/vnd.vmware.admin.updateProviderVdcStorageProfiles+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7"
rel="alternate"
type="application/vnd.vmware.admin.providervdc+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7/action/updateResourcePools"
rel="update:resourcePools"
type="application/vnd.vmware.admin.resourcePoolSetUpdateParams+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7/resourcePools"
rel="down"
type="application/vnd.vmware.admin.vmwProviderVdcResourcePoolSet+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7/availableStorageProfiles"
rel="down"
type="application/vnd.vmware.admin.vmwStorageProfiles+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7/vdcReferences"
rel="down"
type="application/vnd.vmware.admin.vdcReferences+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7/metadata"
rel="down"
type="application/vnd.vmware.vcloud.metadata+xml"/>
<vcloud:Description>Provider vDC Description</vcloud:Description>
<vcloud:Tasks>
<vcloud:Task
cancelRequested="false"
endTime="2013-02-14T13:12:38.137+02:00"
expiryTime="2013-05-15T13:12:37.600+03:00"
href="https://vcloud.example.com/api/task/58cb5425-7ca7-45ed-ab2c-3136490dbd11"
id="urn:vcloud:task:58cb5425-7ca7-45ed-ab2c-3136490dbd11"
name="task"
operation="Updated Storage Profiles for Provider Virtual Datacenter (c54da61a-258f-457a-9fe4-45fa437901f7)"
operationName="rclUpdateProviderVdcStorageProfiles"
serviceNamespace="com.vmware.vcloud"
startTime="2013-02-14T13:12:37.600+02:00"
status="error"
type="application/vnd.vmware.vcloud.task+xml">
<vcloud:Owner
href="https://vcloud.example.com/api/admin/extension/providervdc/c54da61a-258f-457a-9fe4-45fa437901f7"
name=""
type="application/vnd.vmware.admin.vmwprovidervdc+xml"/>
<vcloud:Error
majorErrorCode="400"
message="A storage profile with the name "profile" already exists in the provider VDC."
minorErrorCode="BAD_REQUEST"
stackTrace="com.vmware.vcloud.api.presentation.service.BadRequestException: A storage profile with the name "profile" already exists in the provider VDC. at com.vmware.vcloud.rcl.impl.RclServiceImpl.addStorageClasses(RclServiceImpl.java:1034) at com.vmware.vcloud.rcl.impl.RclServiceImpl.updateProviderVdcStorageClassesTask(RclServiceImpl.java:2676) at com.vmware.vcloud.rcl.impl.RclServiceImpl.executeTask(RclServiceImpl.java:1988) at com.vmware.vcloud.backendbase.management.system.TaskServiceImpl$4.doInSecurityContext(TaskServiceImpl.java:1341) at com.vmware.vcloud.backendbase.management.system.TaskServiceImpl$4.doInSecurityContext(TaskServiceImpl.java:1336) at com.vmware.vcloud.backendbase.management.system.TaskServiceImpl$SecurityContextTemplate.executeForOrgAndUser(TaskServiceImpl.java:1702) at com.vmware.vcloud.backendbase.management.system.TaskServiceImpl.execute(TaskServiceImpl.java:1336) at com.vmware.vcloud.backendbase.management.system.TaskServiceImpl.dispatchByStatus(TaskServiceImpl.java:1258) at com.vmware.vcloud.backendbase.management.system.TaskServiceImpl.dispatchTask(TaskServiceImpl.java:1137) at com.vmware.vcloud.backendbase.management.system.LocalTask.run(LocalTask.java:88) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1110) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:603) at java.lang.Thread.run(Thread.java:722) "/>
<vcloud:User
href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
name="vcloud"
type="application/vnd.vmware.admin.user+xml"/>
<vcloud:Organization
href="https://vcloud.example.com/api/org/a93c9db9-7471-3192-8d09-a8f7eeda85f9"
name="System"
type="application/vnd.vmware.vcloud.org+xml"/>
<vcloud:Details> A storage profile with the name "profile" already exists in the provider VDC.</vcloud:Details>
</vcloud:Task>
</vcloud:Tasks>
<vcloud:ComputeCapacity>
<vcloud:Cpu>
<vcloud:Units>MHz</vcloud:Units>
<vcloud:Allocation>0</vcloud:Allocation>
<vcloud:Reserved>0</vcloud:Reserved>
<vcloud:Total>3322</vcloud:Total>
<vcloud:Used>0</vcloud:Used>
<vcloud:Overhead>0</vcloud:Overhead>
</vcloud:Cpu>
<vcloud:Memory>
<vcloud:Units>MB</vcloud:Units>
<vcloud:Allocation>0</vcloud:Allocation>
<vcloud:Reserved>0</vcloud:Reserved>
<vcloud:Total>5915</vcloud:Total>
<vcloud:Used>0</vcloud:Used>
<vcloud:Overhead>0</vcloud:Overhead>
</vcloud:Memory>
</vcloud:ComputeCapacity>
<vcloud:AvailableNetworks>
<vcloud:Network
href="https://vcloud.example.com/api/admin/extension/externalnet/9c873a71-3645-4821-b1dc-4101d888a1bb"
name="VM Network"
type="application/vnd.vmware.admin.extension.network+xml"/>
</vcloud:AvailableNetworks>
<vcloud:StorageProfiles>
<vcloud:ProviderVdcStorageProfile
href="https://vcloud.example.com/api/admin/extension/pvdcStorageProfile/468ed24c-fdc3-4535-83a9-3f5e198b66be"
name="profile"
type="application/vnd.vmware.admin.vmwPvdcStorageProfile+xml"/>
<vcloud:ProviderVdcStorageProfile
href="https://vcloud.example.com/api/admin/extension/pvdcStorageProfile/b4e47f33-faa3-4718-9c31-8820da4b970d"
name="*"
type="application/vnd.vmware.admin.vmwPvdcStorageProfile+xml"/>
</vcloud:StorageProfiles>
<vcloud:IsEnabled>true</vcloud:IsEnabled>
<vcloud:NetworkPoolReferences/>
<vmext:DataStoreRefs>
<vmext:VimObjectRef>
<vmext:VimServerRef
href="https://vcloud.example.com/api/admin/extension/vimServer/5b2f648b-9da7-4d7b-8212-6ed8a83f2102"
name="ConfigWizard Configured vCenter"
type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
<vmext:MoRef>datastore-42</vmext:MoRef>
<vmext:VimObjectType>DATASTORE</vmext:VimObjectType>
</vmext:VimObjectRef>
</vmext:DataStoreRefs>
<vmext:ResourcePoolRefs>
<vmext:VimObjectRef>
<vmext:VimServerRef
href="https://vcloud.example.com/api/admin/extension/vimServer/5b2f648b-9da7-4d7b-8212-6ed8a83f2102"
name="ConfigWizard Configured vCenter"
type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
<vmext:MoRef>resgroup-27</vmext:MoRef>
<vmext:VimObjectType>RESOURCE_POOL</vmext:VimObjectType>
</vmext:VimObjectRef>
</vmext:ResourcePoolRefs>
<vmext:VimServer
href="https://vcloud.example.com/api/admin/extension/vimServer/5b2f648b-9da7-4d7b-8212-6ed8a83f2102"
name="ConfigWizard Configured vCenter"
type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
<vmext:HostReferences>
<vmext:HostReference
href="https://vcloud.example.com/api/admin/extension/host/9f5e4893-97f3-4958-a56c-a8acae8eca13"
name="10.26.51.104"
type="application/vnd.vmware.admin.host+xml"/>
</vmext:HostReferences>
<vmext:HighestSupportedHardwareVersion>vmx-08</vmext:HighestSupportedHardwareVersion>
</vmext:VMWProviderVdc>
Disabled provider vdc - Request
-
HTTP 1.1
GET /api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887
Headers:
x-vcloud-authorization: X600Twh81GezzqBm3B3GXTe8r9U8+U5kIrA3X4H2ctE=
Body:
- Response
-
HTTP/1.1 200 OK
Headers:
Content-Length: 5741
Content-Type: application/vnd.vmware.admin.vmwprovidervdc+xml;version=5.1
Vary: Accept-Encoding
Body:
<?xml version="1.0" encoding="UTF-8"?><vmext:VMWProviderVdc
xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
id="urn:vcloud:providervdc:bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
name="pvdc-example"
status="1"
type="application/vnd.vmware.admin.vmwprovidervdc+xml"
xsi:schemaLocation="http://www.vmware.com/vcloud/extension/v1.5 http://https://vcloud.example.com/api/v1.5/schema/vmwextensions.xsd http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providerVdcReferences"
rel="up"
type="application/vnd.vmware.admin.vmwProviderVdcReferences+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/action/enable"
rel="enable"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
rel="edit"
type="application/vnd.vmware.admin.vmwprovidervdc+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/storageProfiles"
rel="edit"
type="application/vnd.vmware.admin.updateProviderVdcStorageProfiles+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
rel="remove"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887"
rel="alternate"
type="application/vnd.vmware.admin.providervdc+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/action/updateResourcePools"
rel="update:resourcePools"
type="application/vnd.vmware.admin.resourcePoolSetUpdateParams+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/resourcePools"
rel="down"
type="application/vnd.vmware.admin.vmwProviderVdcResourcePoolSet+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/extension/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/availableStorageProfiles"
rel="down"
type="application/vnd.vmware.admin.vmwStorageProfiles+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/vdcReferences"
rel="down"
type="application/vnd.vmware.admin.vdcReferences+xml"/>
<vcloud:Link
href="https://vcloud.example.com/api/admin/providervdc/bde68d2b-d0c3-4dff-999d-1a3bfa6ba887/metadata"
rel="down"
type="application/vnd.vmware.vcloud.metadata+xml"/>
<vcloud:Description>Example pvdc description</vcloud:Description>
<vcloud:ComputeCapacity>
<vcloud:Cpu>
<vcloud:Units>MHz</vcloud:Units>
<vcloud:Allocation>0</vcloud:Allocation>
<vcloud:Reserved>0</vcloud:Reserved>
<vcloud:Total>0</vcloud:Total>
<vcloud:Used>0</vcloud:Used>
<vcloud:Overhead>0</vcloud:Overhead>
</vcloud:Cpu>
<vcloud:Memory>
<vcloud:Units>MB</vcloud:Units>
<vcloud:Allocation>0</vcloud:Allocation>
<vcloud:Reserved>0</vcloud:Reserved>
<vcloud:Total>0</vcloud:Total>
<vcloud:Used>0</vcloud:Used>
<vcloud:Overhead>0</vcloud:Overhead>
</vcloud:Memory>
</vcloud:ComputeCapacity>
<vcloud:AvailableNetworks/>
<vcloud:StorageProfiles>
<vcloud:ProviderVdcStorageProfile
href="https://vcloud.example.com/api/admin/extension/pvdcStorageProfile/2b721630-156a-4701-a149-374e0ada6c92"
name="*"
type="application/vnd.vmware.admin.vmwPvdcStorageProfile+xml"/>
</vcloud:StorageProfiles>
<vcloud:IsEnabled>false</vcloud:IsEnabled>
<vcloud:NetworkPoolReferences/>
<vmext:DataStoreRefs>
<vmext:VimObjectRef>
<vmext:VimServerRef
href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
name="VC-2"
type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
<vmext:MoRef>datastore-42</vmext:MoRef>
<vmext:VimObjectType>DATASTORE</vmext:VimObjectType>
</vmext:VimObjectRef>
<vmext:VimObjectRef>
<vmext:VimServerRef
href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
name="VC-2"
type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
<vmext:MoRef>datastore-69</vmext:MoRef>
<vmext:VimObjectType>DATASTORE</vmext:VimObjectType>
</vmext:VimObjectRef>
</vmext:DataStoreRefs>
<vmext:ResourcePoolRefs>
<vmext:VimObjectRef>
<vmext:VimServerRef
href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
name="VC-2"
type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
<vmext:MoRef>resgroup-49</vmext:MoRef>
<vmext:VimObjectType>RESOURCE_POOL</vmext:VimObjectType>
</vmext:VimObjectRef>
</vmext:ResourcePoolRefs>
<vmext:VimServer
href="https://vcloud.example.com/api/admin/extension/vimServer/3691f5d6-32eb-44f6-804a-1d30d17068c3"
name="VC-2"
type="application/vnd.vmware.admin.vmwvirtualcenter+xml"/>
<vmext:HostReferences>
<vmext:HostReference
href="https://vcloud.example.com/api/admin/extension/host/f588f9b0-6f6b-4d9d-bf9f-489cab5f6745"
name="10.26.51.175"
type="application/vnd.vmware.admin.host+xml"/>
</vmext:HostReferences>
<vmext:HighestSupportedHardwareVersion>vmx-07</vmext:HighestSupportedHardwareVersion>
</vmext:VMWProviderVdc>