APIHub
Back to Explore

Artifact Registry API

Store and manage build artifacts in a scalable and integrated service built on Google infrastructure.

Analytics
OAuth
HTTPS
CORS: Unknown
Visit official documentation

Latency

Not monitored yet

Uptime

Not monitored yet

Playground

Verified

live

Endpoints

REST · JSON
GET

/v1beta2/{name}

Gets a version

  • name (path, required) — The name of the version to retrieve.
  • view (query) — The view that should be returned in the response.
DELETE

/v1beta2/{name}

Deletes a version and all of its content. The returned operation will complete once the version has been deleted.

  • name (path, required) — The name of the version to delete.
  • force (query) — By default, a version that is tagged may not be deleted. If force=true, the version and any tags pointing to the version are deleted.
PATCH

/v1beta2/{name}

Updates a tag.

  • name (path, required) — The name of the tag, for example: "projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/tags/tag1". If the package part contains slashes, the slashes are escaped. The tag part can only have characters in [a-zA-Z0-9\-._~:@], anything else must be URL encoded.
  • updateMask (query) — The update mask applies to the resource. For the `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
GET

/v1beta2/{name}/locations

Lists information about the supported locations for this service.

  • name (path, required) — The resource that owns the locations collection, if applicable.
  • filter (query) — A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
  • pageSize (query, limit) — The maximum number of results to return. If not set, the service selects a default.
  • pageToken (query) — A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.
POST

/v1beta2/{parent}/aptArtifacts:create

Directly uploads an Apt artifact. The returned Operation will complete once the resources are uploaded. Package, Version, and File resources are created based on the imported artifact. Imported artifacts that conflict with existing resources are ignored.

  • parent (path, required) — The name of the parent resource where the artifacts will be uploaded.
POST

/v1beta2/{parent}/aptArtifacts:import

Imports Apt artifacts. The returned Operation will complete once the resources are imported. Package, Version, and File resources are created based on the imported artifacts. Imported artifacts that conflict with existing resources are ignored.

  • parent (path, required) — The name of the parent resource where the artifacts will be imported.
GET

/v1beta2/{parent}/files

Lists files.

  • parent (path, required) — Required. The name of the repository whose files will be listed. For example: "projects/p1/locations/us-central1/repositories/repo1
  • filter (query) — An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `name` * `owner` An example of using a filter: * `name="projects/p1/locations/us-central1/repositories/repo1/files/a/b/*"` --> Files with an ID starting with "a/b/". * `owner="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0"` --> Files owned by the version `1.0` in package `pkg1`.
  • pageSize (query, limit) — The maximum number of files to return.
  • pageToken (query) — The next_page_token value returned from a previous list request, if any.
GET

/v1beta2/{parent}/packages

Lists packages.

  • parent (path, required) — Required. The name of the parent resource whose packages will be listed.
  • pageSize (query, limit) — The maximum number of packages to return. Maximum page size is 1,000.
  • pageToken (query) — The next_page_token value returned from a previous list request, if any.
GET

/v1beta2/{parent}/repositories

Lists repositories.

  • parent (path, required) — Required. The name of the parent resource whose repositories will be listed.
  • pageSize (query, limit) — The maximum number of repositories to return. Maximum page size is 1,000.
  • pageToken (query) — The next_page_token value returned from a previous list request, if any.
POST

/v1beta2/{parent}/repositories

Creates a repository. The returned Operation will finish once the repository has been created. Its response will be the created Repository.

  • parent (path, required) — Required. The name of the parent resource where the repository will be created.
  • repositoryId (query) — The repository id to use for this repository.
GET

/v1beta2/{parent}/tags

Lists tags.

  • parent (path, required) — The name of the parent resource whose tags will be listed.
  • filter (query) — An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * `version` An example of using a filter: * `version="projects/p1/locations/us-central1/repositories/repo1/packages/pkg1/versions/1.0"` --> Tags that are applied to the version `1.0` in package `pkg1`.
  • pageSize (query, limit) — The maximum number of tags to return. Maximum page size is 10,000.
  • pageToken (query) — The next_page_token value returned from a previous list request, if any.
POST

/v1beta2/{parent}/tags

Creates a tag.

  • parent (path, required) — The name of the parent resource where the tag will be created.
  • tagId (query) — The tag id to use for this repository.
GET

/v1beta2/{parent}/versions

Lists versions.

  • parent (path, required) — The name of the parent resource whose versions will be listed.
  • orderBy (query) — Optional. The field to order the results by.
  • pageSize (query, limit) — The maximum number of versions to return. Maximum page size is 1,000.
  • pageToken (query) — The next_page_token value returned from a previous list request, if any.
  • view (query) — The view that should be returned in the response.
POST

/v1beta2/{parent}/yumArtifacts:create

Directly uploads a Yum artifact. The returned Operation will complete once the resources are uploaded. Package, Version, and File resources are created based on the imported artifact. Imported artifacts that conflict with existing resources are ignored.

  • parent (path, required) — The name of the parent resource where the artifacts will be uploaded.
POST

/v1beta2/{parent}/yumArtifacts:import

Imports Yum (RPM) artifacts. The returned Operation will complete once the resources are imported. Package, Version, and File resources are created based on the imported artifacts. Imported artifacts that conflict with existing resources are ignored.

  • parent (path, required) — The name of the parent resource where the artifacts will be imported.
GET

/v1beta2/{resource}:getIamPolicy

Gets the IAM policy for a given resource.

  • resource (path, required) — REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
  • options.requestedPolicyVersion (query) — Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
POST

/v1beta2/{resource}:setIamPolicy

Updates the IAM policy for a given resource.

  • resource (path, required) — REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
POST

/v1beta2/{resource}:testIamPermissions

Tests if the caller has a list of permissions on a resource.

  • resource (path, required) — REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

18 endpoints auto-detected

Authentication

This API requires authentication: OAuth.

curl -X GET \
  "https://artifactregistry.googleapis.com/v1beta2/{name}"

artifactregistry.googleapis.com · HTTPS only