Package com.xebialabs.deployit.core.api

Interface HostService

@Path("/host") @Produces("application/json") public interface HostService
Retrieves information about Hosts: which DeployedApplications have deployeds on this host, and which environments does this host take part in? The user must have READ access to the specified host.

  • Method Summary

    Modifier and Type
    Method
    Description
    Integer
    countEnvironmentsByHost(String hostId, String environmentName)
    Count the number of environments that the user has READ access to and the specified host is part of, optionally filtered by (part of) the environment name
    List<com.xebialabs.deployit.engine.api.dto.ConfigurationItemId>
    findDeployedApplications(String hostId, String deployedAppName, com.xebialabs.deployit.engine.api.dto.Paging paging, com.xebialabs.deployit.engine.api.dto.Ordering order)
    Find deployedApplications that have deployeds on the specified host.
    List<com.xebialabs.deployit.engine.api.dto.DeploymentInfo>
    getEnvironmentsByHost(String hostId, String environmentName, com.xebialabs.deployit.engine.api.dto.Paging paging, com.xebialabs.deployit.engine.api.dto.Ordering order)
    Gets all environments that the specified host is part of, including when and by whom this environment was last deployed to.

  • Method Details

    • findDeployedApplications

      @GET @Path("deployed-applications/{ID:.+}") List<com.xebialabs.deployit.engine.api.dto.ConfigurationItemId> findDeployedApplications(@PathParam("ID") String hostId, @QueryParam("deployedAppName") String deployedAppName, @BeanParam com.xebialabs.deployit.engine.api.dto.Paging paging, @QueryParam("order") com.xebialabs.deployit.engine.api.dto.Ordering order)
      Find deployedApplications that have deployeds on the specified host.
      Parameters:
      hostId - the host ID
      deployedAppName - (Optional) (Part of) the deployedApplication's to look for
      paging - How many results to display per page, and which page to retrieve
      order - How to order the search results.
      Returns:
      A list of objects corresponding to the deployedApplications

    • getEnvironmentsByHost

      @GET @Path("{id:.+}/environments") List<com.xebialabs.deployit.engine.api.dto.DeploymentInfo> getEnvironmentsByHost(@PathParam("id") String hostId, @QueryParam("name") String environmentName, @BeanParam com.xebialabs.deployit.engine.api.dto.Paging paging, @QueryParam("order") com.xebialabs.deployit.engine.api.dto.Ordering order)
      Gets all environments that the specified host is part of, including when and by whom this environment was last deployed to. Lists only environments that the user has READ permission for.
      Parameters:
      hostId - The host ID to query for
      environmentName - (Optional) (part of) the name of the environment(s) to look for
      paging - How many results to display per page, and which page to retrieve
      order - How to order the search results.
      Returns:
      a list of objects

    • countEnvironmentsByHost

      @GET @Path("{id:.+}/environments/count") Integer countEnvironmentsByHost(@PathParam("id") String hostId, @QueryParam("name") String environmentName)
      Count the number of environments that the user has READ access to and the specified host is part of, optionally filtered by (part of) the environment name
      Parameters:
      hostId - The host ID to query
      environmentName - (Optional) (part of) the environment name(s) to look for.
      Returns:
      The number of environments that this host is part of