Parallel Works
View as Markdown
Share:

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.

Files are listed as a table of URI, size in bytes, and modified time. Use -o list for one URI per line, which is the form to pipe into other commands, or -o json for the same fields as structured output.

pw buckets ls [bucketURI] [flags]

Examples

  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 the first 10 files in a bucket
  pw buckets ls --limit 10 s3://[aws-bucket-name]
  
  # List files as one URI per line, for piping
  pw buckets ls -o list s3://[aws-bucket-name]
  
  # List files with their size and modified time as JSON
  pw buckets ls -o json s3://[aws-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
      --limit int              Maximum number of results to list. Lists everything when unset
  -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. Overrides PW_PLATFORM_HOST environment variable and the current context's server.
  -v, --verbose                Enable verbose logging

SEE ALSO