doctl vpcs list

Go to Navigation


doctl vpcs list [flags]




Retrieves a list of the VPCs on your account, including the following information for each:

  • The VPC network’s ID
  • The uniform resource name (URN) for the VPC network
  • The VPC network’s name
  • The VPC network’s description
  • The range of IP addresses in the VPC network, in CIDR notation
  • The datacenter region slug the VPC network is located in
  • The VPC network’s default boolean value indicating whether or not it is the default one for the region
  • The VPC network’s creation date, in ISO8601 combined date and time format


The following example lists the VPCs on your account and uses the –format flag to return only the name, IP range, and region for each VPC network:

doctl vpcs list --format Name,IPRange,Region


Option Description
--format Columns for output in a comma-separated list. Possible values: ID, URN, Name, Description, IPRange, Region, Created, Default.
--help , -h Help for this command
--no-header Return raw data with no headers
Default: false
Command Description
doctl vpcs Display commands that manage VPCs

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
  • macOS: ${HOME}/Library/Application Support/doctl/config.yaml
  • Linux: ${XDG_CONFIG_HOME}/doctl/config.yaml
  • Windows: %APPDATA%\doctl\config.yaml
--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