Skip to main content

OciRepoTag

A published version tag in an OCI repository.

Each tag corresponds to a single bundle release. Tags are immutable -- once a version is published, its contents cannot change. Development tags use a -dev.TIMESTAMP suffix (e.g., 1.2.3-dev.20060102T150405Z).

type OciRepoTag {
  tag: Semver!
  createdAt: DateTime!
  mediaType: String!
  digest: String!
  size: Int!
  readme: String
  changelog: String
  files(
    sort: OciFilesSort
    cursor: Cursor
  ): OciFilesPage
}

Fields​

OciRepoTag.tag ● Semver! non-null scalar {#tag}​

The semantic version string (e.g., 1.2.3 or 1.2.3-dev.20060102T150405Z).

OciRepoTag.createdAt ● DateTime! non-null scalar {#created-at}​

Timestamp when this version was published (UTC).

OciRepoTag.mediaType ● String! non-null scalar {#media-type}​

The OCI manifest media type wrapping this tag. Currently always application/vnd.oci.image.manifest.v1+json. The artifact type the manifest describes is available on OciRepo.artifactType.

OciRepoTag.digest ● String! non-null scalar {#digest}​

Content-addressable digest of this tag's manifest, in the form sha256:<hex> (for example, sha256:e3b0c4...). Combine with OciRepo.reference as @<digest> to pin a pull to this exact manifest.

OciRepoTag.size ● Int! non-null scalar {#size}​

Size of the manifest blob in bytes.

OciRepoTag.readme ● String scalar {#readme}​

The README for this version, in markdown. null if the publisher didn't include one. Each version's README is preserved as it was at publish time.

OciRepoTag.changelog ● String scalar {#changelog}​

The changelog for this version, in markdown. null if the publisher didn't include one. Each version's changelog is preserved as it was at publish time.

OciRepoTag.files ● OciFilesPage object {#files}​

Files packaged into this version of the artifact (e.g., README.md, schemas, source files, templates — whatever the publisher included).

Each item carries a downloadable url, a content-addressable digest, its declared mediaType, and its size — enough to render or verify the file. Defaults to name ascending.

OciRepoTag.files.sort ● OciFilesSort input {#oci-repo-tag-files-sort}​

Sort order for files. Defaults to name ascending.

OciRepoTag.files.cursor ● Cursor input {#oci-repo-tag-files-cursor}​

Cursor from a previous page's cursor.next or cursor.previous.

Member Of​

OciRepoTagsPage object