Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gns3util.saygex.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
gns3util cluster-control object-store create-bucket

Create a new bucket in the filestore

​
Synopsis

Create a new bucket in the cluster filestore. The authenticated user becomes the bucket owner automatically. Only the owner can delete the bucket. Use —public to make the bucket readable without a token, and —required-scopes to gate access to a specific JWT scope string. Requires ACTION_WRITE:RESOURCE_FILES scope on the cluster. 
gns3util cluster-control object-store create-bucket <name> [flags]

​
Examples

  gns3util ctl object-store create-bucket my-bucket -c mycluster
  gns3util ctl obj create-bucket shared --public -c mycluster
  gns3util ctl obj create-bucket private --required-scopes "write:files" -c mycluster

​
Options

      --filestore-id string      Specific filestore node ID (optional when only one filestore exists)
  -h, --help                     help for create-bucket
      --public                   Make the bucket publicly readable without a token
      --required-scopes string   JWT scope string required to access files in this bucket

​
Options inherited from parent commands

  -c, --cluster string      Cluster name from keyfile. Mutually exclusive with --server
  -i, --insecure            Ignore unsigned SSL-Certificates. Can be set via GNS3_INSECURE
  -k, --key-file string     Path to authentication keyfile. Can be set via GNS3_KEY_FILE or config.toml
  -o, --output string       Output format: [json, json-colorless, collapsed, yaml, toml, table, table-ascii]. Can be set via GNS3_OUTPUT (default "table")
  -s, --server string       GNS3v3 Server URL. Can be set via GNS3_SERVER or config.toml
      --user string[="~"]   User to select from the keyfile. Omit the value to open a fuzzy picker (--user), or pass a name (--user alice).

​
SEE ALSO

Auto generated by spf13/cobra on 9-May-2026