gcloud beta apigee apis undeploy

NAME
gcloud beta apigee apis undeploy - undeploy an Apigee API proxy from an environment
SYNOPSIS
gcloud beta apigee apis undeploy[[REVISION]--api=API--environment=ENVIRONMENT--organization=ORGANIZATION][GCLOUD_WIDE_FLAG]
DESCRIPTION
(BETA) Undeploy an Apigee API proxy from an environment.
EXAMPLES
To undeploy an API proxy calledmy-api fromthetest environment of the active CloudPlatform project, run:
gcloudbetaapigeeapisundeploy--environment=test--api=my-api

To undeploy revision 3 of anmy-api from thetestenvironment of the organization namedtest-org, run:

gcloudbetaapigeeapisundeploy3--organization=test-org--environment=test--api=my-api
POSITIONAL ARGUMENTS
Revision resource - API proxy revision to be undeployed and environment fromwhich it should be removed.

Revisions can either be a positive revision number, or the special valueauto, which will undeploy whatever revisionis currently deployed. If revision is unspecified, the default isauto. The arguments in this group can beused to specify the attributes of this resource.

[REVISION]
ID of the revision or fully qualified identifier for the revision.

To set therevision attribute:

  • provide the argumentREVISION on the command line;
  • leave the argument unspecified for it to be chosen automatically.
--api=API
API proxy to be undeployed. Must currently be deployed. To get a list ofavailable deployed proxies, rungcloud beta apigee deployments list--environment=ENV.

To set theapi attribute:

  • provide the argumentREVISION on the command line with a fullyspecified name;
  • leave the argument unspecified for it to be chosen automatically with a fullyspecified name;
  • provide the argument--api on the command line.
--environment=ENVIRONMENT
Environment from which to undeploy the API proxy. To get a list of availableenvironments, rungcloud beta apigeeenvironments list.

To set theenvironment attribute:

  • provide the argumentREVISION on the command line with a fullyspecified name;
  • leave the argument unspecified for it to be chosen automatically with a fullyspecified name;
  • provide the argument--environment on the command line.
--organization=ORGANIZATION
Apigee organization of the proxy and environment.

To set theorganization attribute:

  • provide the argumentREVISION on the command line with a fullyspecified name;
  • leave the argument unspecified for it to be chosen automatically with a fullyspecified name;
  • provide the argument--organization on the command line;
  • set the property [project] or provide the argument [--project] on the commandline, using a Cloud Platform project with an associated Apigee organization.
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.

NOTES
This command is currently in beta and might change without notice. Thesevariants are also available:
gcloudapigeeapisundeploy
gcloudalphaapigeeapisundeploy

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 2026-01-21 UTC.