Container Tag History#

The tag history stores a list of image that still have or used to have the given tag

registry | String required

Hostname of the registry where the repository can be accessed.

repository | String required

Repository name.

tag | String required

The image tag name.

tag_type | String required

String parameters

enum persistent | floating

The tag type i.e. for floating or persistent.

object_type | String

String parameters

constant | containerTagHistory

history | List[History]

Array with the tag history information.

_id | ObjectID read-only

MongoDB unique _id

creation_date | DateTime read-only

The date when the entry was created. Value is created automatically on creation.

last_update_date | DateTime read-only

The date when the entry was last updated.

images | RESTGetImagesForTagHistory

URI to this tag’s images.

containerTagHistory_identity

Fields
  • repository: ASC

  • registry: ASC

  • tag: ASC

Parameters
  • unique: True

  • sparse: True

Description
Index for the containerTagHistory collection based on the repository, registry and tag fields

edges.images | List[Container Image]

Edge to related container images.

Parent arguments: [‘_id’]

Uses GQL query: find_tag_history_images

Example queries
{
    find_tag_histories(page: 0, page_size: 50, sort_by: [{ field: "creation_date", order: DESC }]) {
        error {
            detail
            status
        }
        total # omit for better performance
        page_size
        page
        data {
            _id
            edges {
                images {
                    error {
                        status
                        detail
                    }
                    data {
                        _id
                    }
                }
            }
        }
    }
}
{
    get_tag_history(id: "6304c560cbb2b2d2d4053b8e") {
        error {
            detail
            status
        }
        data {
            _id
            edges {
                images {
                    error {
                        status
                        detail
                    }
                    data {
                        _id
                    }
                }
            }
        }
    }
}
{
    get_tag_history_by_tag_name(registry: "example", repository: "example", tag: "example") {
        error {
            detail
            status
        }
        data {
            _id
            edges {
                images {
                    error {
                        status
                        detail
                    }
                    data {
                        _id
                    }
                }
            }
        }
    }
}