API Overview

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.

 Share API

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.

Table 6.1. Manila API Overview - Share
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
Extend manila extend Increase the size of a Manila share
List manila list List all Manila shares
Manage manila manage Bring an existing storage object under Manila management
Show manila show Show details about a Manila share
Shrink manila shrink Decrease the size of a Manila share
Unmanage manila unmanage Cease management of an existing Manila share without deleting the backing storage object

 Share Access API

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.

[Warning]Warning

Please refer to the caveat as explained in the section called “Share Access Rules”.

Table 6.2. Manila API Overview - Share Access
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

 Share Export Location API

Table 6.3, “Manila API Overview - Share Export Location” specifies the operations that can be performed to get export locations of Manila shares. Please note that Manila shares are identified as CLI command arguments by either their names or UUID. There may be multiple export locations for a given share, at least one of which should be listed as preferred; clients should use the preferred path for optimum performance.

Table 6.3. Manila API Overview - Share Export Location
Operation CLI Command Description
List manila share-export-location-list List export locations of the specified share.
Show manila share-export-location-show Show details for a specific export location.

 Snapshot API

Table 6.4, “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.

Table 6.4. Manila API Overview - Snapshot
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

 Share Type API

Table 6.5, “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.

Table 6.5. Manila API Overview - Share Type
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

 Share Type Extra Specs API

Table 6.6, “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.

Table 6.6. Manila API Overview - Share Type Extra Specs
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

 Consistency Group API

Table 6.7, “Manila API Overview - Consistency Groups”

Table 6.7. Manila API Overview - Consistency Groups
Operation CLI Command Description
Create manila cg-create Create a Manila consistency group
Delete manila cg-delete Delete a Manila consistency group
List manila cg-list List all Manila consistency groups
Reset state manila cg-reset-state Update the state of a Manila consistency group
Show manila cg-show Show details about a Manila consistency group
Update manila cg-update Update details of a Manila consistency group
Create CG Snapshot manila cg-snapshot-create Create a snapshot of a consistency group and all of it's shares
Delete CG Snapshot manila cg-snapshot-delete Delete a snapshot of a consistency group
List CG Snapshot manila cg-snapshot-list List all consistency group snapshots
Show CG Snapshot members manila cg-snapshot-members Get member details for a consistency group snapshot.
Reset CG Snapshot state manila cg-snapshot-reset-state Update the state of a Manila consistency group snapshot
Show CG Snapshot manila cg-snapshot-show Show details about a consistency group snapshot.
Update CG Snapshot manila cg-snapshot-update Update details of a consistency group snapshot.

 Share Replication API

Table 6.8, “Manila API Overview - Share Replication”

Table 6.8. Manila API Overview - Share Replication
Operation CLI Command Description
Create Share Replica manila share-replica-create Create a Manila share replica.
Delete manila share-replica-delete Delete a Manila share replica.
List manila share-replica-list List all Manila Share replicas.
Show manila share-replica-show Show detailed information for the specified replica.
Promote manila share-replica-promote Change the specified replica to the ACTIVE replica for the share.
Resync manila share-replica-resync Tell Manila to initiate an update for the replica.
Reset Replica Status manila share-replica-reset-state Update the status attribute of a replica.
Reset Replication State manila share-replica-reset-replica-state Update the replica_state attribute of a replica.


loading table of contents...