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
parent
78a4d78e9e
commit
a3842bba95
197 changed files with 6656 additions and 691 deletions
|
|
@ -37,6 +37,9 @@ COMMANDS
|
|||
list
|
||||
List Artifact Registry packages.
|
||||
|
||||
update
|
||||
Update annotations on an Artifact Registry package.
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
|
|
|
|||
|
|
@ -18,11 +18,63 @@ EXAMPLES
|
|||
|
||||
$ gcloud artifacts packages list --limit=5
|
||||
|
||||
To list packages with name as my-pkg:
|
||||
|
||||
$ gcloud 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 artifacts packages list \
|
||||
--filter='name="projects/my-project/locations/us/repositories/my\
|
||||
-repo/packages/*pkg"'
|
||||
|
||||
$ gcloud artifacts packages list \
|
||||
--filter='name="projects/my-project/locations/us/repositories/my\
|
||||
-repo/packages/my*"'
|
||||
|
||||
To list files that have annotations:
|
||||
|
||||
$ gcloud artifacts packages list --filter=annotations:*
|
||||
|
||||
To list packages with annotations pair as [annotation_key:
|
||||
annotation_value]:
|
||||
|
||||
$ gcloud artifacts packages list \
|
||||
--filter='annotations.annotation_key:annotation_value'
|
||||
|
||||
To list packages with annotations containing key as my_key:
|
||||
|
||||
$ gcloud 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 artifacts packages list --filter='annotations.`my.key`'
|
||||
|
||||
$ gcloud 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 artifacts packages list \
|
||||
--filter='annotations.my_*:`*.value`'
|
||||
|
||||
To list packages ordered by create_time:
|
||||
|
||||
$ gcloud artifacts packages list --sort-by=create_time
|
||||
|
||||
To list packages ordered by update_time reversely:
|
||||
|
||||
$ gcloud 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
|
||||
These variants are also available:
|
||||
|
||||
|
|
|
|||
107
gcloud/artifacts/packages/update
Normal file
107
gcloud/artifacts/packages/update
Normal file
|
|
@ -0,0 +1,107 @@
|
|||
NAME
|
||||
gcloud artifacts packages update - update annotations on an Artifact
|
||||
Registry package
|
||||
|
||||
SYNOPSIS
|
||||
gcloud artifacts packages update
|
||||
(PACKAGE : --location=LOCATION --repository=REPOSITORY)
|
||||
[--annotations=[ANNOTATIONS,...]] [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
Update annotations on an Artifact Registry package.
|
||||
|
||||
EXAMPLES
|
||||
To update annotations on a package named my-pkg when the project ID,
|
||||
repository and location defaults are set, run the following command:
|
||||
|
||||
CAUTION: This command will overwrite any existing annotations on the
|
||||
package.
|
||||
|
||||
$ gcloud artifacts packages update my-pkg \
|
||||
--annotations=key1=value1,key2=value2
|
||||
|
||||
To clear all annotations on the package run the following command:
|
||||
|
||||
$ gcloud artifacts packages update my-pkg --annotations={}
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
Package resource - The Artifact Registry package to update. 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
|
||||
specified name;
|
||||
◆ provide the argument --project on the command line;
|
||||
◆ set the property core/project.
|
||||
|
||||
This must be specified.
|
||||
|
||||
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 positional 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.
|
||||
|
||||
To set the location attribute:
|
||||
▸ provide the argument package on the command line 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.
|
||||
|
||||
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.
|
||||
|
||||
FLAGS
|
||||
--annotations=[ANNOTATIONS,...]
|
||||
List of annotations in the format of KEY=VALUE pairs to add, update, or
|
||||
remove. Duplicate keys will be overwritten. For more details on
|
||||
annotations, see https://google.aip.dev/148#annotations.
|
||||
|
||||
KEY
|
||||
Sets KEY value.
|
||||
|
||||
VALUE
|
||||
Sets VALUE value.
|
||||
|
||||
Shorthand Example:
|
||||
|
||||
--annotations=string=string
|
||||
|
||||
JSON Example:
|
||||
|
||||
--annotations='{"string": "string"}'
|
||||
|
||||
File Example:
|
||||
|
||||
--annotations=path_to_file.(yaml|json)
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --account,
|
||||
--billing-project, --configuration, --flags-file, --flatten, --format,
|
||||
--help, --impersonate-service-account, --log-http, --project, --quiet,
|
||||
--trace-token, --user-output-enabled, --verbosity.
|
||||
|
||||
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/
|
||||
Loading…
Add table
Add a link
Reference in a new issue