Interface DataCenterApi


  • @Consumes("text/xml")
    @Produces("text/xml")
    public interface DataCenterApi
    • 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