Authorization requires the following IAM permission on the specified resource name:
dataform.repositories.queryDirectoryContents
Query parameters
Parameters
commitSha
string
Optional. The Commit SHA for the commit to query from. If unset, the directory will be queried from HEAD.
path
string
Optional. The directory's full path including directory name, relative to root. If left unset, the root is used.
pageSize
integer
Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.
pageToken
string
Optional. Page token received from a previous repositories.queryDirectoryContents call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to repositories.queryDirectoryContents, with the exception of pageSize, must match the call that provided the page token.
[[["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-07-21 UTC."],[[["\u003cp\u003eThis endpoint retrieves the contents of a specified directory within a Dataform repository, which cannot have a value for \u003ccode\u003egitRemoteSettings.url\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request is made using a \u003ccode\u003eGET\u003c/code\u003e HTTP method and includes the repository's name as a required path parameter, where authorization requires the \u003ccode\u003edataform.repositories.queryDirectoryContents\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters like \u003ccode\u003ecommitSha\u003c/code\u003e, \u003ccode\u003epath\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e allow for filtering and pagination of the directory contents.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains a list of \u003ccode\u003edirectoryEntries\u003c/code\u003e and an optional \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving subsequent pages of directory listings.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires either the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/bigquery\u003c/code\u003e OAuth scope, in addition to the \u003ccode\u003edataform.repositories.queryDirectoryContents\u003c/code\u003e IAM permission.\u003c/p\u003e\n"]]],[],null,[]]