Interface DataCenterApi
-
@Consumes("text/xml") @Produces("text/xml") public interface DataCenterApi
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description DataCenter
clearDataCenter(String identifier)
Removes all components from an existing Virtual Data Center.DataCenter
createDataCenter(DataCenter.Request.CreatePayload createRequest)
Creates and saves a new, empty Virtual Data Center.boolean
deleteDataCenter(String identifier)
Deletes an Virtual Data Center.List<DataCenter>
getAllDataCenters()
DataCenter
getDataCenter(String identifier)
ProvisioningState
getDataCenterState(String identifier)
This is a lightweight function for polling the current provisioning state of the Virtual Data Center.DataCenter
updateDataCenter(DataCenter.Request.UpdatePayload updateRequest)
Updates the information associated to an existing Virtual Data Center.
-
-
-
Method Detail
-
getAllDataCenters
@POST @Named("datacenter:getall") List<DataCenter> getAllDataCenters()
- Returns:
- Returns a list of all Virtual Data Centers created by the user, including ID, name and version number.
-
getDataCenter
@POST @Named("datacenter:get") DataCenter getDataCenter(String identifier)
- Parameters:
identifier
- Data Center identifier- Returns:
- Returns information about an existing virtual data center's state and configuration or
null
if it doesn't exist.
-
getDataCenterState
@POST @Named("datacenter:getstate") ProvisioningState getDataCenterState(String identifier)
This is a lightweight function for polling the current provisioning state of the Virtual Data Center. It is recommended to use this function for large Virtual Data Centers to query request results.- Parameters:
identifier
- Data Center identifier
-
createDataCenter
@POST @Named("datacenter:create") DataCenter createDataCenter(DataCenter.Request.CreatePayload createRequest)
Creates and saves a new, empty Virtual Data Center. Returns its identifier for further reference.Note: Data center names cannot start with or contain (@, /, \, |, ‘’, ‘)
- Parameters:
createRequest
- VDC payload containing dataCenterName, region- Returns:
- Response containing requestId, dataCenterId, version, and location
-
updateDataCenter
@POST @Named("datacenter:update") DataCenter updateDataCenter(DataCenter.Request.UpdatePayload updateRequest)
Updates the information associated to an existing Virtual Data Center.- Parameters:
updateRequest
- VDC payload containing dataCenterId, and name- Returns:
- Response containing requestId, dataCenterId, version
-
clearDataCenter
@POST @Named("datacenter:clear") DataCenter clearDataCenter(String identifier)
Removes all components from an existing Virtual Data Center.- Parameters:
identifier
- Identifier of the virtual data center- Returns:
- Response containing requestId, dataCenterId, version
-
deleteDataCenter
@POST @Named("datacenter:delete") boolean deleteDataCenter(String identifier)
Deletes an Virtual Data Center. If a previous request on the target data center is still in progress, the data center is going to be deleted after this request has been completed. Once a Data Center has been deleted, no further request can be performed on it.- Parameters:
identifier
- Identifier of the virtual data center- Returns:
- Returns a boolean indicating whether delete operation was made
-
-