Method: projects.locations.repositories.packages.tags.list

Lists tags.

HTTP request


The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The name of the parent package whose tags will be listed. For example: projects/p1/locations/us-central1/repositories/repo1/packages/pkg1.

Authorization requires the following IAM permission on the specified resource parent:

  • artifactregistry.tags.list

Query parameters

Parameters
filter

string

An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are:

  • name
  • version

Examples of using a filter:

To filter the results of your request to tags with the name my-tag in package my-package in repository my-repo in project "y-project in the us-central region, append the following filter expression to your request:

  • name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my-tag"

You can also use wildcards to match any number of characters before or after the value:

  • name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/my*"
  • name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag"
  • name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/tags/*tag*"

To filter the results of your request to tags applied to the version 1.0 in package my-package, append the following filter expression to your request:

  • version="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0"
pageSize

integer

The maximum number of tags to return. Maximum page size is 1,000.
pageToken

string

The nextPageToken value returned from a previous list request, if any.

Request body

The request body must be empty.

Response body

The response from listing tags.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "tags": [
    {
      object (Tag)
    }
  ],
  "nextPageToken": string
}
Fields
tags[]

object (Tag)

The tags returned.
nextPageToken

string

The token to retrieve the next page of tags, or empty if there are no more tags to return.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

For more information, see the Authentication Overview.