IBM Cloud Docs
Ampliación de la capacidad de la unidad compartida de archivos

Ampliación de la capacidad de la unidad compartida de archivos

En el caso de las unidades compartidas de archivos de File Storage for VPC, puede aumentar el tamaño de la unidad compartida de archivos con respecto a su capacidad original en incrementos de GB, hasta alcanzar 32.000 GB de capacidad, en función del perfil de la unidad compartida de archivos. Este proceso no requiere que se realicen pasos manuales. Por ejemplo, no es necesario migrar los datos a una unidad compartida de archivos más grande. La operación de expansión no provoca ninguna parada ni falta de acceso al almacenamiento.

La facturación de la unidad compartida de archivos se actualiza automáticamente para añadir la diferencia prorrateada del nuevo precio al ciclo de facturación actual. El nuevo importe completo se factura en el siguiente ciclo de facturación.

Nociones sobre las unidades compartidas de archivos ampliables

Puede aumentar la capacidad de la unidad compartida de archivos. El tamaño de la unidad compartida de archivos no puede ser menor que el tamaño actual de la unidad compartida de archivos.

Es posible aumentar la capacidad de las unidades compartidas de archivos que se encuentran en estado stable. La autorización de usuario se verifica antes de que se expanda la compartición de archivos. Puede utilizar la interfaz de usuario, la CLI, la API o Terraform para aumentar la capacidad de uso compartido de archivos. Puedes ampliar un archivo compartido varias veces hasta su límite máximo de capacidad. Después de expandir la compartición de archivos, no puede reducir la capacidad.

La capacidad ampliada depende del máximo permitido por el perfil de la unidad compartida de archivos. Las comparticiones de archivos que se crean a partir de un perfil Personalizado o un perfil dp2 se pueden expandir dentro del rango de IOPS permitido para dicho tamaño de compartición de archivos.

Las unidades compartidas de archivos que se crean a partir de un perfil de nivel de IOPS se pueden ampliar hasta el tamaño máximo de su nivel de IOPS:

  • Un perfil de propósito general de 3 IOPS/GB puede ampliarse hasta 32.000 GB.
  • Un perfil de 5 IOPS/GB puede ampliarse hasta 9.600 GB.
  • Un perfil de 10 IOPS/GB puede ampliarse hasta 4.800 GB.

Las IOPS se ajustan automáticamente para los perfiles de archivos compartidos por niveles, en función del tamaño del archivo compartido. Por ejemplo, si expande una compartición con un perfil de 5 IOPS/GB de 250 GB a 1.000 GB, tiene un IOPS máximo de 5.000 IOPS (1.000 GB de capacidad x 5 IOPS). Dado que un archivo compartido de 5 IOPS/GB puede ampliarse potencialmente a 9.600 GB, la IOPS máxima se ajusta a 48.000 IOPS. La capacidad y las IOPS cambian inmediatamente y no es necesario reiniciar la instancia.

Puede supervisar el progreso de ampliación de la unidad compartida de archivos desde la interfaz de usuario o la CLI. También puede comprobar los eventos de seguimiento de actividad para verificar que el recurso compartido de archivos se expandió. Una vez ampliada una unidad compartida de archivos, no es posible reducir su capacidad.

Requisitos

El archivo compartido debe estar en un estado stable antes de que pueda solicitar que se aumente la capacidad.

Limitaciones

En este release, se aplican las limitaciones siguientes.

  • Las unidades compartidas de archivos se pueden ampliar, con las siguientes restricciones:
    • Si el recurso compartido de archivos se creó con un perfil por niveles que limita la capacidad a menos de 32.000 GB, sólo podrá ampliarse hasta la capacidad permitida para ese nivel.
    • Si el recurso compartido de archivos se creó con el perfil Personalizado en un intervalo de IOPS que no permite la ampliación a 16.000 GB, el recurso compartido sólo podrá ampliarse hasta la capacidad máxima del intervalo especificado.
    • Si el recurso compartido de archivos se creó con el perfil dp2 en un intervalo de IOPS que no permite la ampliación a 32.000 GB, el recurso compartido sólo podrá ampliarse hasta la capacidad máxima del intervalo especificado.
    • Las unidades compartidas de archivos pueden ampliarse varias veces hasta que se alcanza la capacidad máxima.
  • Las IOPS aumentan hasta el máximo permitido por el perfil.
  • No puede modificar IOPS independientemente para una compartición de archivos que se ha creado a partir de un perfil de nivel de IOPS. Las IOPS se ajustan cuando se amplía la capacidad.
  • Cuando expande una compartición de archivos que se ha creado a partir de un perfil personalizado o dp2, la capacidad aumenta, pero el IOPS sigue siendo el mismo a menos que elija ajustar el IOPS.
  • Beta Cuando se amplía un archivo compartido creado con el perfil rfs, se incrementan la capacidad y el ancho de banda mínimo.
  • El máximo de IOPS para un archivo compartido zonal está limitado a 48.000 IOPS si es accedido por un único host. En el caso de un archivo compartido zonal al que acceden varios hosts, las IOPS pueden alcanzar hasta 96.000 IOPS.
  • Tras ampliar una unidad compartida de archivos, no se puede reducir su tamaño.

Ampliación de la capacidad de archivos compartidos en la consola

Siga estos pasos para ampliar la capacidad de archivos compartidos en la consola:

  1. En la consola IBM Cloud, haga clic en el ícono del menú de navegación > ícono de VPC de infraestructura > Almacenamiento > Recursos compartidos de almacenamiento de archivos.

  2. En la página de lista Comparticiones de archivos para VPC, se muestran todas las comparticiones de archivos que se han creado en esa zona. Pulse el nombre de una unidad compartida de archivos para ver la página de detalles.

  3. En la página de detalles de las unidades compartidas de archivos, expanda el menú Acciones.

  4. Seleccione Ampliar unidad compartida de archivos. El panel Expandir tamaño del archivo compartido muestra el tamaño actual del archivo compartido (en GBs), y el perfil al que está asociado. De forma alternativa, también puede pulsar el icono de edición situado junto a la información de tamaño de compartición de archivos.

  5. Especifique un tamaño mayor para la unidad compartida de archivos, basado en el máximo permitido para el perfil de unidad compartida de archivos. El valor predeterminado es el tamaño actual + 1 GB.

  6. Revise el resumen de pedido mensual estimado para su geografía y los nuevos precios.

  7. Si está satisfecho, pulse Guardar y continuar.

La nueva asignación de almacenamiento de archivos estará disponible en cuestión de minutos. Si sus requisitos cambian, puede aumentar la capacidad de nuevo tras aumentar el tamaño de la unidad compartida de archivos, siempre que se encuentre en estado stable.

No puedes cambiar el archivo compartido a un tamaño menor después de ampliar su capacidad.

Expansión de comparticiones de archivos desde la CLI

Para aumentar la capacidad de una compartición de archivos desde la CLI, utilice el mandato share-update con la opción --size e indique el nuevo tamaño de la compartición de archivos en GB.

  1. Localice la compartición desde la CLI listando las compartición de archivos en la región con el mandato ibmcloud is shares.

    ibmcloud is shares
    
    Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
    ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size   
    r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0   
    r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0   
    r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0   
    r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0   
    r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0   
    r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0   
    
  2. Vea los detalles de la compartición de archivos que desea modificar con el mandato ibmcloud is share.

 ibmcloud is share my-file-share
Getting file share my-file-share under account Test Account as user test.user@ibm.com...

ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   
Name                         my-file-share   
CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   
Lifecycle state              stable   
Access control mode          security_group   
Accessor binding role        none   
Zone                         us-south-2   
Profile                      dp2   
Size(GB)                     1000   
IOPS                         1000
User Tags                    docs:test
Encryption                   provider_managed   
Mount Targets                ID                                          Name
                             r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1      

Resource group               ID                                 Name      
                             db8e8d865a83e0aae03f25a492c5b39e   Default      

Created                      2023-10-18T22:15:15+00:00   
Replication role             none   
Replication status           none   
Replication status reasons   Status code   Status message      
                             -             -      

Snapshot count               0
Snapshot size                0  
Source snapshot              -        

  1. Ejecute el mandato ibmcloud is share-update para aumentar la capacidad de la compartición de archivos.

    ibmcloud is share-update my-file-share --size 1500
    
    Updating file share my-file-share under account Test Account as user test.user@ibm.com...
    
    ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   
    Name                         my-file-share   
    CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   
    Lifecycle state              updating   
    Access control mode          security_group  
    Accessor binding role        none  
    Zone                         us-south-2   
    Profile                      dp2   
    Size(GB)                     1500   
    IOPS                         1000   
    Encryption                   provider_managed   
    Mount Targets                ID                                          Name      
                                 r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1      
    
    Resource group               ID                                 Name      
                                 db8e8d865a83e0aae03f25a492c5b39e   Default      
    
    Created                      2023-10-18T22:15:15+00:00   
    Latest job                   Job status   Job status reasons      
                                 succeeded    -      
    
    Replication share            ID                                          Name               Resource type      
                                 r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share   share      
    
    Replication role             source   
    Replication status           active   
    Replication status reasons   Status code   Status message      
                                 -             -      
    
    Snapshot count               0
    Snapshot size                0
    Source snapshot              -
    
    

Para obtener más información sobre las opciones de mandato, consulte ibmcloud is share-update my-file-share.

Ampliar la capacidad de compartir archivos con la API

Puede ampliar las unidades compartidas de archivos existentes mediante una llamada a la API de VPC. Realice una solicitud PATCH /shares/{id} y especifique el ID de la unidad compartida de archivos cuyo tamaño quiera aumentar.

Este ejemplo de solicitud amplía una unidad compartida de archivos con una capacidad de 50 GB hasta los 2500 GB para un perfil de 5 IOPS/GB.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2" \
 -H "Authorization: $iam_token" \
 -d '{
      "size": 2500
    }'

La unidad compartida de archivos se encuentra en estado updating mientras se aumenta la capacidad. La capacidad actual se muestra mientras se actualiza.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "updating",
  "name": "share-name1",
    .
    .
	"size": 2500,
    .
    .
    .
}

Cuando se completa la ampliación de la unidad compartida de archivos, se muestra el nuevo valor y el estado pasa a ser stable.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "stable",
  "name": "share-name1",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
    "name": "dp2",
    "resource_type": "share_profile"
  },
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/875623bcde2b4ebda924d32640908845",
    "id": "875623bcde2b4ebda924d32640908845",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 2500,
  .
  .
  .
}

Los clientes con acceso especial para revisar la oferta de recursos compartidos de archivos regionales pueden utilizar la API Beta VPC para ampliar sus recursos compartidos de archivos regionales. Vea el ejemplo siguiente.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2025-07-22&generation=2&maturity=beta" \
 -H "Authorization: $iam_token" \
 -d '{
      "size": 2500
    }'

Expansión de comparticiones de archivos con Terraform

Para aumentar la capacidad de una compartición de archivos, utilice el recurso ibm_is_share. Cuando se aplica, el ejemplo siguiente actualiza la capacidad de compartición a 300 GB.

resource "ibm_is_share" "example" {
  name    = "my-new-share"
  size    = 300
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
}

Para obtener más información sobre los argumentos y atributos, consulte ibm_is_share.

Próximos pasos

Montar y utilizar las comparticiones de archivos: