Ajuste de IOPS para un archivo compartido zonal

Ajusta los límites de operaciones de entrada/salida por segundo (IOPS) para los recursos compartidos de archivos zonales con el perfil « dp2 » de 100 a 96 000 IOPS sin interrupción del servicio.

Los cambios entran en vigor de inmediato sin interrupción del servicio. Puedes gestionar el límite de IOPS a través de la consola, la CLI, la API o Terraform.

La facturación de una compartición actualizada se actualiza automáticamente. La diferencia prorrateada del nuevo precio se añadirá al ciclo de facturación actual. El nuevo importe completo se factura en el siguiente ciclo de facturación.

Seleccione la disponibilidad No puede modificar el valor de IOPS de los recursos compartidos de archivos regionales que se crean con el perfil rfs. Sin embargo, puedes ajustar el valor del ancho de banda para afinar el rendimiento de la acción.

Conceptos de IOPS ajustables

Puedes ajustar las IOPS de tus recursos compartidos de archivos por zona para adaptar el rendimiento a tus necesidades.

Por ejemplo, es posible que te des cuenta de que una aplicación se ha ampliado de tal manera que el límite actual de IOPS se ha convertido ahora en un cuello de botella para el rendimiento. Puede cambiar las características de rendimiento del recurso compartido de archivos existente aumentando las IOPS.
En otro caso, es posible que quieras configurar inicialmente tu almacenamiento de archivos con un nivel de IOPS más alto para acelerar la carga de datos. Una vez finalizada la carga, puedes restablecer el almacenamiento a 5 IOPS/GB para el funcionamiento habitual. Asimismo, es posible que desee aumentar el valor de IOPS de la compartición de archivos durante las horas punta para su aplicación y disminuir el valor de IOPS durante las horas de menor actividad.

Cuando su recurso compartido utiliza el perfil dp2 perfil, las IOPS del recurso compartido pueden oscilar entre 100 y 96.000. Puede especificar su valor de IOPS con restricciones mínimas. El IOPS se puede ajustar varias veces hasta alcanzar el límite máximo o mínimo.

Para alcanzar las 96 000 IOPS, varias instancias de servidores virtuales deben acceder a un mismo recurso compartido de archivos. Un único recurso compartido de archivos al que acceda un solo cliente tiene un límite de 48 000 IOPS.

Cuando su recurso compartido de archivos utiliza el perfil de recurso compartido personalizado Deprecated, el intervalo de IOPS se basa en el tamaño del recurso compartido de archivos.

Por ejemplo, para una compartición de archivos de 25 GB, puede aumentar IOPS en cualquier lugar del rango de 100 a 1.000 IOPS con un perfil personalizado. Si más adelante amplías el tamaño de un recurso compartido de archivos al siguiente nivel superior, podrás volver a aumentar las IOPS. El IOPS se puede ajustar varias veces hasta alcanzar el límite máximo o mínimo.
O puedes cambiar de un perfil personalizado a un perfil de nivel de IOPS o al perfil dp2. La selección del nivel de IOPS está restringida por el tamaño del archivo compartido. Al pasar de un perfil personalizado a cualquier perfil por niveles, se actualiza la facturación y se ajusta el número de IOPS en función del perfil.

Cuando su recurso compartido de archivos utiliza uno de los perfiles de recurso compartido por niveles Deprecated, puede ajustar su límite de IOPS mediante:

