1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 18:45:13 +00:00
gcloud-help/gcloud/alpha/apigee/deployments/describe
2022-03-01 04:29:52 +00:00

105 lines
4.3 KiB
Text

NAME
gcloud alpha apigee deployments describe - describe an Apigee API proxy
deployment
SYNOPSIS
gcloud alpha apigee deployments describe
[[REVISION]
--api=API --environment=ENVIRONMENT --organization=ORGANIZATION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Describe an Apigee API proxy deployment.
gcloud alpha apigee deployments describe retrieves the status of a specific
API proxy's deployment to a specific environment.
EXAMPLES
To get the status of a deployment in the active Cloud Platform project,
which deploys my-proxy into the prod environment, run:
$ gcloud alpha apigee deployments describe --api=my-proxy \
--environment=prod
To get the status of that deployment as a JSON object, run:
$ gcloud alpha apigee deployments describe --api=my-proxy \
--environment=prod --format=json
To get the status of a deployment in an organization called my-org, which
deploys version 3 of the proxy my-proxy into the test environment, run:
$ gcloud alpha apigee deployments describe 3 --organization=my-org \
--environment=test --api=my-proxy
POSITIONAL ARGUMENTS
Revision resource - API proxy revision and environment of the deployment
to be described.
To get a list of deployed proxies and their environments, run:
$ gcloud alpha apigee deployments list
REVISION can either be a positive revision number, or the special value
auto, which will choose whichever revision of API is currently deployed in
ENVIRONMENT, or return an error if more than one revision is deployed.
If REVISION is unspecified, the default is auto.
The arguments in this group can be used to specify the attributes of this resource.
[REVISION]
ID of the revision or fully qualified identifier for the revision.
To set the revision attribute:
▸ provide the argument REVISION on the command line;
▸ leave the argument unspecified for it to be chosen
automatically.
--api=API
Deployed API proxy. To set the api attribute:
▸ provide the argument REVISION on the command line with a fully
specified name;
▸ leave the argument unspecified for it to be chosen
automatically with a fully specified name;
▸ provide the argument --api on the command line.
--environment=ENVIRONMENT
Environment in which the proxy was deployed. To set the environment
attribute:
▸ provide the argument REVISION on the command line with a fully
specified name;
▸ leave the argument unspecified for it to be chosen
automatically with a fully specified name;
▸ provide the argument --environment on the command line.
--organization=ORGANIZATION
Apigee Organization of the proxy and environment. If unspecified,
the Cloud Platform project's associated organization will be used.
To set the organization attribute:
▸ provide the argument REVISION on the command line with a fully
specified name;
▸ leave the argument unspecified for it to be chosen
automatically with a fully specified name;
▸ provide the argument --organization on 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.
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 alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud apigee deployments describe
$ gcloud beta apigee deployments describe