[Yandex Cloud documentation](../../../index.md) > [Yandex Compute Cloud](../../index.md) > [Step-by-step guides](../index.md) > File storages > Updating a file storage

# Updating a file storage

After creating a [file storage](../../concepts/filesystem.md), you can change its name, description, and size.

{% note info %}

To resize a file storage, you can only use the [CLI](../../../cli/index.md) or API. You can only increase the storage size. Reducing it is not supported.

{% endnote %}

{% list tabs group=instructions %}

- Management console {#console}

  1. In the [management console](https://console.yandex.cloud), select the [folder](../../../resource-manager/concepts/resources-hierarchy.md#folder) where your file storage resides.
  1. Navigate to **Compute Cloud**.
  1. In the left-hand panel, select ![image](../../../_assets/console-icons/nodes-right.svg) **File storages**.
  1. In the line with the file storage, click ![image](../../../_assets/console-icons/ellipsis.svg) and select **Edit**.
  1. Update the file storage parameters, e.g., rename the storage by editing the **Name** field.

     {% note info %}

     To resize a file storage, you can only use the CLI or API.

     {% endnote %}

  1. Click **Save**.

- CLI {#cli}

  If you do not have the Yandex Cloud CLI yet, [install and initialize it](../../../cli/quickstart.md#install).

  The folder used by default is the one specified when [creating](../../../cli/operations/profile/profile-create.md) the CLI profile. To change the default folder, use the `yc config set folder-id <folder_ID>` command. You can also specify a different folder for any command using `--folder-name` or `--folder-id`. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

  1. See the description of the CLI command for updating a file storage:
     * To change the name, description, or size:

       ```bash
       yc compute filesystem update --help
       ```

     * To resize:

       ```bash
       yc compute filesystem resize --help
       ```

  1. Get a list of available file storages:

     ```bash
     yc compute filesystem list --format yaml
     ```

     Result:

     ```text
     - id: epd0u6h8lh41********
       folder_id: b1g86q4m5vej********
       created_at: "2022-04-26T16:59:19Z"
     ...
       size: "1073741824"
       block_size: "4096"
       status: READY
     ```

  1. Update the storage parameters by specifying the storage `--id` or `--name` value in your command. For example, update the following:
     * Name and description:

       ```bash
       yc compute filesystem update \
         --name storage-1 \
         --new-name storage-3 \
         --description vm-storage
       ```

       Result:

       ```text
       id: epd5g123c8hk********
       folder_id: b1g86q4m5vej********
       created_at: "2022-04-26T16:37:30Z"
       ...
       size: "1073741824"
       block_size: "4096"
       status: READY
       ```

     * Size:

       ```bash
       yc compute filesystem resize \
         --name storage-1 \
         --size 2GB
       ```

       Result:

       ```text
       id: epd5g123c8hk********
       folder_id: b1g86q4m5vej********
       created_at: "2022-04-26T16:37:30Z"
       ...
       size: "2147483648"
       block_size: "4096"
       status: READY
       ```

- Terraform {#tf}

  If you do not have Terraform yet, [install it and configure the Yandex Cloud provider](../../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform).
  
  
  To manage infrastructure using Terraform under a service account or user accounts (a Yandex account, a federated account, or a local user), [authenticate](../../../terraform/authentication.md) using the appropriate method.

  1. Open the Terraform configuration file and edit the section specifying the file storage:

     {% cut "Example of specifying a file storage in Terraform configuration" %}

     ```hcl
     ...
     resource "yandex_compute_filesystem" "default" {
       name  = "fs-name"
       type  = "network-ssd"
       zone  = "ru-central1-a"
       size  = 150
     }
     ...
     ```

     {% endcut %}

  1. Apply the changes:

     1. In the terminal, navigate to the configuration file directory.
     1. Make sure the configuration is correct using this command:
     
        ```bash
        terraform validate
        ```
     
        If the configuration is valid, you will get this message:
     
        ```bash
        Success! The configuration is valid.
        ```
     
     1. Run this command:
     
        ```bash
        terraform plan
        ```
     
        You will see a list of resources and their properties. No changes will be made at this step. Terraform will show any errors in the configuration.
     1. Apply the configuration changes:
     
        ```bash
        terraform apply
        ```
     
     1. Type `yes` and press **Enter** to confirm the changes.

  You can check the file storage updates and settings using the [management console](https://console.yandex.cloud) or this CLI command:

  ```bash
  yc compute filesystem get <file_storage_name>
  ```

- API {#api}

  Use the [update](../../api-ref/Filesystem/update.md) REST API method for the [Filesystem](../../api-ref/Filesystem/index.md) resource or the [FilesystemService/Update](../../api-ref/grpc/Filesystem/update.md) gRPC API call.

{% endlist %}