Retrieve a remote mirror for a project

GET

/api/v4/projects/{id}/remote_mirrors/{mirror_id}

Retrieves a specified remote mirror for a project.

Authorizations

http
oauth2

Parameters

Path Parameters

required

One of:

string
integer

string

The ID or URL-encoded path of the project

mirror_id

required

string

The ID of a remote mirror

Responses

200

application/json

object

integer format: int64

enabled

boolean

url

string

update_status

string

last_update_at

string format: date-time

last_update_started_at

string format: date-time

last_successful_update_at

string format: date-time

last_error

string

only_protected_branches

boolean

keep_divergent_refs

boolean

auth_method

string

host_keys

Array<object>

object

fingerprint_sha256

string

mirror_branch_regex

string

Example

{
  "id": 101486,
  "enabled": true,
  "url": "https://*****:*****@example.com/gitlab/example.git",
  "update_status": "finished",
  "last_update_at": "2020-01-06T17:32:02.823Z",
  "last_update_started_at": "2020-01-06T17:32:02.823Z",
  "last_successful_update_at": "2020-01-06T17:31:55.864Z",
  "last_error": "The remote mirror URL is invalid.",
  "auth_method": "password",
  "host_keys": [
    {
      "fingerprint_sha256": "SHA256:abcd1234"
    }
  ],
  "mirror_branch_regex": "feature-.*"
}

400

Bad Request

401

Unauthorized

404

Not found