This section describes some of the most commonly used Manila API calls and their corresponding CLI commands. It is not meant to be a comprehensive list that is representative of all functionality present in Manila; for more information, please refer to the help text from running manila help.
Table 6.1, “Manila API Overview - Share” specifies the valid operations that can be performed on Manila shares. Please note that Manila shares are identified as CLI command arguments by either their names or UUID.
| Operation | CLI Command | Description |
| Create | manila create | Create a Manila share of specified size; optional name, availability zone, share type, share network, source snapshot |
| Delete | manila delete | Delete an existing Manila share; the manila force-delete command may be required if the Manila share is in an error state |
| Edit | manila metadata | Set or unset metadata on a Manila share |
| List | manila list | List all Manila shares |
| Show | manila show | Show details about a Manila share |
Table 6.2, “Manila API Overview - Share Access” specifies the valid access operations that can be performed on Manila shares. Please note that Manila shares are identified as CLI command arguments by either their names or UUID.
| Operation | CLI Command | Description |
| Allow | manila access-allow | Allow access to the specified share for the specified access type and value (IP address or IP network address in CIDR notation or Windows user name). |
| Deny | manila access-deny | Deny access to the specified share for the specified access type and value (IP address or IP network address in CIDR notation or Windows user name). |
| List | manila access-list | List all Manila share access rules |
Table 6.3, “Manila API Overview - Snapshot” specifies the valid operations that can be performed on Manila snapshots. Please note that Manila snapshots are identified as CLI command arguments by either their display name or UUID.
| Operation | CLI Command | Description |
| Create | manila snapshot-create | Create a Manila snapshot of a specific Manila share |
| Delete | manila snapshot-delete | Delete a Manila snapshot |
| List | manila snapshot-list | List all Manila snapshots |
| Rename | manila snapshot-rename | Change the display-name of a Manila snapshot |
| Reset State | manila snapshot-reset-state | Reset the state of a Manila snapshot |
| Show | manila snapshot-show | Show details about a Manila snapshot |
Table 6.4, “Manila API Overview - Share Type” specifies the valid operations that can be performed on Manila share types. Please note that Manila share types are identified as CLI command arguments by either their display name or UUID. Creation or deletion of share types normally requires administrative privileges.
| Operation | CLI Command | Description |
| Create | manila type-create | Create a Manila share type |
| Delete | manila type-delete | Delete a Manila share type |
| List | manila type-list | List existing Manila share type |
Table 6.5, “Manila API Overview - Share Type Extra Specs” specifies the valid operations that can be performed on Manila share type extra specs. Please note that Manila share type extra specs are properties of Manila share types and are identified by their parent object. Modifying extra specs or viewing the contents of a share type normally requires administrative privileges.
| Operation | CLI Command | Description |
| List extra specs | manila extra-specs-list | Print the values of extra specs assigned to Manila share types |
| Set extra specs | manila type-key stype set |
Assign extra specs to Manila share type |
| Unset extra specs | manila type-key stype unset |
Remove extra specs from Manila share type |
