gcloud run services list: List Cloud Run Services
gcloud run services list enumerates the Cloud Run services in a region with their URLs and status.
After deploys, a quick inventory of what is running and where is useful. This lists services with their URL, last-deployed revision, and ready state.
What it does
gcloud run services list returns the Cloud Run services in the chosen region (fully managed) or cluster (for Anthos). Each row shows the service name, region, URL, last-deployed-by, and ready condition.
Common usage
gcloud run services list --region=us-central1
# just names and URLs
gcloud run services list --region=us-central1 \
--format='table(metadata.name, status.url)'Flags
| Flag | What it does |
|---|---|
| --region <region> | Region to list services in |
| --platform managed|gke | Cloud Run platform (managed is default) |
| --format <fmt> | Output format, e.g. value(status.url) |
| --filter <expr> | Filter rows, e.g. metadata.name:api- |
In CI
Set the region with --region or gcloud config set run/region so you do not get prompted. Authenticate with Workload Identity Federation and use --format=value(status.url) to capture a service URL for a smoke-test step.
Common errors in CI
"The required property [region] is not currently set" means no region was provided or configured; add --region. "PERMISSION_DENIED: ... run.services.list" means the identity lacks roles/run.viewer. "Cloud Run Admin API has not been used in project ..." means run.googleapis.com is not enabled.