Cambio de un perfil de nivel IOPS al perfil dp2 o custom. En este caso, el tamaño del recurso compartido de archivos limita el rango de IOPS que se seleccione.
- Por ejemplo, si estás ajustando las IOPS para compartir archivos con un perfil de 3 IOPS/GB y son 12.000 GB, puedes ajustar las IOPS utilizando un perfil personalizado o dp2. Es posible porque ambos soportan un tamaño de compartición de 12.000 GB.
- Si el tamaño de los archivos compartidos fuera superior a 16.000 GB, el perfil personalizado no permitiría ajustar las IOPS, pero el perfil dp2 sí, ya que admite tamaños de archivos compartidos de hasta 32.000 GB. Los tamaños máximos de los niveles de IOPS son 32 000 GB para 3 IOPS/GB, 9 600 GB para 5 IOPS/GB y 4 800 GB para 10 IOPS/GB.
Cuando pasas de un perfil por niveles a un perfil personalizado o « dp2 », la facturación se actualiza en función de las IOPS especificadas.
Seleccionar un nivel de IOPS diferente. El IOPS se ajusta dentro del nivel. El grado en que se pueden aumentar las IOPS viene determinado por el máximo permitido por el perfil de nivel de IOPS del recurso compartido de archivos. Las IOPS se pueden ajustar a un nivel de IOPS en función del tamaño de la compartición de archivos o seleccionar el perfil siguiente que permita aumentar el rendimiento.

El número máximo de IOPS para un recurso compartido de archivos con un perfil de nivel de 3 IOPS/GB es de 96 000 IOPS. Los demás perfiles tienen un límite de 48.000 IOPS. Para lograr 96.000 IOPS, varias instancias de servidor virtual tienen que acceder a una única compartición de archivos. Un único recurso compartido de archivos al que accede una sola instancia tiene un límite de 48 000 IOPS.

Para ajustar el valor de IOPS de una compartición de archivos, la compartición de archivos debe tener un estado estable. La autorización de usuario se verifica antes de ajustar IOPS.

Puede supervisar el progreso del cambio de IOPS de la compartición de archivos desde la interfaz de usuario o la CLI. También puedes consultar los eventos de seguimiento de la actividad para comprobar que se han ajustado las IOPS.

Limitaciones

Se aplican las limitaciones siguientes.

Para ajustar el valor de IOPS, la compartición de archivos debe tener un estado estable.
Un perfil dp2 puede expandirse hasta el máximo permitido por la banda dp2. No es posible cambiar de banda de IOPS en « dp2 » a menos que se aumente el tamaño del recurso compartido de archivos y, a continuación, se cambie a una banda superior.
Para una compartición de archivos creada con un perfil de nivel de IOPS para aumentar o disminuir IOPS, seleccione un perfil diferente para el tamaño de compartición de archivos. Si el tamaño de la compartición de archivos excede el del nuevo perfil de nivel de IOPS, no puede cambiar el perfil.
Un perfil de IOPS personalizado puede expandirse hasta el máximo permitido por la banda personalizada. No puedes cambiar de banda personalizada a menos que aumentes el tamaño compartido del archivo y, a continuación, pases a una banda superior.
El ajuste de IOPS moviéndose entre perfiles está restringido por el tamaño de compartición de archivos.
El número máximo de IOPS para una compartición de archivos para todos los perfiles es 96.000 IOPS. Para lograr 96.000 IOPS, varias instancias de servidor virtual tienen que acceder a una única compartición de archivos. Un único recurso compartido de archivos en una instancia tiene un límite de 48 000 IOPS.

Ajuste de IOPS en la consola

Siga estos pasos para ajustar el valor de IOPS seleccionando un nuevo nivel de IOPS o una banda de IOPS personalizada:

Ve a la lista de recursos compartidos. En la consola IBM Cloud, haga clic en el del menú de navegación > de infraestructura > Almacenamiento > Recursos compartidos de almacenamiento de archivos. De forma predeterminada, se visualizan las comparticiones de archivos para todos los grupos de recursos de la región.
En la página de lista Comparticiones de archivos para VPC, pulse el nombre de una compartición de archivos para ver sus detalles.
En la página de detalles del recurso compartido de archivos, busca « Perfil » y haz clic en el icono , o bien utiliza el menú « Acciones » y selecciona « Editar perfil de IOPS ». Los volúmenes deben estar conectados a una instancia de servidor virtual para estas acciones.
En el panel lateral, ajuste el valor de IOPS del siguiente modo:
- En el perfil « dp2 » o en el perfil personalizado, se muestra el valor actual de IOPS y el tamaño del recurso compartido de archivos. Especifique un nuevo valor de IOPS dentro del rango permitido para ese tamaño.
- Para un nivel de IOPS, selecciona otro nivel en el menú. Por ejemplo, puede tener un perfil de propósito general de 3 IOPS/GB que desee aumentar a un perfil de 5 IOPS/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 IOPS se aplicará al reiniciar la instancia.

