gcloud artifacts files update Stay organized with collections Save and categorize content based on your preferences.
- 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.txtwhen the projectID, repository and location defaults are set, run the following command:CAUTION: This command will overwrite any existing annotations on the file.
gcloudartifactsfilesupdatemy-file.txt--annotations=key1=value1,key2=value2To clear all annotations on the file run the following command:
gcloudartifactsfilesupdatemy-file.txt--annotations={} - POSITIONAL ARGUMENTS
- File resource - The Artifact Registry file to update. The arguments in thisgroup can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.
To set the
projectattribute:- provide the argument
fileon the command line with a fullyspecified name; - provide the argument
--projecton 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
fileattribute:- provide the argument
fileon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--location=LOCATION- Location of the file. Overrides the default artifacts/location property valuefor this command invocation. To configure the default location, use the command:gcloud config set artifacts/location.To set the
locationattribute:- provide the argument
fileon the command line with a fullyspecified name; - provide the argument
--locationon the command line; - set the property
artifacts/location.
- provide the argument
--repository=REPOSITORY- The repository associated with the file. Overrides the defaultartifacts/repository property value for this command invocation. To configurethe default repository, use the command: gcloud config set artifacts/repository.To set the
repositoryattribute:- provide the argument
fileon the command line with a fullyspecified name; - provide the argument
--repositoryon the command line; - set the property
artifacts/repository.
- provide the argument
- provide the argument
- File resource - The Artifact Registry file to update. The arguments in thisgroup can be used to specify the attributes of this resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.
- 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, seehttps://google.aip.dev/148#annotations.
KEY- Sets
KEYvalue. VALUE- Sets
VALUEvalue.
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 helpfor details. - API REFERENCE
- This command uses the
artifactregistry/v1API. The fulldocumentation for this API can be found at:https://cloud.google.com/artifacts/docs/
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-22 UTC.