| CARVIEW |
Select Language
HTTP/2 301
date: Fri, 18 Jul 2025 01:56:20 GMT
content-type: text/html
location: /reference/doctl/reference/kubernetes/cluster/list/
x-frame-options: ALLOW-FROM https://marina.digitalocean.com/
x-xss-protection: 1; mode=block
content-security-policy: frame-ancestors https://amd.digitalocean.com/ https://amd.s2r1.internal.digitalocean.com/ https://localdev.internal.digitalocean.com https://cloud.s2r1.internal.digitalocean.com https://cloud.digitalocean.com https://digitaloceaninc.lookbookhq.com
x-content-security-policy: frame-ancestors https://amd.digitalocean.com/ https://amd.s2r1.internal.digitalocean.com/ https://localdev.internal.digitalocean.com https://cloud.s2r1.internal.digitalocean.com https://cloud.digitalocean.com https://digitaloceaninc.lookbookhq.com
x-do-app-origin: 278230ee-e6a3-11ec-b1dc-0c42a19a82a7
cache-control: private
x-do-orig-status: 301
cf-cache-status: DYNAMIC
set-cookie: __cf_bm=2MzfJHhUnz3zEaqHrCcCb23z1zxegcq..mmDl2UBll8-1752803780-1.0.1.1-agWEhmZmCuiraYGZUsCeUpYeDGPc8fWcWUMvGO55TKqLjeUuIirLBlTqPhPcL8ufdALHpop_.PQr9MQZBgK4Osnp21hTSrc__L7u7R0jurU; path=/; expires=Fri, 18-Jul-25 02:26:20 GMT; domain=.ondigitalocean.app; HttpOnly; Secure; SameSite=None
vary: Accept-Encoding
set-cookie: __cf_bm=zP1dkyeVRfOzjAcCIpoISjYupUhMtJNa0HYl1qAJzrw-1752803780-1.0.1.1-SPuQLrtDsl_5S2ELzTTZyxAfeFB8kGBYcHt6XdZgaS93mDEOT8.Jmg6RgDPq_p6nVg0rDyCk9mTCAU.JOctcGBTVIWiEMxEvkr7.9LBQ0KYxlhwbyb4SqLfTnAkk8NN4; path=/; expires=Fri, 18-Jul-25 02:26:20 GMT; domain=.digitalocean.com; HttpOnly; Secure; SameSite=None
server: cloudflare
cf-ray: 960e5ca7fc61c181-BLR
HTTP/2 200
date: Fri, 18 Jul 2025 01:56:21 GMT
content-type: text/html
last-modified: Thu, 17 Jul 2025 20:59:36 GMT
vary: Accept-Encoding
x-frame-options: ALLOW-FROM https://marina.digitalocean.com/
x-xss-protection: 1; mode=block
content-security-policy: frame-ancestors https://amd.digitalocean.com/ https://amd.s2r1.internal.digitalocean.com/ https://localdev.internal.digitalocean.com https://cloud.s2r1.internal.digitalocean.com https://cloud.digitalocean.com https://digitaloceaninc.lookbookhq.com
x-content-security-policy: frame-ancestors https://amd.digitalocean.com/ https://amd.s2r1.internal.digitalocean.com/ https://localdev.internal.digitalocean.com https://cloud.s2r1.internal.digitalocean.com https://cloud.digitalocean.com https://digitaloceaninc.lookbookhq.com
x-do-app-origin: 66b87bdb-ceab-4f7c-975f-da2affb6d13a
cache-control: private
x-do-orig-status: 200
cf-cache-status: DYNAMIC
set-cookie: __cf_bm=bGnZ6ZguGW2xMU4ZPSMvPd79S4LZXN_VP3rpKOPrQeI-1752803780-1.0.1.1-iaPpHtUam1C.4R1PYM.2LOdQk3sVaFw9Md4hEExYoPIbaaAmmtcYU98nXyZ62skOY8DmAtGwm46EBUtZMRQ3LY_7qrff5k0m.raNGZ5YgVk; path=/; expires=Fri, 18-Jul-25 02:26:20 GMT; domain=.ondigitalocean.app; HttpOnly; Secure; SameSite=None
server: cloudflare
cf-ray: 960e5cad3ee4c181-BLR
content-encoding: gzip
doctl kubernetes cluster list | DigitalOcean Documentation
doctl kubernetes cluster list
Generated on 23 Jun 2025
from doctl version
v1.131.0
Usage
doctl kubernetes cluster list [flags]Aliases
lsDescription
Retrieves the following details about all Kubernetes clusters that are on your account:
- A unique ID for the cluster
- A human-readable name for the cluster
- The slug identifying the region where the Kubernetes cluster is located
- The slug identifying the cluster’s Kubernetes version. If set to a minor version, the latest patch version for that minor version is returned. For example, if the cluster is set to
1.14, the command would return1.14.6-do.1. If it is set tolatest, the latest published version is used. - A boolean value indicating whether the cluster automatically upgrades to new patch releases during its maintenance window.
- An object containing a “state” attribute whose value is set to a string indicating the current status of the node. Potential values:
running,provisioning,errored.- A list of node pools available inside the cluster
Example
The following example retrieves the list of Kubernetes clusters for your account and uses the --format flag to return only the name and endpoint for each cluster:
doctl kubernetes cluster list --format Name,EndpointFlags
| Option | Description |
|---|---|
--format |
Columns for output in a comma-separated list. Possible values: ID, Name, Region, Version, AutoUpgrade, HAControlPlane, Status, Endpoint, IPv4, ClusterSubnet, ServiceSubnet, Tags, Created, Updated, NodePools, Autoscaler.UtilizationThreshold, Autoscaler.UnneededTime, Autoscaler.Expanders, RoutingAgent. |
--help, -h |
Help for this command |
--no-header |
Return raw data with no headers Default: false |
Related Commands
| Command | Description |
|---|---|
| doctl kubernetes cluster | Display commands for managing Kubernetes clusters |
Global Flags
| Option | Description |
|---|---|
--access-token, -t |
API V2 access token |
--api-url, -u |
Override default API endpoint |
--config, -c |
Specify a custom config file Default: |
--context |
Specify a custom authentication context name |
--http-retry-max |
Set maximum number of retries for requests that fail with a 429 or 500-level error
Default: 5 |
--http-retry-wait-max |
Set the minimum number of seconds to wait before retrying a failed request
Default: 30 |
--http-retry-wait-min |
Set the maximum number of seconds to wait before retrying a failed request
Default: 1 |
--interactive |
Enable interactive behavior. Defaults to true if the terminal supports it (default false)
Default: false |
--output, -o |
Desired output format [text|json] Default: text |
--trace |
Show a log of network activity while performing a command Default: false |
--verbose, -v |
Enable verbose output Default: false |
We can't find any results for your search.
Try using different keywords or simplifying your search terms.