Required. The name of the repository whose files will be listed. For example: "projects/p1/locations/us-central1/repositories/repo1
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
annotations
Examples of using a filter:
To filter the results of your request to files with the name my_file.txt in project my-project in the us-central region, in repository my-repo, append the following filter expression to your request:
To filter the results of your request to files with the annotation key-value pair [external_link: external_link_value], append the following filter expression to your request:
"annotations.external_link:external_link_value"
To filter just for a specific annotation key external_link, append the following filter expression to your request:
"annotations.external_link"
If the annotation key or value contains special characters, you can escape them by surrounding the value with backticks. For example, to filter the results of your request to files with the annotation key-value pair [external.link:https://example.com/my-file], append the following filter expression to your request:
[[["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-06-13 UTC."],[[["\u003cp\u003eThis page details how to list files within a specified repository, outlining the necessary HTTP request structure and parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is mandatory and requires \u003ccode\u003eartifactregistry.files.list\u003c/code\u003e IAM permission for authorization.\u003c/p\u003e\n"],["\u003cp\u003eQuery parameters like \u003ccode\u003efilter\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003eorderBy\u003c/code\u003e are available for refining the search and controlling the output, and \u003ccode\u003efilter\u003c/code\u003e supports wildcard matching and escaped characters.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the successful response contains an array of files and a \u003ccode\u003enextPageToken\u003c/code\u003e for pagination.\u003c/p\u003e\n"],["\u003cp\u003eEither \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform.read-only\u003c/code\u003e OAuth scopes are required for authorization.\u003c/p\u003e\n"]]],[],null,[]]