File Store CLI

The evroc CLI provides commands for managing File Store instances. This reference covers the available commands and their usage.

Prerequisites

Before you use the File Store CLI commands, you'll need:

  • The evroc CLI installed and configured. See Install the evroc CLI for setup instructions
  • An evroc account with appropriate IAM permissions for evroc Storage
  • A project and region selected

File Store commands

All File Store commands are accessed through the storage filestore subcommand (alias: fs).

List File Stores

Display all File Stores in your current project and region.

evroc storage filestore list

Output:

my-filestore
my-other-filestore

Get detailed output:

evroc storage filestore list -o yaml

Filter by label:

evroc storage filestore list --label-selector "env=production"

Create a File Store

Create a new File Store in a specified zone.

evroc storage filestore create <filestore-id> --zone <zone>

Example:

# Create a File Store in zone se-sto-a
evroc storage filestore create my-filestore --zone se-sto-a

Output:

created

Constraints:

  • File Store IDs must be unique within your project and region
  • IDs can only contain lowercase letters, numbers, and hyphens
  • IDs must start with a letter
  • Maximum length: 63 characters

Get File Store details

Retrieve detailed information about a specific File Store.

evroc storage filestore get <filestore-id>

Example:

evroc storage filestore get my-filestore

Output:

kind: FileStore
apiVersion: storage/v1
metadata:
  id: my-filestore
  uid: 8f4e2c9d-1a3b-4c5d-6e7f-8a9b0c1d2e3f
  project: my-project
  region: se-sto
spec:
  protocol: NFS
  placement:
    zone: se-sto-a
  nfs:
    version: V4.1
status:
  status: Available
  protocol: NFS
  nfs:
    version: V4.1
    endpoint: 10.100.0.10
    exportPath: /
  placement:
    zone: se-sto-a
  conditions:
    - type: Ready
      status: "True"
      reason: Ready
      message: FileStore is ready for use
      lastTransitionTime: "2026-05-19T10:30:00Z"

Delete a File Store

Delete a File Store and all its data.

Warning: This action permanently deletes all data stored in the File Store. It can't be undone.

evroc storage filestore delete <filestore-id>

Example:

evroc storage filestore delete my-filestore

Confirmation:

Are you sure (y/n)?
y
<filestore-id> deletion requested

To skip confirmation:

evroc storage filestore delete my-filestore --force

Label management

Add or remove labels on File Stores.

Add labels:

evroc storage filestore label my-filestore -a env=production -a team=backend

Output:

updated

Remove labels:

evroc storage filestore label my-filestore -r team -r env

Output:

updated

Add and remove labels in one operation:

evroc storage filestore label my-filestore -a env=staging -r team

Output:

updated

Note: You must specify at least one label to add (-a) or remove (-r).

Common workflows

Create and verify a File Store

# Create the File Store
evroc storage filestore create my-store --zone se-sto-a

# Verify it's ready
evroc storage filestore get my-store

List with filters

# List all File Stores
evroc storage filestore list

# List only File Stores with specific label
evroc storage filestore list --label-selector "env=production"

Clean up multiple File Stores

# List all File Stores
evroc storage filestore list

# Delete specific File Stores
evroc storage filestore delete my-store-1 --force
evroc storage filestore delete my-store-2 --force

Output formats

The CLI supports different output formats:

JSON:

evroc storage filestore get my-filestore -o json

YAML:

evroc storage filestore get my-filestore -o yaml

List (default for list command):

# Returns a simple list of File Store IDs
evroc storage filestore list

YAML (for detailed list output):

evroc storage filestore list -o yaml

Troubleshooting CLI issues

Authentication errors

If you see authentication errors:

# Log in again
evroc login

# Check current profile
evroc config current-profile

File Store not found

If you get "not found" errors:

  • Verify the File Store ID is correct
  • Ensure you're in the correct project and region
  • Check that the File Store hasn't been deleted
# Check current context
evroc config current-project
evroc config current-profile

# List all File Stores to verify the ID
evroc storage filestore list

Permission denied

If you see permission errors, ensure your IAM user has the filestore permission set:

# Check your permissions
evroc iam permissionset list

Required permissions:

  • storage.filestores.get
  • storage.filestores.list
  • storage.filestores.create
  • storage.filestores.delete
  • storage.filestores.update

See Also