Google Cloud Artifact Registry V1 Client - Class ListFilesRequest (1.1.2)

Reference documentation and code samples for the Google Cloud Artifact Registry V1 Client class ListFilesRequest.

The request to list files.

Generated from protobuf message google.devtools.artifactregistry.v1.ListFilesRequest

Namespace

Google \ Cloud \ ArtifactRegistry \ V1

Methods

__construct

Constructor.

Parameters
Name	Description
`data`	`array` Optional. Data for populating the Message object.
`↳ parent`	`string` Required. The name of the repository whose files will be listed. For example: "projects/p1/locations/us-central1/repositories/repo1
`↳ 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: * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/my-file.txt"` 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/files/my-"` * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/file.txt"` * `name="projects/my-project/locations/us-central1/repositories/my-repo/files/file"` To filter the results of your request to files owned by the version `1.0` in package `pkg1`, append the following filter expression to your request: * * `owner="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0"` 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: * * "annotations.`external.link`:`https://example.com/my-file`" You can also filter with annotations with a wildcard to match any number of characters before or after the value: * * "annotations._link:`example.com*`"
`↳ page_size`	`int` The maximum number of files to return. Maximum page size is 1,000.
`↳ page_token`	`string` The next_page_token value returned from a previous list request, if any.
`↳ order_by`	`string` The field to order the results by.

getParent

Required. The name of the repository whose files will be listed. For example: "projects/p1/locations/us-central1/repositories/repo1

Returns
Type	Description
`string`

setParent

Required. The name of the repository whose files will be listed. For example: "projects/p1/locations/us-central1/repositories/repo1

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getFilter

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:
name="projects/my-project/locations/us-central1/repositories/my-repo/files/my-file.txt" 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/files/my-*"
name="projects/my-project/locations/us-central1/repositories/my-repo/files/*file.txt"
name="projects/my-project/locations/us-central1/repositories/my-repo/files/*file*" To filter the results of your request to files owned by the version 1.0 in package pkg1, append the following filter expression to your request:
owner="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0" 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:
"annotations.`external.link`:`https://example.com/my-file`" You can also filter with annotations with a wildcard to match any number of characters before or after the value:
"annotations.*_link:`*example.com*`"

Returns
Type	Description
`string`

setFilter

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:
name="projects/my-project/locations/us-central1/repositories/my-repo/files/my-file.txt" 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/files/my-*"
name="projects/my-project/locations/us-central1/repositories/my-repo/files/*file.txt"
name="projects/my-project/locations/us-central1/repositories/my-repo/files/*file*" To filter the results of your request to files owned by the version 1.0 in package pkg1, append the following filter expression to your request:
owner="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/1.0" 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:
"annotations.`external.link`:`https://example.com/my-file`" You can also filter with annotations with a wildcard to match any number of characters before or after the value:
"annotations.*_link:`*example.com*`"

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getPageSize

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

Returns
Type	Description
`int`

setPageSize

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

Parameter
Name	Description
`var`	`int`

Returns
Type	Description
`$this`

getPageToken

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

Returns
Type	Description
`string`

setPageToken

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

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

getOrderBy

The field to order the results by.

Returns
Type	Description
`string`

setOrderBy

The field to order the results by.

Parameter
Name	Description
`var`	`string`

Returns
Type	Description
`$this`

static::build

Parameter
Name	Description
`parent`	`string` Required. The name of the repository whose files will be listed. For example: "projects/p1/locations/us-central1/repositories/repo1 Please see ArtifactRegistryClient::repositoryName() for help formatting this field.

Returns
Type	Description
`ListFilesRequest`