Ajustar el límite de ancho de banda de un archivo compartido regional

Seleccione la disponibilidad Los clientes con acceso especial para previsualizar la nueva oferta de recursos compartidos de archivos regionales pueden utilizar el perfil rfs para crear recursos compartidos de archivos con disponibilidad de datos regional y valores de ancho de banda ajustables.

Ajusta el ancho de banda para los recursos compartidos de archivos regionales con el perfil rfs de 800 a 8192 Mbps (1024 MBps) para el rendimiento combinado de lectura y escritura. Gestiona el límite de ancho de banda a través de la consola, la CLI o la API.

Con esta función, puede aumentar o reducir el límite de ancho de banda de su recurso compartido en la consola, desde la CLI o con la API. Para modificar este atributo, la acción debe estar en estado disponible. Su autorización de usuario se verifica antes de ajustar el límite de ancho de banda.

La facturación correspondiente a un recurso compartido de archivos actualizado 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.

Ajuste del ancho de banda en la consola

  1. Ir a la lista de todas las comparticiones de archivos. Desde 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. Pulse el nombre de una compartición de archivos para ver la página de detalles.
  3. Localice la sección Perfil, y haga clic en el icono Editar icono Editar, o utilice el menú Acciones icono Acciones y seleccione Editar ancho de banda.
  4. En el panel lateral, puede especificar un límite de ancho de banda para compartir archivos entre el valor mínimo de 800 y el máximo de 8192 Mbps.
  5. Revise el resumen mensual estimado de pedidos.
  6. Si está satisfecho, pulse Guardar y continuar.

Ajuste del ancho de banda desde la CLI

Desde la CLI, utilice el comando ibmcloud is share-update con la opción --bandwidth para indicar el nuevo valor de ancho de banda de un perfil personalizado.

ibmcloud is share-update share_ID --bandwidth BANDWIDTH

Este ejemplo muestra un aumento del límite de ancho de banda a 3.000 Mbps.

ibmcloud is share-update my-file-share --bandwidth 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                    stable
   Access control mode                security_group
   Accessor binding role              none
   Allowed transit encryption modes   stunnel,none
   Zone                               us-south-1
   Profile                            rfs
   Size(GB)                           1000
   IOPS                               35000
   Bandwidth                          3000
   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                            2025-09-23T22: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           nsf4
   Availability Mode                  zonal
   Storage Generation                 2

Los archivos compartidos con disponibilidad regional sirven datos en todas las zonas de la región. La respuesta comando muestra por defecto la primera zona de la región.

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

Ajustar el ancho de banda con la API

Puede ajustar el ancho de banda de los datos compartidos existentes llamando a la API de VPC. Haz una petición a PATCH /shares y especifica el parámetro bandwidth para ajustar el límite de ancho de banda.

No se puede actualizar el nombre del recurso compartido, aumentar el tamaño, ajustar las IOPS y ajustar el límite de ancho de banda en la misma solicitud a PATCH /shares. Haga solicitudes por separado a PATCH /shares.

Este ejemplo muestra el valor de ancho de banda aumentado a 3.000 Mbps.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2025-09-23&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "bandwidth": 3000
    }'

El estado del recurso compartido de archivos muestra « updating » mientras se ajusta el ancho de banda. El ancho de banda preestablecido se muestra hasta que finaliza la actualización.

{
	"bandwidth": 400,
	"created_at": "2025-09-23T09:46:43.000Z",
	"crn": "crn:v1:bluemix:public:is:us-east-1:a/<Acc id>::share:<file shareID>",
    .
    .
    .
	"status": "updating",
    .
    .
    .
}

Ajuste del límite de ancho de banda con Terraform

Para modificar las IOPS de un recurso compartido, utilice el recurso ibm_is_share. Cuando se aplica, el siguiente ejemplo actualiza el límite de ancho de banda de uso compartido de archivos a 4.000 Mbps.

resource "ibm_is_share" "storage" {
   name         = "demo-share-update"
   size         = 8000
   bandwidth    = 4000
}

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