Artifact Registry implements version 1.1 of the Open Container Initiative
(OCI) Distribution Specification so that you can push and pull
images directly with Docker clients, including the
[Docker command-line tool](https://docs.docker.com/engine/reference/commandline/cli/).

Google Cloud services that typically integrate with
Artifact Registry, such as Cloud Build and Google Kubernetes Engine, are
configured by with [default permissions](https://docs.cloud.google.com/artifact-registry/docs/access-control#integration) to access
repositories in the same project and don't require a separate client.

If you want to interact with Artifact Registry without the Docker client,
then we recommend using the [gcrane](https://github.com/google/go-containerregistry/blob/main/cmd/gcrane/README.md) tool. The tool provides:

- Standard commands that work with Artifact Registry and other registries.
- Commands for Artifact Registry tasks that don't have an equivalent command in the Google Cloud CLI or the Docker command-line tool, such as listing untagged images or copying images across registry hosts.

If gcrane isn't an appropriate option, then you can use the OCI
Distribution Specification:

- Refer to the [OCI Distribution Specification](https://github.com/opencontainers/distribution-spec/blob/main/spec.md) for information about the OCI request format.
- See [Authenticating using the Docker Registry API](https://docs.cloud.google.com/artifact-registry/docs/reference/docker-api#auth) for information about authentication using the API.

> [!NOTE]
> **Note:** Artifact Registry doesn't support Docker [chunked uploads](https://docs.docker.com/registry/spec/api/#chunked-upload). Some container image tools support uploading large container images with either chunked uploads or a single [monolithic upload](https://docs.docker.com/registry/spec/api/#monolithic-upload). You must use monolithic uploads when you push container images to Artifact Registry.

## Make requests to Artifact Registry using the OCI Distribution Specification

If using Docker or the `gcrane` tool isn't an option, then you can use the
OCI Distribution Specification.

First, grant the required [permissions](https://docs.cloud.google.com/artifact-registry/docs/access-control) to your user account. You can then use
the Google Cloud CLI to create an access token for requests.

The following example shows the command for [listing tags](https://docs.docker.com/registry/spec/api/#listing-image-tags), using
`my-image` as the image and `my-project` as the Google Cloud project. This
example also uses the [jq](https://stedolan.github.io/jq/) command to filter and format the output returned by
requests, but it's optional. The `jq` tool is included in Cloud Shell.

    curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://us-docker.pkg.dev/v2/my-project/my-repo/my-image/tags/list" | jq ".tags"