# pw buckets ls

> Source: https://parallelworks.com/docs/cli/pw/buckets/ls

## pw buckets ls

List buckets or files

### Synopsis

The **pw buckets ls** command can be used with or without arguments.

When no arguments are provided, all buckets are listed.

If you provide a namespace, all buckets in that namespace will be listed.
If you provide a namespace and bucket name, the files in the bucket will be listed.

You can list individual directories in the bucket by providing the full path to the directory.

This command also supports using the same CSP URI format accepted by CSP CLIs. For more information about URIs, please see [this section](/docs/cli#about-uris).

```
pw buckets ls [bucketURI] [flags]
```

### Examples

```
  # List all buckets
  pw buckets ls
  
  # List all buckets in a namespace
  pw buckets ls pw://[namespace]
  
  # List files in a bucket
  pw buckets ls pw://[namespace]/[bucket]
  
  # List files in a bucket, using the AWS URI format
  pw buckets ls s3://[aws-bucket-name]
  
  # List files in a bucket, using the Google URI format
  pw buckets ls gs://[google-bucket-name]
  
  # List files in a bucket, using the Azure URI format
  pw buckets ls https://[azure-bucket-name].blob.core.windows.net/[azure-bucket-name]
  
  # List all buckets you have access to, displayed as a table
  # Tables display URI, CSP, provisioning status, and CSP URI
  pw buckets ls -o table
  
  # List currently provisioned buckets with csp URIs
  pw buckets ls --csp-uris
```

### Options

```
      --csp-uris               Show CSP URIs
  -h, --help                   help for ls
  -o, --output OUTPUT_FORMAT   Output format. One of: list, json, table (default table)
```

### Options inherited from parent commands

```
      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Will override any other platform host settings.
  -v, --verbose                Enable verbose logging
```

### SEE ALSO

* [pw buckets](/docs/cli/pw/buckets)	 - Manage cloud buckets