Method: projects.locations.repositories.files.list

Lists files.

HTTP request

GET https://artifactregistry.googleapis.com/v1beta1/{parent=projects/*/locations/*/repositories/*}/files

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The name of the parent resource whose files will be listed.

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

  • artifactregistry.files.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
  • 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

integer

The maximum number of files to return.

pageToken

string

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

Request body

The request body must be empty.

Response body

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

The response from listing files.

JSON representation
{
  "files": [
    {
      object (File)
    }
  ],
  "nextPageToken": string
}
Fields
files[]

object (File)

The files returned.

nextPageToken

string

The token to retrieve the next page of files, or empty if there are no more files 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.

IAM Permissions

Requires the following Cloud IAM permission on the parent resource:

  • artifactregistry.files.list

For more information, see the Cloud IAM Documentation.