container_repository
Gets or lists a container_repository resource.
Overview​
| Name | container_repository |
| Type | Resource |
| Id | gitlab.packages.container_repository |
Fields​
The following fields are returned by SELECT queries:
- get
GraphQL response envelope
| Name | Datatype | Description |
|---|---|---|
id | string | ID of the container repository. |
name | string | Name of the container repository. |
created_at | string | Timestamp when the container repository was created. |
expiration_policy_cleanup_status | string | Tags cleanup status for the container repository. (UNSCHEDULED, SCHEDULED, UNFINISHED, ONGOING) |
expiration_policy_started_at | string | Timestamp when the cleanup done by the expiration policy was started on the container repository. |
last_cleanup_deleted_tags_count | integer | Number of deleted tags from the last cleanup. |
last_published_at | string | Timestamp when a repository tag was last created or updated. Only present for repositories that had tags created or updated after GitLab 16.11. |
location | string | URL of the container repository. |
path | string | Path of the container repository. |
project | object | Project identity (id, full_path, name) |
protection_rule_exists | boolean | Whether any matching container protection rule exists for the container repository. |
size | number | Deduplicated size of the image repository in bytes. This is only available on GitLab.com for repositories created after 2021-11-04. |
status | string | Status of the container repository. (DELETE_SCHEDULED, DELETE_FAILED, DELETE_ONGOING) |
tags_count | integer | Number of tags associated with the image. |
updated_at | string | Timestamp when the container repository was updated. |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | id, host | Find a container repository. Generated from the GitLab GraphQL schema field Query.containerRepository (ContainerRepositoryDetails). |
Parameters​
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
host | string | GitLab host, with an optional port (default gitlab.com). Resolved from the GITLAB_HOST environment variable when it is set (x-stackQL-envVar); a WHERE host value always takes precedence. Self-managed instances: the provider is generated from the gitlab.com schema, so older instances may reject fields they do not serve. (default: gitlab.com, x-stackQL-envVar: GITLAB_HOST) |
id | string | Global ID of the container repository. |
SELECT examples​
- get
Find a container repository. Generated from the GitLab GraphQL schema field Query.containerRepository (ContainerRepositoryDetails).
SELECT
id,
name,
created_at,
expiration_policy_cleanup_status,
expiration_policy_started_at,
last_cleanup_deleted_tags_count,
last_published_at,
location,
path,
project,
protection_rule_exists,
size,
status,
tags_count,
updated_at
FROM gitlab.packages.container_repository
WHERE id = '{{ id }}' -- required
AND host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
;