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

Amplía la capacidad de uso compartido de archivos de « File Storage for VPC » hasta 32 000 GB sin tiempo de inactividad ni migración de datos. La facturación se actualiza automáticamente para reflejar la nueva capacidad.

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. Puedes utilizar la interfaz de usuario, la línea de comandos, la API o Terraform para aumentar la capacidad de los recursos compartidos. Puedes ampliar un recurso compartido de archivos varias veces hasta alcanzar su límite de capacidad máxima. 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.

Seleccionar disponibilidad Los recursos compartidos de archivos regionales que se crean con el perfil rfs, se pueden aumentar hasta 32 TB sin restricciones.

Los archivos compartidos zonales que se crean con el perfil personalizado dp2 o el perfil personalizado Deprecated pueden ampliarse dentro del rango de IOPS permitido para ese tamaño de recurso compartido de archivos.

Los archivos compartidos zonales que se crean con uno de los perfiles de nivel de IOPS Deprecated pueden ampliarse hasta el tamaño máximo para 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.

El IOPS se ajusta automáticamente para los perfiles de recursos compartidos de archivos por niveles, que han quedado obsoletos, en función del tamaño del recurso compartido de archivos. 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 recurso compartido de archivos de 5 IOPS/GB puede llegar a alcanzar los 9.600 GB, el número máximo de IOPS se ajusta a 48.000 IOPS. La capacidad y las IOPS se modifican de forma inmediata, sin necesidad de 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 puedes consultar los eventos de seguimiento de actividades para comprobar que se ha ampliado el recurso compartido de archivos. Una vez ampliada una unidad compartida de archivos, no es posible reducir su capacidad.

Requisitos

El recurso compartido de archivos debe estar en estado « stable » antes de que puedas solicitar que se aumente su 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, solo 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.
  • Aumentar el IOPS 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. El IOPS se ajusta al ampliar 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.
  • El número máximo de IOPS para un recurso compartido de archivos zonal está limitado a 48 000 IOPS si el acceso lo realiza un único host. En el caso de un recurso compartido de archivos por zonas 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

Sigue estos pasos para ampliar la capacidad de los recursos 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 «Ampliar el tamaño del recurso compartido de archivos» muestra el tamaño actual del recurso compartido de archivos (en GB) 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 es posible reducir el tamaño del recurso compartido de archivos una vez que se haya ampliado 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
    
 ```sh {: screen}
 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              -
 Allowed Access Protocols     nfs4
 Availability Mode            zonal
 Bandwidth(Mbps)              1
 Storage Generation           1
  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              -
Allowed Access Protocols     nfs4
Availability Mode            zonal
Bandwidth(Mbps)              1
Storage Generation           1

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

Ampliar la capacidad de uso compartido de 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: Bearer $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 está actualizando.

{
  "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,
  .
  .
  .
}

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: