- NAME
-
- gcloud alpha run services describe - obtain details about a given service
- SYNOPSIS
-
-
gcloud alpha run services describe(SERVICE:--namespace=NAMESPACE) [--endpoint-mode=ENDPOINT_MODE] [--region=REGION] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(ALPHA)Obtain details about a given service. - EXAMPLES
-
To obtain details about a given service:
gcloud alpha run services describe <service-name>To get those details in the YAML format:
gcloud alpha run services describe <service-name> --format=yamlTo get them in YAML format suited to export (omitting metadata specific to this deployment and status info):
gcloud alpha run services describe <service-name> --format=export - POSITIONAL ARGUMENTS
-
-
Service resource - Service to describe. The arguments in this group can be used
to specify the attributes of this resource.
This must be specified.
SERVICE-
ID of the service or fully qualified identifier for the service.
To set the
serviceattribute:-
provide the argument
SERVICEon the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--namespace=NAMESPACE-
Specific to Cloud Run for Anthos: Kubernetes namespace for the service.
To set the
namespaceattribute:-
provide the argument
SERVICEon the command line with a fully specified name; -
provide the argument
--namespaceon the command line; -
set the property
run/namespace; - For Cloud Run on Kubernetes Engine, defaults to "default". Otherwise, defaults to project ID.;
-
provide the argument
projecton the command line; -
set the property
core/project.
-
provide the argument
-
Service resource - Service to describe. The arguments in this group can be used
to specify the attributes of this resource.
- FLAGS
-
--endpoint-mode=ENDPOINT_MODE-
Specifies endpoint mode for a given command. Regional endpoints provide enhanced
data residency and reliability by ensuring your request is handled entirely
within the specified Google Cloud region. This differs from global endpoints,
which may process parts of the request outside the target region. Overrides the
default
regional/endpoint_modeproperty value for this command invocation.ENDPOINT_MODEmust be one of:global- (Default) Use global rather than regional endpoints.
regional- Only use regional endpoints. An error will be raised if a regional endpoint is not available for a given command.
regional-preferred- Use regional endpoints when available, otherwise use global endpoints. Recommended for most users.
--region=REGION- Region in which the resource can be found. Alternatively, set the property [run/region].
- 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. - REGIONAL ENDPOINTS
-
This command supports regional endpoints. To use regional endpoints for this
command, use the
--endpoint-mode=regional-preferredflag. To use regional endpoints by default, run$ gcloud config set regional/endpoint_mode regional-preferred. - 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 run services describegcloud beta run services describe
gcloud alpha run services describe
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-04-07 UTC.