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:
-
En la consola IBM Cloud, haga clic en el
del menú de navegación >
de infraestructura > Almacenamiento > Recursos compartidos de almacenamiento de archivos.
-
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.
-
En la página de detalles de las unidades compartidas de archivos, expanda el menú Acciones.
-
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.
-
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.
-
Revise el resumen de pedido mensual estimado para su geografía y los nuevos precios.
-
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.
-
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
-
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 -
-
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: