# Using OpenStack Shared File Systems

Before working with the Shared File System service, you’ll need to create a connection to your OpenStack cloud by following the Connect user guide. This will provide you with the `conn` variable used in the examples below.

## List Availability Zones

A Shared File System service availability zone is a failure domain for your shared file systems. You may create a shared file system (referred to simply as shares) in a given availability zone, and create replicas of the share in other availability zones.

## Share Instances

Administrators can list, show information for, explicitly set the state of, and force-delete share instances.

## Get Share Instance

Shows details for a single share instance.

## Reset Share Instance Status

Explicitly updates the state of a share instance.

## Delete Share Instance

Force-deletes a share instance.

## Resize Share

Shared File System shares can be resized (extended or shrunk) to a given size. For details on resizing shares, refer to the Manila docs.

## List Share Group Snapshots

A share group snapshot is a point-in-time, read-only copy of the data that is contained in a share group. You can list all share group snapshots

## Get Share Group Snapshot

Show share group snapshot details

## List Share Group Snapshot Members

Lists all share group snapshots members.

## Create Share Group Snapshot

Creates a snapshot from a share group.

## Reset Share Group Snapshot

Reset share group snapshot state.

## Update Share Group Snapshot

Updates a share group snapshot.

## Delete Share Group Snapshot

Deletes a share group snapshot.

## List Share Metadata

Lists all metadata for a given share.

## Get Share Metadata Item

Retrieves a specific metadata item from a shares metadata by its key.

## Create Share Metadata

Creates share metadata.

## Update Share Metadata

Updates metadata of a given share.

## Delete Share Metadata

Deletes a specific metadata item from a shares metadata by its key. Can specify multiple keys to be deleted.

## Manage Share

Manage a share with Manila.

## Unmanage Share

Unmanage a share from Manila.

this page last updated: 2026-01-16 23:06:19

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.