1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-18 06:47:12 +00:00

gcloud: Wed Sep 11 09:52:17 UTC 2024

This commit is contained in:
Automated 2024-09-11 09:52:17 +00:00
parent 78a4d78e9e
commit a3842bba95
197 changed files with 6656 additions and 691 deletions

View file

@ -14,34 +14,87 @@ DESCRIPTION
To specify the maximum number of files to list, use the --limit flag.
EXAMPLES
To list files in the current project under repository my-repo in
us-central1:
To list files in the current project under repository my-repo in us:
$ gcloud beta artifacts files list --repository=my-repo \
--location=us-central1
$ gcloud beta artifacts files list --repository=my-repo --location=us
The following command lists a maximum of five files:
$ gcloud beta artifacts files list --repository=my-repo \
--location=us-central1 --limit=5
--location=us --limit=5
To list files in the current project under repository my-repo in
us-central1 owned by package my-package:
To list files in the current project under repository my-repo in us owned
by package my-package:
$ gcloud beta artifacts files list --repository=my-repo \
--location=us-central1 --package=my-package
--location=us --package=my-package
To list files in the current project under repository my-repo in
us-central1 owned by package my-package and version 1.0.0:
To list files in the current project under repository my-repo in us owned
by package my-package and version 1.0.0:
$ gcloud beta artifacts files list --repository=my-repo \
--location=us-central1 --package=my-package --version=1.0.0
--location=us --package=my-package --version=1.0.0
To list files in the current project under repository my-repo in
us-central1 owned by package my-package and tag name my-tag:
To list files in the current project under repository my-repo in us owned
by package my-package and tag name my-tag:
$ gcloud beta artifacts files list --repository=my-repo \
--location=us-central1 --package=my-package --tag=my-tag
--location=us --package=my-package --tag=my-tag
To list files with name as my-file:
$ gcloud beta artifacts files list \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/files/my-file"'
To list files with a given partial name, use * to match any character in
name:
$ gcloud beta artifacts files list \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/files/*file"'
$ gcloud beta artifacts files list \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/files/my-*"'
To list files that have annotations:
$ gcloud beta artifacts files list --filter=annotations:*
To list files with annotations pair as [annotation_key: annotation_value]
$ gcloud beta artifacts files list \
--filter='annotations.annotation_key:annotation_value'
To list files with annotations containing key as my_key:
$ gcloud beta artifacts files list --filter='annotations.my_key'
If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required:
$ gcloud beta artifacts files list --filter='annotations.`my.key`'
$ gcloud beta artifacts files list \
--filter='annotations.`my.key`:`my.value`'
To list files with given partial annotation key or value, use * to match
any character:
$ gcloud beta artifacts files list \
--filter='annotations.*key:`*.value`'
To list files in the current project under repository my-repo in us,
ordering by create_time:
$ gcloud beta artifacts files list --repository=my-repo \
--location=us --sort-by=create_time
To list files in the current project under repository my-repo in us,
ordering by update_time reversely:
$ gcloud beta artifacts files list --repository=my-repo \
--location=us --sort-by=~update_time
FLAGS
--package=PACKAGE

View file

@ -18,11 +18,63 @@ EXAMPLES
$ gcloud beta artifacts packages list --limit=5
To list packages with name as my-pkg:
$ gcloud beta artifacts packages list \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/packages/my-pkg"
To list packages with a given partial name, use * to match any character in
name:
$ gcloud beta artifacts packages list \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/packages/*pkg"'
$ gcloud beta artifacts packages list \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/packages/my*"'
To list files that have annotations:
$ gcloud beta artifacts packages list --filter=annotations:*
To list packages with annotations pair as [annotation_key:
annotation_value]:
$ gcloud beta artifacts packages list \
--filter='annotations.annotation_key:annotation_value'
To list packages with annotations containing key as my_key:
$ gcloud beta artifacts packages list --filter='annotations.my_key'
If the key or value contains special characters, such as `my.key` or `my.value`, backtick("`") is required:
$ gcloud beta artifacts packages list --filter='annotations.`my.key`'
$ gcloud beta artifacts packages list \
--filter='annotations.`my.key`:`my.value`'
To list packages with given partial annotation key or value, use * to match
any character:
$ gcloud beta artifacts packages list \
--filter='annotations.my_*:`*.value`'
To list packages ordered by create_time:
$ gcloud beta artifacts packages list --sort-by=create_time
To list packages ordered by update_time reversely:
$ gcloud beta artifacts packages list --sort-by=~update_time
FLAGS
Repository resource - The parent repository for the list of packages. The
arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
Repository resource - The Artifact Registry repository. If not specified,
the current artifacts/repository is used. The arguments in this group can
be used to specify the attributes of this resource. (NOTE) Some attributes
are not given arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument --repository on the command line with a fully
@ -32,9 +84,7 @@ FLAGS
◆ set the property core/project.
--location=LOCATION
Location of the repository. Overrides the default artifacts/location
property value for this command invocation. To configure the default
location, use the command: gcloud config set artifacts/location.
Location of the repository.
To set the location attribute:
▸ provide the argument --repository on the command line with a
@ -86,10 +136,6 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
API REFERENCE
This command uses the artifactregistry/v1 API. The full documentation for
this API can be found at: https://cloud.google.com/artifacts/docs/
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

View file

@ -18,6 +18,57 @@ EXAMPLES
$ gcloud beta artifacts repositories list --limit=5
To list repositories with name as `my_repo`:
$ gcloud beta artifacts repositories list \
--filter='name="projects/my-project/locations/us/repositories/my\
_repo"'
To list repositories with a given partial name, use `*` to match any character in name:
$ gcloud beta artifacts repositories list \
--filter='name="projects/my-project/locations/us/repositories/*r\
epo"'
$ gcloud beta artifacts repositories list \
--filter='name="projects/my-project/locations/us/repositories/my\
_*"'
To list files that have annotations:
$ gcloud beta artifacts repositories list --filter=annotations:*
To list repositories with annotations pair as [annotation_key: annotation_value]
$ gcloud beta artifacts repositories list \
--filter='annotations.annotation_key:annotation_value'
To list repositories with annotations containing key as `my_key`:
$ gcloud beta artifacts repositories list \
--filter='annotations.my_key'
If the key or value contains special characters, such as `my.key` or `my.value`, backtick("`") is required:
$ gcloud beta artifacts repositories list \
--filter='annotations.`my.key`'
$ gcloud beta artifacts repositories list \
--filter='annotations.`my.key`:`my.value`'
To list repositories with given partial annotation key or value, use `*` to match any character:
$ gcloud beta artifacts repositories list \
--filter='annotations.*key:`*.value`'
To list repositories ordered by create_time:
$ gcloud beta artifacts repositories list --sort-by=create_time
To list repositories ordered by update_time reversely:
$ gcloud beta artifacts repositories list--sort-by=~update_time
FLAGS
Location resource - The Artifact Registry repository location. You can
also set --location=all to list repositories across all locations. If you

View file

@ -2,10 +2,10 @@ NAME
gcloud beta artifacts tags list - list Artifact Registry tags
SYNOPSIS
gcloud beta artifacts tags list
(--package=PACKAGE : --location=LOCATION --repository=REPOSITORY)
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
[--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...]
gcloud beta artifacts tags list --package=PACKAGE
[--location=LOCATION --repository=REPOSITORY] [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) List all Artifact Registry tags in the specified package.
@ -27,49 +27,57 @@ EXAMPLES
$ gcloud beta artifacts tags list --package=my-package --limit=5
To list tags of package my-package with name as my-tag:
$ gcloud beta artifacts tags list --package=my-package \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/packages/my-package/tags/my-tag"'
To list tags of package my-package with a given partial name, use * to
match any character in name:
$ gcloud beta artifacts tags list --package=my-package \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/packages/my-package/tags/my*"'
$ gcloud beta artifacts tags list --package=my-package \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/packages/my-package/tags/*tag"'
REQUIRED FLAGS
Package resource - The parent package for the list of tags. The arguments
in this group can be used to specify the attributes of this resource.
(NOTE) Some attributes are not given arguments in this group but can be
set in other ways.
--package=PACKAGE
List all tags in a specified artifact, such as a container image or a
language package.
FLAGS
Repository resource - The Artifact Registry repository. If not specified,
the current artifacts/repository is used. The arguments in this group can
be used to specify the attributes of this resource. (NOTE) Some attributes
are not given arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument --package on the command line with a fully
◆ provide the argument --repository on the command line with a fully
specified name;
◆ set the property artifacts/repository with a fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
--package=PACKAGE
ID of the package or fully qualified identifier for the package.
To set the package attribute:
▸ provide the argument --package on the command line.
This flag argument must be specified if any of the other arguments in
this group are specified.
--location=LOCATION
Location of the package. Overrides the default artifacts/location
property value for this command invocation. To configure the default
location, use the command: gcloud config set artifacts/location.
Location of the repository.
To set the location attribute:
▸ provide the argument --package on the command line with a fully
specified name;
▸ provide the argument --repository on the command line with a
fully specified name;
▸ set the property artifacts/repository with a fully specified
name;
▸ provide the argument --location on the command line;
▸ set the property artifacts/location.
--repository=REPOSITORY
The repository associated with the package. Overrides the default
artifacts/repository property value for this command invocation. To
configure the default repository, use the command: gcloud config set
artifacts/repository.
ID of the repository or fully qualified identifier for the
repository.
To set the repository attribute:
▸ provide the argument --package on the command line with a fully
specified name;
▸ provide the argument --repository on the command line;
▸ set the property artifacts/repository.
@ -107,10 +115,6 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
API REFERENCE
This command uses the artifactregistry/v1 API. The full documentation for
this API can be found at: https://cloud.google.com/artifacts/docs/
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

View file

@ -3,72 +3,112 @@ NAME
versions
SYNOPSIS
gcloud beta artifacts versions list
(--package=PACKAGE : --location=LOCATION --repository=REPOSITORY)
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
[--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...]
gcloud beta artifacts versions list --package=PACKAGE
[--location=LOCATION --repository=REPOSITORY] [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) List all Artifact Registry package versions in the specified
package.
(BETA) List all Artifact Registry versions in the specified package.
To specify the maximum number of versions to list, use the --limit flag.
EXAMPLES
The following command lists a maximum of five versions:
The following command lists a maximum of five packages versions:
$ gcloud beta artifacts versions list --limit=5
The following command lists versions in my-package by specifying the
fully-qualified path:
To list versions of package my_pkg with name as 1.0-SNAPSHOT:
$ gcloud beta artifacts versions list --package=my_pkg \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/packages/my_pkg/versions/1.0-SNAPSHOT"'
To list versions of package my_pkg with a given partial name, use * to
match any character in name:
$ gcloud beta artifacts versions list --package=my_pkg \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/packages/my_pkg/versions/1.0*"'
$ gcloud beta artifacts versions list --package=my_pkg \
--filter='name="projects/my-project/locations/us/repositories/my\
-repo/packages/my_pkg/versions/*SNAPSHOT"'
To list versions of package my_pkg that have annotations:
$ gcloud beta artifacts versions list --package=my_pkg \
--filter=annotations:*
To list versions of package my_pkg with annotations pair as
[annotation_key: annotation_value]:
$ gcloud beta artifacts versions list --package=my_pkg \
--filter='annotations.annotation_key:annotation_value'
To list versions of package my_pkg with annotations containing key as
my_key:
$ gcloud beta artifacts versions list --package=my_pkg \
--filter=annotations.my_key
If the key or value contains special characters, such as `my.key` and `my.value`, backtick("`") is required:
$ gcloud beta artifacts versions list --filter='annotations.`my.key`'
$ gcloud beta artifacts versions list \
--package=projects/my-project/locations/my-location/\
repositories/my-repo/packages/my-package
--filter='annotations.`my.key`:`my.value`'
To list versions of package my_pkg with given partial annotation key or
value, use * to match any character:
$ gcloud beta artifacts versions list \
--filter='annotations.*key:`*.value`'
To list versions of package my_pkg ordered by create_time:
$ gcloud beta artifacts versions list --package=my_pkg \
--sort-by=create_time
To list versions of package my_pkg ordered by update_time reversely:
$ gcloud beta artifacts versions list --package=my_pkg \
--sort-by=~update_time
REQUIRED FLAGS
Package resource - The parent package for the list of versions. The
arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
--package=PACKAGE
List all versions in a specified artifact, such as a container image or
a language package.
FLAGS
Repository resource - The Artifact Registry repository. If not specified,
the current artifacts/repository is used. The arguments in this group can
be used to specify the attributes of this resource. (NOTE) Some attributes
are not given arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument --package on the command line with a fully
◆ provide the argument --repository on the command line with a fully
specified name;
◆ set the property artifacts/repository with a fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
--package=PACKAGE
ID of the package or fully qualified identifier for the package.
To set the package attribute:
▸ provide the argument --package on the command line.
This flag argument must be specified if any of the other arguments in
this group are specified.
--location=LOCATION
Location of the package. Overrides the default artifacts/location
property value for this command invocation. To configure the default
location, use the command: gcloud config set artifacts/location.
Location of the repository.
To set the location attribute:
▸ provide the argument --package on the command line with a fully
specified name;
▸ provide the argument --repository on the command line with a
fully specified name;
▸ set the property artifacts/repository with a fully specified
name;
▸ provide the argument --location on the command line;
▸ set the property artifacts/location.
--repository=REPOSITORY
The repository associated with the package. Overrides the default
artifacts/repository property value for this command invocation. To
configure the default repository, use the command: gcloud config set
artifacts/repository.
ID of the repository or fully qualified identifier for the
repository.
To set the repository attribute:
▸ provide the argument --package on the command line with a fully
specified name;
▸ provide the argument --repository on the command line;
▸ set the property artifacts/repository.
@ -106,10 +146,6 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
API REFERENCE
This command uses the artifactregistry/v1 API. The full documentation for
this API can be found at: https://cloud.google.com/artifacts/docs/
NOTES
This command is currently in beta and might change without notice. These
variants are also available: