# Resize share

For most drivers, resizing the share is safe operation. If you want to be sure that your data is safe, you can make a share back up by creating a snapshot of it.

You can extend and shrink the share with the openstack share resize command, and specify the share with the new size that does not exceed the quota. For details, see Quotas and Limits. You also cannot shrink share size to 0 or to a greater value than the current share size.

Note

From API version 2.53, extending a replicated share, manila quota system will reserve and consume resources for two additional quotas: `share_replicas` and `replica_gigabytes`. This request will fail if there is no available quotas to extend the share and all of its share replicas.

While extending, the share has an `extending` status. This means that the increase share size request was issued successfully.

To extend the share and check the result, run:

    $ openstack share resize docs_resize 2
    $ openstack share show docs_resize
    +---------------------------------------+---------------------------------------+
    | Property                              | Value                                 |
    +---------------------------------------+---------------------------------------+
    | id                                    | a3454cf1-bb1d-4e4d-a8e4-a3881c593720  |
    | size                                  | 2                                     |
    | availability_zone                     | manila-zone-0                         |
    | created_at                            | 2024-09-26T14:53:18.153832            |
    | status                                | extending                             |
    | name                                  | docs_resize                           |
    | description                           | None                                  |
    | project_id                            | 1f31ee1c3e3c443bbf9aee5684456daa      |
    | snapshot_id                           | None                                  |
    | share_network_id                      | None                                  |
    | share_proto                           | NFS                                   |
    | metadata                              | {}                                    |
    | share_type                            | 303f0a73-711e-4beb-a4f7-a60acc1d588e  |
    | is_public                             | True                                  |
    | snapshot_support                      | True                                  |
    | task_state                            | None                                  |
    | share_type_name                       | default                               |
    | access_rules_status                   | active                                |
    | replication_type                      | None                                  |
    | has_replicas                          | False                                 |
    | user_id                               | b47d81c8c8c74ea3a7c13461f30ad5ed      |
    | create_share_from_snapshot_support    | True                                  |
    | revert_to_snapshot_support            | False                                 |
    | share_group_id                        | None                                  |
    | source_share_group_snapshot_member_id | None                                  |
    | mount_snapshot_support                | False                                 |
    | progress                              | 100%                                  |
    | is_soft_deleted                       | False                                 |
    | scheduled_to_be_deleted_at            | None                                  |
    | source_backup_id                      | None                                  |
    | share_server_id                       | None                                  |
    | host                                  | host@backend1#poolA                   |
    +---------------------------------------+---------------------------------------+

While shrinking, the share has a `shrinking` status. This means that the decrease share size request was issued successfully. To shrink the share and check the result, run:

    $ openstack share resize docs_resize 1
    $ openstack share show docs_resize
    +---------------------------------------+---------------------------------------+
    | Property                              | Value                                 |
    +---------------------------------------+---------------------------------------+
    | id                                    | a3454cf1-bb1d-4e4d-a8e4-a3881c593720  |
    | size                                  | 1                                     |
    | availability_zone                     | manila-zone-0                         |
    | created_at                            | 2024-09-26T14:53:18.153832            |
    | status                                | shrinking                             |
    | name                                  | docs_resize                           |
    | description                           | None                                  |
    | project_id                            | 1f31ee1c3e3c443bbf9aee5684456daa      |
    | snapshot_id                           | None                                  |
    | share_network_id                      | None                                  |
    | share_proto                           | NFS                                   |
    | metadata                              | {'__mount_options': 'fs=cephfs'}      |
    | share_type                            | 303f0a73-711e-4beb-a4f7-a60acc1d588e  |
    | is_public                             | True                                  |
    | snapshot_support                      | True                                  |
    | task_state                            | None                                  |
    | share_type_name                       | default                               |
    | access_rules_status                   | active                                |
    | replication_type                      | None                                  |
    | has_replicas                          | False                                 |
    | user_id                               | b47d81c8c8c74ea3a7c13461f30ad5ed      |
    | create_share_from_snapshot_support    | True                                  |
    | revert_to_snapshot_support            | False                                 |
    | share_group_id                        | None                                  |
    | source_share_group_snapshot_member_id | None                                  |
    | mount_snapshot_support                | False                                 |
    | progress                              | 100%                                  |
    | is_soft_deleted                       | False                                 |
    | scheduled_to_be_deleted_at            | None                                  |
    | source_backup_id                      | None                                  |
    | share_server_id                       | None                                  |
    | host                                  | host@backend1#poolA                   |
    +---------------------------------------+---------------------------------------+

this page last updated: 2026-04-22 07:00:00

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

found an error? report a bug