Ajuste de IOPS desde la CLI

Ajuste de IOPS para un perfil personalizado o dp2

Desde la CLI, utiliza el comando « share-update » con la propiedad « --iops » para indicar el nuevo tamaño de IOPS para un perfil personalizado o de « dp2 ». Las IOPS que indiques deben estar dentro del rango correspondiente al tamaño del recurso compartido de archivos. Para más información, consulte el " dp2 " o el " Perfil IOPS personalizado.

Para poder utilizar la CLI, debe instalar la CLI de IBM Cloud y el plugin de la CLI de VPC. Para obtener más información, consulte los Requisitos previos de la CLI.

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
r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   stable            us-south-1   dp2       1500       Default          replica
r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share    stable            us-south-2   dp2       1500       Default          source
r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share        stable            us-south-3   dp2       1500       Default          replica
r006-925214bc-ded5-4626-9d8e-bc4e2e579232   my-new-file-share       stable            us-south-2   dp2       500        Default          none
r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default          none
r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default          source

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              -

Utilice el mandato ibmcloud is share-update para aumentar o disminuir las IOPS de la compartición de archivos.

ibmcloud is share-update my-file-share --iops 2000

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)                     1000
IOPS                         2000
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

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

Ajuste de IOPS especificando un perfil de nivel de IOPS diferente

Estas instrucciones son para la generación anterior de perfiles de recursos compartidos de archivos (de uso general, 5-iops, 10-iops o personalizados) que se utilizaron en la versión beta de los recursos compartidos de archivos zonales. A partir del 06 de mayo de 2026, estos perfiles de acciones quedarán obsoletos. Para acceder a las últimas funciones, debe cambiar el perfil de IOPS de su recurso compartido a dp2.

En la CLI, utilice el mandato ibmcloud is share-update con la propiedad --profile e indique el nombre o href del perfil de nivel de IOPS.

En el siguiente ejemplo se cambia un perfil de 3 IOPS/GB por uno de 5 IOPS/GB. En este caso, la compartición de archivos no puede superar los 9.600 GB para cambiar al perfil superior.

ibmcloud is share-update my-file-share --profile tier-5iops

Updating file share my-file-share under account Test Account as user user@mycompany.com...
ID                           ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Name                         my-file-share
CRN                          crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Lifecycle state              updating
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-1
Profile                      tier-5iops
Size(GB)                     100
IOPS                         3000
User Tags                    docs:test
Encryption                   provider_managed
Mount targets                ID                          Name   VPC ID   VPC Name
                             No mount targets found.
Resource group               ID                                     Name
                             7f1645c5-8afa-4a7e-860d-3df563e0aa8d   Default
Created                      2023-02-26T20:01:18+05:30
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.

Ajuste de las IOPS mediante la API

Puede ajustar el valor de IOPS para las comparticiones de archivos de datos existentes llamando a la API de Virtual Private Cloud (VPC).

Ajuste de IOPS para el dp2 o el perfil personalizado

Realice una solicitud PATCH /shares y especifique la propiedad iops para ajustar el IOPS dentro del rango permitido para un perfil pr dp2 personalizado.

No puede actualizar el nombre de la compartición de archivos y ajustar el valor de IOPS en la misma solicitud de PATCH /shares. Realice dos solicitudes PATCH /shares.

El siguiente ejemplo muestra un aumento de 100 IOPS a 3.000 IOPS para un recurso compartido de archivos de 100 GB, basado en un perfil personalizado de 100-499. El rango de IOPS de esta banda personalizada es de 100 - 6.000. Para obtener más información sobre los rangos de IOPS disponibles, consulte Descripción general del perfil de almacenamiento de archivos.

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

El estado del recurso compartido de archivos muestra « updating » mientras se ajusta el IOPS. Se muestra el valor de IOPS actual hasta que se reinicia la instancia. En el siguiente ejemplo, el valor de IOPS se ajusta a partir de 100.

{
   "created_at": "2023-08-08T22:58:49.000Z",
   "crn": "crn:[...]",
   "encryption": "provider_managed",
   "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-a0c07083-f411-446c-9316-7b08d6448c86",
   "id": "r006-a0c07083-f411-446c-9316-7b08d6448c86",
   "iops": 100,
    .
    .
    .
	"status": "updating",
    .
    .
    .
}

Cuando finalice la ampliación del valor de IOPS, reinicie la instancia. Se muestra el nuevo valor y el estado del recurso compartido es « stable ».

{
  "created_at": "2023-08-08T22:58:49.000Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86",
  "id": "a0c07083-f411-446c-9316-7b08d6448c86",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "my-share-updated",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-3iops",
    "name": "custom",
    "resource_type": "share_profile"
  },
  "access_control_mode": "security-group",
  "allowed_transit_encryption_modes": ["none", "user-managed"],
  "replication_role": "none",
  "replication_status": "none",
  "replication_status_reasons": [],
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 4800,
  "mount_targets": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86/mount_targets/1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "name": "my-mount-target",
      "resource_type": "share_target",
      "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/r006-12bb28fc-856d-4902-813b-dc065d1ed084",
        "id": "12bb28fc-856d-4902-813b-dc065d1ed084",
        "name": "my-vpc",
        "resource_type": "vpc"
      }
    }
  ],
  "snapshot_count": 10,
  "snapshot_size": 10,
  "user_tags": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1",
    "resource_type": "zone"
  }
}

Ajuste de IOPS especificando un perfil de nivel de IOPS diferente

Realice una solicitud de PATCH /shares y especifique la propiedad profile e indique el nombre o href del perfil de nivel de IOPS.

En el siguiente ejemplo se cambia un perfil de 3 IOPS/GB por uno de 5 IOPS/GB. En este caso, la compartición de archivos no puede superar los 9.600 GB para cambiar al perfil superior.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2023-07-18&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "profile": "5iops-tier"
    }'

Ajuste de IOPS con Terraform

Puede ajustar IOPS para comparticiones de archivos de datos existentes en Terraform.

Ajuste de IOPS para un perfil personalizado o dp2

Para modificar el nivel de rendimiento de una compartición de archivos, utilice el recurso ibm_is_share y proporcione el valor de IOPS que desee. Cuando especifique el valor de IOPS, asegúrese de que está dentro del rango de rendimiento para el tamaño de la compartición de archivos. Para obtener más información, consulte Perfil de almacenamiento de archivosdp2.

Cuando se aplica, el ejemplo siguiente actualiza el rendimiento de compartición a 5000 IOPS.

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

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

Ajuste de IOPS especificando un perfil de nivel de IOPS diferente

Para modificar el nivel de rendimiento de una compartición de archivos con un perfil de nivel de IOPS, utilice el recurso ibm_is_share y especifique un nivel de IOPS diferente. Cuando se aplica, el ejemplo siguiente actualiza el rendimiento de compartición a 5000 IOPS.

resource "ibm_is_share" "example" {
  name    = "my-share"
  size    = 220
  profile = "tier-5iops"
  zone    = "us-south-2"
}

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

Próximos pasos

Cree más comparticiones de archivos o gestione sus comparticiones existentes: