Documention for Import PUT Route
Context
This import endpoint starts an Import. It is the caller's responsibility to check the number of tags in the repository before initiating import, since this route may take some seconds to return. The registry should define a configurable limit of tags that it will allow to be imported, to prevent serving import requests against very large repositories.
Rough Outline
This is a rough outline of a potential design and should be considered a placeholder for scenarios to consider.
Route
PUT gitlab/v1/repositories/import/<name>
Success
-
200 — OK
Already imported -
202 — Accepted
The import (or pre import) was successfully started
Errors
-
400 — Bad Request
Repository contains too many tags to import. TODO: communicate this information back to the caller -
401 Unauthorized
The client should take action based on the contents of theWWW-Authenticate
header and try the endpoint again. -
404 Not Found
The repository was not found. -
409 — Conflict
Repository is already being imported -
424 — Failed Dependency
Repository failed to pre import -
425 — Too Early
Repository is currently being pre imported -
429 — Too Many Requests
This registry instance is already running the maximum configured import jobs
Edited by Jaime Martinez