Files
gitlab-foss/doc/development/geo/api.md
2024-02-27 18:09:38 +00:00

1.5 KiB

stage, group, info
stage group info
Systems Geo To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments

Geo API

DETAILS: Tier: Premium, Ultimate Offering: Self-managed, GitLab Dedicated Status: Beta

The Geo API is used internally by GitLab components to assist in coordinating Geo actions. It is inaccessible to admins or users.

Fetch pipeline refs

This method returns a list of branches matching pipeline/refs/X that exist on the repository for gl_repository on the current Geo node. This endpoint is used by runners registered with a secondary Geo instance to check if a repository is up to date.

GET /geo/repositories/:gl_repository/pipeline_refs

Supported attributes:

Attribute Type Required Description
gl_repository string Yes The gl_repository ID of the repository to query

If successful, returns 200 and the following response attributes:

Attribute Type Description
attribute 'array' An array of ids matching refs/pipeline/X created for running pipelines.