Reference documentation and code samples for the Google Cloud Artifact Registry V1 Client class ListVersionsRequest.
The request to list versions.
Generated from protobuf message google.devtools.artifactregistry.v1.ListVersionsRequest
Namespace
Google \ Cloud \ ArtifactRegistry \ V1
Methods
__construct
Constructor.
Parameters
Name
Description
data
array
Optional. Data for populating the Message object.
↳ parent
string
The name of the parent resource whose versions will be listed.
↳ page_size
int
The maximum number of versions to return. Maximum page size is 1,000.
↳ page_token
string
The next_page_token value returned from a previous list request, if any.
↳ view
int
The view that should be returned in the response.
↳ order_by
string
Optional. The field to order the results by.
↳ 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 versions with the name my-version 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/versions/my-version" 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-package/versions/*version" * * name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/my*" * * name="projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/*version*" To filter the results of your request to versions 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 versions with the annotation key-value pair [external.link:https://example.com/my-version], append the following filter expression to your request: * * "annotations.`external.link`:`https://example.com/my-version`" You can also filter with annotations with a wildcard to match any number of characters before or after the value: * * "annotations.*_link:`*example.com*`"
getParent
The name of the parent resource whose versions will be listed.
Returns
Type
Description
string
setParent
The name of the parent resource whose versions will be listed.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getPageSize
The maximum number of versions to return. Maximum page size is 1,000.
Returns
Type
Description
int
setPageSize
The maximum number of versions 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
getView
The view that should be returned in the response.
Returns
Type
Description
int
setView
The view that should be returned in the response.
Parameter
Name
Description
var
int
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
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 versions with the name
my-version 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/versions/my-version"
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-package/versions/*version*"
To filter the results of your request to versions 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 versions with the annotation key-value pair
[external.link:https://example.com/my-version], append the following
filter expression to your request:
"annotations.`external.link`:`https://example.com/my-version`"
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 versions with the name
my-version 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/versions/my-version"
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-package/versions/*version*"
To filter the results of your request to versions 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 versions with the annotation key-value pair
[external.link:https://example.com/my-version], append the following
filter expression to your request:
"annotations.`external.link`:`https://example.com/my-version`"
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
static::build
Parameter
Name
Description
parent
string
The name of the parent resource whose versions will be listed.
[[["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-09-04 UTC."],[],[],null,["# Google Cloud Artifact Registry V1 Client - Class ListVersionsRequest (1.2.1)\n\nVersion latestkeyboard_arrow_down\n\n- [1.2.1 (latest)](/php/docs/reference/cloud-artifact-registry/latest/V1.ListVersionsRequest)\n- [1.2.0](/php/docs/reference/cloud-artifact-registry/1.2.0/V1.ListVersionsRequest)\n- [1.1.3](/php/docs/reference/cloud-artifact-registry/1.1.3/V1.ListVersionsRequest)\n- [1.0.0](/php/docs/reference/cloud-artifact-registry/1.0.0/V1.ListVersionsRequest)\n- [0.6.5](/php/docs/reference/cloud-artifact-registry/0.6.5/V1.ListVersionsRequest)\n- [0.5.1](/php/docs/reference/cloud-artifact-registry/0.5.1/V1.ListVersionsRequest)\n- [0.4.4](/php/docs/reference/cloud-artifact-registry/0.4.4/V1.ListVersionsRequest)\n- [0.3.13](/php/docs/reference/cloud-artifact-registry/0.3.13/V1.ListVersionsRequest) \nReference documentation and code samples for the Google Cloud Artifact Registry V1 Client class ListVersionsRequest.\n\nThe request to list versions.\n\nGenerated from protobuf message `google.devtools.artifactregistry.v1.ListVersionsRequest`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ ArtifactRegistry \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getParent\n\nThe name of the parent resource whose versions will be listed.\n\n### setParent\n\nThe name of the parent resource whose versions will be listed.\n\n### getPageSize\n\nThe maximum number of versions to return. Maximum page size is 1,000.\n\n### setPageSize\n\nThe maximum number of versions to return. Maximum page size is 1,000.\n\n### getPageToken\n\nThe next_page_token value returned from a previous list request, if any.\n\n### setPageToken\n\nThe next_page_token value returned from a previous list request, if any.\n\n### getView\n\nThe view that should be returned in the response.\n\n### setView\n\nThe view that should be returned in the response.\n\n### getOrderBy\n\nOptional. The field to order the results by.\n\n### setOrderBy\n\nOptional. The field to order the results by.\n\n### getFilter\n\nOptional. An expression for filtering the results of the request. Filter\nrules are case insensitive. The fields eligible for filtering are:\n\n- `name`\n- `annotations` Examples of using a filter: To filter the results of your request to versions with the name `my-version` in project `my-project` in the `us-central` region, in repository `my-repo`, append the following filter expression to your request:\n- `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/my-version\"` You can also use wildcards to match any number of characters before or after the value:\n- `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/*version\"`\n- `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/my*\"`\n- `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/*version*\"` To filter the results of your request to versions with the annotation key-value pair \\[`external_link`: `external_link_value`\\], append the following filter expression to your request:\n- `\"annotations.external_link:external_link_value\"` To filter just for a specific annotation key `external_link`, append the following filter expression to your request:\n- `\"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 versions with the annotation key-value pair \\[`external.link`:`https://example.com/my-version`\\], append the following filter expression to your request:\n- ``\"annotations.`external.link`:`https://example.com/my-version`\"`` You can also filter with annotations with a wildcard to match any number of characters before or after the value:\n- ``\"annotations.*_link:`*example.com*`\"``\n\n### setFilter\n\nOptional. An expression for filtering the results of the request. Filter\nrules are case insensitive. The fields eligible for filtering are:\n\n- `name`\n- `annotations` Examples of using a filter: To filter the results of your request to versions with the name `my-version` in project `my-project` in the `us-central` region, in repository `my-repo`, append the following filter expression to your request:\n- `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/my-version\"` You can also use wildcards to match any number of characters before or after the value:\n- `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/*version\"`\n- `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/my*\"`\n- `name=\"projects/my-project/locations/us-central1/repositories/my-repo/packages/my-package/versions/*version*\"` To filter the results of your request to versions with the annotation key-value pair \\[`external_link`: `external_link_value`\\], append the following filter expression to your request:\n- `\"annotations.external_link:external_link_value\"` To filter just for a specific annotation key `external_link`, append the following filter expression to your request:\n- `\"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 versions with the annotation key-value pair \\[`external.link`:`https://example.com/my-version`\\], append the following filter expression to your request:\n- ``\"annotations.`external.link`:`https://example.com/my-version`\"`` You can also filter with annotations with a wildcard to match any number of characters before or after the value:\n- ``\"annotations.*_link:`*example.com*`\"``\n\n### static::build"]]
