NAME

gcloud beta apigee deployments list - list Apigee API proxy deployments

SYNOPSIS

gcloud beta apigee deployments list [--api=API --environment=ENVIRONMENT --organization=ORGANIZATION --revision=REVISION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(BETA) List Apigee API proxy deployments.

gcloud beta apigee deployments list lists deployments of API proxies, optionally filtered by environment, proxy name, proxy revision, or a combination of these.

EXAMPLES

To list all deployments for the active Cloud Platform project, run:

$ gcloud beta apigee deployments list

To list all deployments in an Apigee organization called my-org, run:

$ gcloud beta apigee deployments list --organization=my-org

To list all deployments of an API proxy called my-proxy in the active Cloud Platform project, run:

$ gcloud beta apigee deployments list --api=my-proxy

To list all deployments to the test environment of the active Cloud Platform project, formatted as a JSON array, run:

$ gcloud beta apigee deployments list --environment=test \ --format=json

To list all deployments of my-proxy to the test environment in an Apigee organization called my-org, run:

$ gcloud beta apigee deployments list --organization=my-org \ --api=my-proxy --environment=test

FLAGS

Revision resource - API proxy revision and environment whose deployments should

be listed. Providing a REVISION is only valid if API is also specified. If no REVISION is provided, all deployed revisions that match the other arguments will be included. The arguments in this group can be used to specify the attributes of this resource.

--api=API

The API proxy whose deployments should be listed. If not provided, all proxies will be listed. To get a list of existing API proxies, run gcloud beta apigee apis list. 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;

  • leave the argument unspecified for it to be chosen automatically.

--environment=ENVIRONMENT

The environment whose deployments should be listed. If not provided, all environments will be listed. To get a list of available environments, run gcloud beta apigee environments list. 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;

  • leave the argument unspecified for it to be chosen automatically.

--organization=ORGANIZATION

The organization whose deployments should be listed.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.

--revision=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.

LIST COMMAND FLAGS

--filter=EXPRESSION

Apply a Boolean filter EXPRESSION to each resource item to be listed. If the expression evaluates True, then that item is listed. For more details and examples of filter expressions, run $ gcloud topic filters. This flag interacts with other flags that are applied in this order: --flatten, --sort-by, --filter, --limit.

--limit=LIMIT

Maximum number of resources to list. The default is unlimited. This flag interacts with other flags that are applied in this order: --flatten, --sort-by, --filter, --limit.

--page-size=PAGE_SIZE

Some services group resource list output into pages. This flag specifies the maximum number of resources per page. The default is determined by the service if it supports paging, otherwise it is unlimited (no paging). Paging may be applied before or after --filter and --limit depending on the service.

--sort-by=[FIELD,...]

Comma-separated list of resource field key names to sort by. The default order is ascending. Prefix a field with ``~'' for descending order on that field. This flag interacts with other flags that are applied in this order: --flatten, --sort-by, --filter, --limit.

--uri

Print a list of resource URIs instead of the default output, and change the command output to a list of URIs. If this flag is used with --format, the formatting is applied on this URI list. To display URIs alongside other keys instead, use the uri() transform.

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. These variants are also available:

$ gcloud apigee deployments list

$ gcloud alpha apigee deployments list