org.gitlab4j.api

Class PipelineApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.PipelineApi

All Implemented Interfaces:

Constants

public class PipelineApi
extends AbstractApi
implements Constants

This class provides an entry point to all the GitLab API pipeline calls.

Nested Class Summary

Nested classes/interfaces inherited from interface org.gitlab4j.api.Constants

Constants.ActionType, Constants.IssueScope, Constants.IssueState, Constants.JobScope, Constants.LineType, Constants.PipelineOrderBy, Constants.PipelineScope, Constants.ProjectOrderBy, Constants.SortOrder, Constants.StateEvent, Constants.TargetType, Constants.TokenType

Field Summary

Fields inherited from interface org.gitlab4j.api.Constants

NEXT_PAGE_HEADER, PAGE_HEADER, PAGE_PARAM, PER_PAGE, PER_PAGE_PARAM, PREV_PAGE_HEADER, TOTAL_HEADER, TOTAL_PAGES_HEADER

Constructor Summary

Constructors

Constructor and Description
PipelineApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method and Description
Pipeline	cancelPipelineJobs(int projectId, int pipelineId) Cancel jobs of specified pipelines in a project.
Pipeline	createPipeline(int projectId, String ref) Create a pipelines in a project.
Pipeline	getPipeline(int projectId, int pipelineId) Get single pipelines in a project.
List<Pipeline>	getPipelines(int projectId) Get a list of pipelines in a project.
List<Pipeline>	getPipelines(int projectId, Constants.PipelineScope scope, PipelineStatus status, String ref, boolean yamlErrors, String name, String username, Constants.PipelineOrderBy orderBy, Constants.SortOrder sort) Get a list of pipelines in a project.
Pager<Pipeline>	getPipelines(int projectId, Constants.PipelineScope scope, PipelineStatus status, String ref, boolean yamlErrors, String name, String username, Constants.PipelineOrderBy orderBy, Constants.SortOrder sort, int itemsPerPage) Get a Pager of pipelines in a project.
List<Pipeline>	getPipelines(int projectId, Constants.PipelineScope scope, PipelineStatus status, String ref, boolean yamlErrors, String name, String username, Constants.PipelineOrderBy orderBy, Constants.SortOrder sort, int page, int perPage) Get a list of pipelines in a project in the specified page range.
Pager<Pipeline>	getPipelines(int projectId, int itemsPerPage) Get a Pager of pipelines in a project.
List<Pipeline>	getPipelines(int projectId, int page, int perPage) Get a list of pipelines in a project in the specified page range.
Pipeline	retryPipelineJob(int projectId, int pipelineId) Retry a job in specified pipelines in a project.

Methods inherited from class org.gitlab4j.api.AbstractApi

addFormParam, addFormParam, delete, delete, get, get, getApiClient, getApiVersion, getDefaultPerPage, getDefaultPerPageParam, getPageQueryParams, getWithAccepts, handle, isApiVersion, post, post, post, put, put, putWithFormData, urlEncode, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PipelineApi

public PipelineApi(GitLabApi gitLabApi)

Method Detail

getPipelines

public List<Pipeline> getPipelines(int projectId)
                            throws GitLabApiException

Get a list of pipelines in a project. GET /projects/:id/pipelines

Parameters:

projectId - the project ID to get the list of pipelines for

Returns:

a list containing the pipelines for the specified project ID

Throws:

GitLabApiException - if any exception occurs during execution

getPipelines

public List<Pipeline> getPipelines(int projectId,
                                   int page,
                                   int perPage)
                            throws GitLabApiException

Get a list of pipelines in a project in the specified page range. GET /projects/:id/pipelines

Parameters:

projectId - the project ID to get the list of pipelines for

page - the page to get

perPage - the number of Pipeline instances per page

Returns:

a list containing the pipelines for the specified project ID in the specified page range

Throws:

GitLabApiException - if any exception occurs during execution

getPipelines

public Pager<Pipeline> getPipelines(int projectId,
                                    int itemsPerPage)
                             throws GitLabApiException

Get a Pager of pipelines in a project. GET /projects/:id/pipelines

Parameters:

projectId - the project ID to get the list of pipelines for

itemsPerPage - the number of Pipeline instances that will be fetched per page

Returns:

a Pager containing the pipelines for the specified project ID

Throws:

GitLabApiException - if any exception occurs during execution

getPipelines

public List<Pipeline> getPipelines(int projectId,
                                   Constants.PipelineScope scope,
                                   PipelineStatus status,
                                   String ref,
                                   boolean yamlErrors,
                                   String name,
                                   String username,
                                   Constants.PipelineOrderBy orderBy,
                                   Constants.SortOrder sort)
                            throws GitLabApiException

Get a list of pipelines in a project. GET /projects/:id/pipelines

Parameters:

projectId - the project ID to get the list of pipelines for

