OCI

List Tags

List multiple OCITags

An OCIRepository can publish zero or more OCITags. OCITags are names that point to a unique OCIArtifact digest.

An OCITag’s ID is comprised of the OCIRepository ID followed by a : and the Tag name.

Examples of OCITag identifiers:

docker.io/istio/pilot:1.3.0: The 1.3.0 tag on the docker.io/istio/pilot OCIRepository.
public.ecr.aws/bottlerocket/bottlerocket-operator:0.1: The 0.1 tag on the public.ecr.aws/bottlerocket/bottlerocket-operator OCIRepository.

GET

ocitags

List Tags

curl --request GET \
  --url https://api.example.com/ocitags

{
  "results": [
    {
      "artifact": "<string>",
      "created_by": "<string>",
      "created_on": "2023-11-07T05:31:56Z",
      "last_modified_by": "<string>",
      "last_modified_on": "2023-11-07T05:31:56Z",
      "repository": "<string>",
      "tag": "<string>",
      "$schema": "<string>"
    }
  ],
  "$schema": "<string>",
  "pagination": {
    "continue": "<string>"
  }
}

Query Parameters

continue

string

Continuation token value (used when retrieving the next page of results).

integer<int64>

Number of records to show per page of results.

Required range: 0 <= x <= 100

filter

string

Record filter.

Response

results

object[] | null

required

Show child attributes

$schema

string<uri>

read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/ListOCITagsOutputBody.json"

pagination

object

Show child attributes

Create TagCreate a new OCITag An OCIRepository can publish zero or more OCITags. OCITags are names that point to a unique OCIArtifact digest. An OCITag's ID is comprised of the OCIRepository ID followed by a : and the Tag name. Examples of OCITag identifiers: * docker.io/istio/pilot:1.3.0: The 1.3.0 tag on the docker.io/istio/pilot OCIRepository. * public.ecr.aws/bottlerocket/bottlerocket-operator:0.1: The 0.1 tag on the public.ecr.aws/bottlerocket/bottlerocket-operator OCIRepository.

⌘I

List Tags

curl --request GET \
  --url https://api.example.com/ocitags

{
  "results": [
    {
      "artifact": "<string>",
      "created_by": "<string>",
      "created_on": "2023-11-07T05:31:56Z",
      "last_modified_by": "<string>",
      "last_modified_on": "2023-11-07T05:31:56Z",
      "repository": "<string>",
      "tag": "<string>",
      "$schema": "<string>"
    }
  ],
  "$schema": "<string>",
  "pagination": {
    "continue": "<string>"
  }
}

Documentation Index

Query Parameters

Response