Package com.atlassian.bamboo.plugins.rest.plan.stage.job

Interface RestJobService

All Known Implementing Classes:
RestJobServiceImpl
public interface RestJobService
Service for job related REST stuff
Since:
v5.9

  • Method Details

    • addJob

      @NotNull @NotNull RestJob addJob(@NotNull @NotNull PlanKey planKey, long stageId, @Nullable @Nullable RestJob restJob, @NotNull @NotNull Expansion expansion, @NotNull @NotNull javax.ws.rs.core.UriInfo uriInfo) throws WebValidationException
      Create a new job
      Parameters:
      planKey - of plan job is in
      stageId - of stage job is in
      restJob - Rest Job
      expansion - the expansion.
      uriInfo - URI info from the request
      Returns:
      Rest Job
      Throws:
      WebValidationException

    • updateJob

      @NotNull @NotNull RestJob updateJob(@NotNull @NotNull PlanKey jobKey, @Nullable @Nullable RestJob restJob, @NotNull @NotNull Optional<ConfirmationToken> confirmationToken, @NotNull @NotNull Expansion expansion, @NotNull @NotNull javax.ws.rs.core.UriInfo uriInfo) throws WebValidationException
      Updates the details of a specific job. Will ignore missing properties.
      Parameters:
      jobKey - of job.
      restJob - job details.
      confirmationToken - The token to match before performing the update
      expansion - the expansion.
      uriInfo - URI info from the request
      Returns:
      updated job object
      Throws:
      WebValidationException

    • deleteJob

      void deleteJob(@NotNull @NotNull PlanKey jobKey, @NotNull @NotNull Optional<ConfirmationToken> confirmationToken, @NotNull @NotNull javax.ws.rs.core.UriInfo uriInfo) throws WebValidationException
      Remove a job.
      Parameters:
      jobKey - of job
      confirmationToken - The token to match before performing the delete
      uriInfo - URI info from the request
      Throws:
      ConflictException - if there is a token validation error
      WebValidationException

    • getJobDeletionWarnings

      @NotNull @NotNull RestWarnings getJobDeletionWarnings(@NotNull @NotNull PlanKey jobKey, @NotNull @NotNull Expansion expansion, @NotNull @NotNull javax.ws.rs.core.UriInfo uriInfo) throws WebValidationException
      Get warnings related to job deletion. This will return a structure with one entry for each artifact subscription. The entry for the artifact subscription will contain a list of all consuming jobs.
      Parameters:
      jobKey - of job
      expansion - the expansion.
      uriInfo - URI info from the request
      Returns:
      an object with information needed to display warnings to the user
      Throws:
      WebValidationException

    • getDeleteConfirmationToken

      @NotNull @NotNull Token getDeleteConfirmationToken(@NotNull @NotNull PlanKey jobKey, @NotNull @NotNull javax.ws.rs.core.UriInfo uriInfo) throws WebValidationException
      Generate the delete confirmation token to be used for the given job key.
      Parameters:
      jobKey - job key to generate the token for.
      uriInfo - URI info from the request
      Returns:
      current confirmation token.
      Throws:
      WebValidationException - if the job key is invalid.

    • getJobMoveWarnings

      @NotNull @NotNull RestWarnings getJobMoveWarnings(@NotNull @NotNull PlanKey jobKey, long targetStageId, @NotNull @NotNull Expansion expansion, @NotNull @NotNull javax.ws.rs.core.UriInfo uriInfo) throws WebValidationException
      Get warnings related to job move. This will return a structure with one entry for each artifact subscription. The entry for the artifact subscription will contain a list of all consuming jobs.
      Parameters:
      jobKey - of job.
      targetStageId - id of the stage the job is moving to.
      expansion - the expansion.
      uriInfo - URI info from the request
      Returns:
      an object with information needed to display warnings to the user
      Throws:
      WebValidationException