scope - the scope of pipelines, one of: RUNNING, PENDING, FINISHED, BRANCHES, TAGS

status - the status of pipelines, one of: RUNNING, PENDING, SUCCESS, FAILED, CANCELED, SKIPPED

ref - the ref of pipelines

yamlErrors - returns pipelines with invalid configurations

name - the name of the user who triggered pipelines

username - the username of the user who triggered pipelines

orderBy - order pipelines by ID, STATUS, REF, USER_ID (default: ID)

sort - sort pipelines in ASC or DESC order (default: DESC)

Returns:

a list containing the pipelines for the specified project ID

Throws:

GitLabApiException - if any exception occurs during execution

getPipelines

public List<Pipeline> getPipelines(int projectId,
                                   Constants.PipelineScope scope,
                                   PipelineStatus status,
                                   String ref,
                                   boolean yamlErrors,
                                   String name,
                                   String username,
                                   Constants.PipelineOrderBy orderBy,
                                   Constants.SortOrder sort,
                                   int page,
                                   int perPage)
                            throws GitLabApiException

Get a list of pipelines in a project in the specified page range. GET /projects/:id/pipelines

Parameters:

projectId - the project ID to get the list of pipelines for

scope - the scope of pipelines, one of: RUNNING, PENDING, FINISHED, BRANCHES, TAGS

status - the status of pipelines, one of: RUNNING, PENDING, SUCCESS, FAILED, CANCELED, SKIPPED

ref - the ref of pipelines

yamlErrors - returns pipelines with invalid configurations

name - the name of the user who triggered pipelines

username - the username of the user who triggered pipelines

orderBy - order pipelines by ID, STATUS, REF, USER_ID (default: ID)

sort - sort pipelines in ASC or DESC order (default: DESC)

page - the page to get

perPage - the number of Pipeline instances per page

Returns:

a list containing the pipelines for the specified project ID

Throws:

GitLabApiException - if any exception occurs during execution

getPipelines

public Pager<Pipeline> getPipelines(int projectId,
                                    Constants.PipelineScope scope,
                                    PipelineStatus status,
                                    String ref,
                                    boolean yamlErrors,
                                    String name,
                                    String username,
                                    Constants.PipelineOrderBy orderBy,
                                    Constants.SortOrder sort,
                                    int itemsPerPage)
                             throws GitLabApiException

Get a Pager of pipelines in a project. GET /projects/:id/pipelines

Parameters:

projectId - the project ID to get the list of pipelines for

scope - the scope of pipelines, one of: RUNNING, PENDING, FINISHED, BRANCHES, TAGS

status - the status of pipelines, one of: RUNNING, PENDING, SUCCESS, FAILED, CANCELED, SKIPPED

ref - the ref of pipelines

yamlErrors - returns pipelines with invalid configurations

name - the name of the user who triggered pipelines

username - the username of the user who triggered pipelines

orderBy - order pipelines by ID, STATUS, REF, USER_ID (default: ID)

sort - sort pipelines in ASC or DESC order (default: DESC)

itemsPerPage - the number of Pipeline instances that will be fetched per page

Returns:

a list containing the pipelines for the specified project ID

Throws:

GitLabApiException - if any exception occurs during execution

getPipeline

public Pipeline getPipeline(int projectId,
                            int pipelineId)
                     throws GitLabApiException

Get single pipelines in a project. GET /projects/:id/pipelines/:pipeline_id

Parameters:

projectId - the project ID to get the specified pipeline for

pipelineId - the pipeline ID to get

Returns:

a single pipelines for the specified project ID

Throws:

GitLabApiException - if any exception occurs during execution

createPipeline

public Pipeline createPipeline(int projectId,
                               String ref)
                        throws GitLabApiException

Create a pipelines in a project. POST /projects/:id/pipelines

Parameters:

projectId - the project ID to create a pipeline in

ref - reference to commit

Returns:

a Pipeline instance with the newly created pipeline info

Throws:

GitLabApiException - if any exception occurs during execution

retryPipelineJob

public Pipeline retryPipelineJob(int projectId,
                                 int pipelineId)
                          throws GitLabApiException

Retry a job in specified pipelines in a project. POST /projects/:id/pipelines/:pipeline_id/retry

Parameters:

projectId - the project ID to retry a job for speficied pipeline

pipelineId - the pipeline ID to retry a job from

Returns:

pipeline instance which just retried

Throws:

GitLabApiException - if any exception occurs during execution

cancelPipelineJobs

public Pipeline cancelPipelineJobs(int projectId,
                                   int pipelineId)
                            throws GitLabApiException

Cancel jobs of specified pipelines in a project. POST /projects/:id/pipelines/:pipeline_id/cancel

Parameters:

projectId - the project ID to cancel jobs for speficied pipeline

pipelineId - the pipeline ID to cancel jobs

Returns:

pipeline instance which just canceled

Throws:

GitLabApiException - if any exception occurs during execution