ibmcloud-regions
List IBM Cloud regions
TLDR
View information for all regions
SYNOPSIS
ibmcloud regions [--json] [--help]
PARAMETERS
--json
Output results in JSON format for scripting.
--help, -h
Display command help and options.
DESCRIPTION
The ibmcloud regions command displays all IBM Cloud regions worldwide, showing their names, IDs, display names, and operational status (e.g., available or deprecated). This helps users select optimal locations for deploying services based on availability, latency, compliance, and data residency needs.
IBM Cloud operates over 60 regions across 6 geographic platforms, including North America, Europe, Asia-Pacific, and South America. Not all services (e.g., Watson, Kubernetes) are available everywhere, so this command is essential for architecture planning and multi-region strategies.
Output defaults to a human-readable table. Requires the IBM Cloud CLI installed (ibmcloud v0.1 or later). No login required, as region data is public. Use alongside ibmcloud target to switch active regions or check service support via the catalog.
CAVEATS
Lists global infrastructure regions; use ibmcloud cf regions for Cloud Foundry-specific regions. Availability shown is general—verify service support in IBM Cloud Catalog.
EXAMPLE
ibmcloud regions
Shows table: au-syd (Sydney, available).
ibmcloud regions --json
{"resources": [{"name": "au-syd", ...}]}
OUTPUT COLUMNS
Region Name: Short ID (e.g., us-south).
Region ID: Full identifier.
Display Name: Human-readable (e.g., US South).
Status: available/deprecated.
HISTORY
Evolved from Bluemix CLI (bx regions, 2014); renamed ibmcloud in 2018 with IBM Cloud rebranding. Enhanced for JSON output and multi-cloud support in v1.0+.
