Google Cloud Artifact Registry V1 Client - Class ListPackagesRequest (1.1.1)

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

The request to list packages.

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

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 parent resource whose packages will be listed.

↳ page_size int

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

↳ page_token string

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

↳ filter string

Optional. An expression for filtering the results of the request. Filter rules are case insensitive. The fields eligible for filtering are: * * name * * annotations Examples of using a filter: To filter the results of your request to packages with the name my-package 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/packages/my-package" 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-*" * * name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*package" * * name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*pack*" To filter the results of your request to packages 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 the results 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 packages with the annotation key-value pair [external.link:https://example.com/my-package], append the following filter expression to your request: * * "annotations.`external.link`:`https://example.com/my-package`" You can also filter with annotations with a wildcard to match any number of characters before or after the value: * * "annotations.*_link:`*example.com*`"

↳ order_by string

Optional. The field to order the results by.

getParent

Required. The name of the parent resource whose packages will be listed.

Returns
Type Description
string

setParent

Required. The name of the parent resource whose packages will be listed.

Parameter
Name Description
var string
Returns
Type Description
$this

getPageSize

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

Returns
Type Description
int

setPageSize

The maximum number of packages 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

getFilter

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

  • name
  • annotations Examples of using a filter: To filter the results of your request to packages with the name my-package 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/packages/my-package" 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-*"
  • name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*package"
  • name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*pack*" To filter the results of your request to packages 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 the results 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 packages with the annotation key-value pair [external.link:https://example.com/my-package], append the following filter expression to your request:
  • "annotations.`external.link`:`https://example.com/my-package`" 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

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

  • name
  • annotations Examples of using a filter: To filter the results of your request to packages with the name my-package 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/packages/my-package" 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-*"
  • name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*package"
  • name="projects/my-project/locations/us-central1/repositories/my-repo/packages/*pack*" To filter the results of your request to packages 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 the results 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 packages with the annotation key-value pair [external.link:https://example.com/my-package], append the following filter expression to your request:
  • "annotations.`external.link`:`https://example.com/my-package`" 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

getOrderBy

Optional. The field to order the results by.

Returns
Type Description
string

setOrderBy

Optional. 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 parent resource whose packages will be listed. Please see ArtifactRegistryClient::repositoryName() for help formatting this field.

Returns
Type Description
ListPackagesRequest