mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-18 14:56:05 +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
|
|
@ -35,6 +35,9 @@ COMMANDS
|
|||
list
|
||||
List Artifact Registry files.
|
||||
|
||||
update
|
||||
Update annotations on an Artifact Registry file.
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
|
|
|
|||
|
|
@ -13,34 +13,86 @@ 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 artifacts files list --repository=my-repo \
|
||||
--location=us-central1
|
||||
$ gcloud artifacts files list --repository=my-repo --location=us
|
||||
|
||||
The following command lists a maximum of five files:
|
||||
|
||||
$ gcloud artifacts files list --repository=my-repo \
|
||||
--location=us-central1 --limit=5
|
||||
$ gcloud artifacts files list --repository=my-repo --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 artifacts files list --repository=my-repo \
|
||||
--location=us-central1 --package=my-package
|
||||
$ gcloud artifacts files list --repository=my-repo --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 artifacts files list --repository=my-repo \
|
||||
--location=us-central1 --package=my-package --version=1.0.0
|
||||
$ gcloud artifacts files list --repository=my-repo --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 artifacts files list --repository=my-repo \
|
||||
--location=us-central1 --package=my-package --tag=my-tag
|
||||
$ gcloud artifacts files list --repository=my-repo --location=us \
|
||||
--package=my-package --tag=my-tag
|
||||
|
||||
To list files with name as my-file:
|
||||
|
||||
$ gcloud 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 artifacts files list \
|
||||
--filter='name="projects/my-project/locations/us/repositories/my\
|
||||
-repo/files/*file"'
|
||||
|
||||
$ gcloud artifacts files list \
|
||||
--filter='name="projects/my-project/locations/us/repositories/my\
|
||||
-repo/files/my-*"'
|
||||
|
||||
To list files that have annotations:
|
||||
|
||||
$ gcloud artifacts files list --filter=annotations:*
|
||||
|
||||
To list files with annotations pair as [annotation_key: annotation_value]
|
||||
|
||||
$ gcloud artifacts files list \
|
||||
--filter='annotations.annotation_key:annotation_value'
|
||||
|
||||
To list files with annotations containing key as my_key:
|
||||
|
||||
$ gcloud 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 artifacts files list --filter='annotations.`my.key`'
|
||||
|
||||
$ gcloud 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 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 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 artifacts files list --repository=my-repo --location=us \
|
||||
--sort-by=~update_time
|
||||
|
||||
FLAGS
|
||||
--package=PACKAGE
|
||||
|
|
|
|||
106
gcloud/artifacts/files/update
Normal file
106
gcloud/artifacts/files/update
Normal file
|
|
@ -0,0 +1,106 @@
|
|||
NAME
|
||||
gcloud artifacts files update - update annotations on an Artifact Registry
|
||||
file
|
||||
|
||||
SYNOPSIS
|
||||
gcloud artifacts files update
|
||||
(FILE : --location=LOCATION --repository=REPOSITORY)
|
||||
[--annotations=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
Update annotations on an Artifact Registry file.
|
||||
|
||||
EXAMPLES
|
||||
To update annotations on a file named my-file.txt when the project ID,
|
||||
repository and location defaults are set, run the following command:
|
||||
|
||||
CAUTION: This command will overwrite any existing annotations on the file.
|
||||
|
||||
$ gcloud artifacts files update my-file.txt \
|
||||
--annotations=key1=value1,key2=value2
|
||||
|
||||
To clear all annotations on the file run the following command:
|
||||
|
||||
$ gcloud artifacts files update my-file.txt --annotations={}
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
File resource - The Artifact Registry file 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 file 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.
|
||||
|
||||
FILE
|
||||
ID of the file or fully qualified identifier for the file.
|
||||
|
||||
To set the file attribute:
|
||||
▸ provide the argument file 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 file. 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 file 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 file. 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 file on the command line with a fully
|
||||
specified name;
|
||||
▸ provide the argument --repository on the command line;
|
||||
▸ set the property artifacts/repository.
|
||||
|
||||
FLAGS
|
||||
--annotations=[KEY=VALUE,...]
|
||||
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