- NAME
-
- gcloud beta apigee archives update - update an existing Apigee archive deployment
- SYNOPSIS
-
-
gcloud beta apigee archives update(ARCHIVE_DEPLOYMENT:--environment=ENVIRONMENT--organization=ORGANIZATION) [--update-labels=[KEY=VALUE, …]] [--clear-labels|--remove-labels=[KEY, …]] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Update an existing Apigee archive deployment.gcloud beta apigee archives updateupdates an Apigee archive deployment. - EXAMPLES
- To update the
andtaglabels of an archive deployment with the idrevin the Apigee environment calledabcdef01234using the active Cloud Platform project, run:my-envgcloud beta apigee archives update abcdef01234 --environment = my-env --update-labels = tag = my-tag,rev = 1234To remove the
label on an archive deployment with the iddev, in the Apigee environment calleduvwxyz56789, in an organization calledmy-env, run:my-orggcloud beta apigee archives update uvwxyz56789 --environment = my-env --organization = my-org --remove-labels = devTo clear all labels on an archive deployment with the id
, in the Apigee environment calledmnop4321, in an organization calledmy-env, and return the updated archive deployment as a JSON object, run:my-orggcloud beta apigee archives update mnop4321 --environment = my-env --organization = my-org --clear-labels --format = json - POSITIONAL ARGUMENTS
-
- Archive deployment resource - Archive deployment to update. To get a list of
existing archive deployments, run
gcloud beta apigee archives list. The arguments in this group can be used to specify the attributes of this resource.This must be specified.
-
ARCHIVE_DEPLOYMENT - ID of the archive deployment or fully qualified identifier for the archive
deployment.
To set the
archive_deploymentattribute:- provide the argument
archive_deploymenton the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
- provide the argument
-
--environment=ENVIRONMENT - Deployment environment of the archive deployment.
To set the
environmentattribute:- provide the argument
archive_deploymenton the command line with a fully specified name; - provide the argument
--environmenton the command line.
- provide the argument
-
--organization=ORGANIZATION - Apigee organization containing the archive deployment. If unspecified, the Cloud
Platform project's associated organization will be used.
To set the
organizationattribute:- provide the argument
archive_deploymenton the command line with a fully specified name; - provide the argument
--organizationon the command line; - set the property [project] or provide the argument [--project] on the command line, using a Cloud Platform project with an associated Apigee organization.
- provide the argument
-
- Archive deployment resource - Archive deployment to update. To get a list of
existing archive deployments, run
- FLAGS
-
-
--update-labels=[KEY=VALUE,…] - List of label KEY=VALUE pairs to update. If a label exists, its value is
modified. Otherwise, a new label is created.
Keys must start with a lowercase character and contain only hyphens (
-), underscores (_), lowercase characters, and numbers. Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers. - At most one of these can be specified:
-
--clear-labels - Remove all labels. If
--update-labelsis also specified then--clear-labelsis applied first.For example, to remove all labels:
gcloud beta apigee archives update --clear-labelsTo remove all existing labels and create two new labels,
andfoo:bazgcloud beta apigee archives update --clear-labels --update-labels foo = bar,baz = qux -
--remove-labels=[KEY,…] - List of label keys to remove. If a label does not exist it is silently ignored.
If
--update-labelsis also specified then--update-labelsis applied first.
-
-
- 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. - NOTES
- This command is currently in beta and might change without notice. This variant
is also available:
gcloud alpha apigee archives update
gcloud beta apigee archives update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

