v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1340127143.5 KB
projects

Lists versions.

get/v1/{+parent}/versions

Path parameters

parentstring required

The name of the parent resource whose versions will be listed.

Query parameters

filterstring

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*`"

orderBystring

Optional. The field to order the results by.

pageSizeinteger

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

pageTokenstring

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

view'VERSION_VIEW_UNSPECIFIED' | 'BASIC' | 'FULL'

The view that should be returned in the response.

Response

Successful response