Stay organized with collections
Save and categorize content based on your preferences.
The Artifact Registry API uses Kubernetes custom resources and relies on the Kubernetes
Resource Model (KRM). This API is used to view and manage Harbor container registry instances.
Service endpoint and discovery document
The API endpoint for the Artifact Registry API is:
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/artifactregistry.gdc.goog/v1
where MANAGEMENT_API_SERVER_ENDPOINT is the endpoint of the
Management API server.
Using the kubectl proxy command, you can access that URL in your browser or
with a tool such as curl to get the discovery document for the Artifact Registry API.
The kubectl proxy command opens up a proxy to the Kubernetes API server on
your local machine. After that command is running, you can access the document at
the following URL: http://127.0.0.1:8001/apis/artifactregistry.gdc.goog/v1.
Example Harbor container registry instance
The following is an example of a Harbor container registry instance:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThe Artifact Registry API utilizes Kubernetes custom resources and the Kubernetes Resource Model (KRM) for managing Harbor container registry instances.\u003c/p\u003e\n"],["\u003cp\u003eThe API endpoint for the Artifact Registry is located at \u003ccode\u003ehttps://\u003c/code\u003e\u003cvar translate=no\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e\u003ccode\u003e/apis/artifactregistry.gdc.goog/v1\u003c/code\u003e, with the specific endpoint determined by the Management API server.\u003c/p\u003e\n"],["\u003cp\u003eYou can access the API's discovery document by using \u003ccode\u003ekubectl proxy\u003c/code\u003e and then navigating to \u003ccode\u003ehttp://127.0.0.1:8001/apis/artifactregistry.gdc.goog/v1\u003c/code\u003e in your browser or through a tool like \u003ccode\u003ecurl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAn example Harbor container registry instance is illustrated, which shows the relevant API version, kind, name, and namespace.\u003c/p\u003e\n"]]],[],null,["# Artifact Registry API overview\n\nThe Artifact Registry API uses Kubernetes custom resources and relies on the Kubernetes\nResource Model (KRM). This API is used to view and manage Harbor container registry instances.\n\nService endpoint and discovery document\n---------------------------------------\n\nThe API endpoint for the Artifact Registry API is:\n`https://`\u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/artifactregistry.gdc.goog/v1`\nwhere \u003cvar translate=\"no\"\u003eMANAGEMENT_API_SERVER_ENDPOINT\u003c/var\u003e is the endpoint of the\nManagement API server.\n\nUsing the `kubectl proxy` command, you can access that URL in your browser or\nwith a tool such as `curl` to get the discovery document for the Artifact Registry API.\nThe `kubectl proxy` command opens up a proxy to the Kubernetes API server on\nyour local machine. After that command is running, you can access the document at\nthe following URL: `http://127.0.0.1:8001/apis/artifactregistry.gdc.goog/v1`.\n\nExample Harbor container registry instance\n------------------------------------------\n\nThe following is an example of a Harbor container registry instance: \n\n apiVersion: artifactregistry.gdc.goog/v1\n kind: HarborInstance\n metadata:\n name: myinstance\n namespace: tenant-project-namespace"]]