gcloud beta apigee apis deploy - deploy an API proxy to an environment

gcloud beta apigee apis deploy[[REVISION]--api=API--environment=ENVIRONMENT--organization=ORGANIZATION][--override][GCLOUD_WIDE_FLAG …]

gcloud beta apigee apis deploy installs an API proxy revision in anApigee runtime environment.

By default, the API proxy's base path must not already be in use by a deployedproxy in the target environment. To allow Apigee to undeploy any conflicting APIproxy as part of the deployment, use the--override command.

Once a particular revision of an API proxy has been deployed, that revision canno longer be modified. Any updates to the API proxy must be saved as a newrevision.

gcloudbetaapigeeapisdeploy--environment=test--api=demo

To deploy revision 3 of that proxy, owned by an organization namedmy-org, run, and replace any conflictingdeployment that might already exist, run:

gcloudbetaapigeeapisdeploy3--organization=my-org--environment=test--api=demo--override

To deploy that proxy and print the resulting deployment as a JSON object, run:

gcloudbetaapigeeapisdeploy3--organization=my-org--environment=test--api=demo--format=json

Revision resource - API proxy revision to be deployed and environment in whichto deploy it. Revisions can either be a positive revision number, or the specialvaluelatest, which will deploy the latestrevision of the API proxy. If revision is unspecified, the default islatest. 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 deployed. To get a list of available API proxies, rungcloud beta apigee apislist.

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 in which to deploy 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. If unspecified, the CloudPlatform project's associated organization will be used.

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.

--override

Force the deployment of the new revision, overriding any currently deployedrevision that would conflict with it.

If an existing API proxy revision is deployed, set this flag to ensure seamlessdeployment with zero downtime. In this case, the existing revision remainsdeployed until the new revision is fully deployed.

If unset,gcloud beta apigee apis deploy will fail unless allconflicting API proxies are first undeployed from the environment. To do this,rungcloud betaapigee apis undeploy on the conflicting deployment.

Run$gcloud help for details.