Visualización de la lista de volúmenes de " File Storage for Classic " en la consola

Puede ver sus volúmenes desde la lista de Recursos o yendo a la lista de volúmenes de File Storage for Classic.

1. Vaya a la consola deIBM Cloud®. En el menú, seleccione " Infraestructura " > " Infraestructura clásica.
2. Pulse Almacenamiento > File Storage for Classic. Se muestra la lista de archivos compartidos.
3. Puede filtrar la lista haciendo clic en el y seleccionando una ubicación o introduciendo una capacidad específica. Haz clic en « Aplicar » para confirmar tu selección.
4. Pulse el nombre de volumen adecuado en la lista.

Puedes descargar la lista en formato « CSV » haciendo clic en .

La tabla muestra información sobre el volumen, como Nombre, Ubicación, Estado, Tipo de almacenamiento, IOPS máximas, Capacidad, Uso, Capacidad de instantáneas, Fecha de inicio y Notas, que se pueden editar.

Visualización de la lista de volúmenes de File Storage for Classic desde la CLI

Antes de empezar, decida el cliente de CLI que desea utilizar.

• Puede instalar la CLI deIBM Cloud e instalar el plug-in SL con ibmcloud plugin install sl. Para obtener más información, consulte Ampliación de la CLI de IBM Cloud con plugins.
• O bien, puede instalar SLCLI.

ibmcloud sl file volume-list -d dal13 -t endurance --sortby capacity_gb

id          username              datacenter   storage_type             capacity_gb   bytes_used   IOPs   ip_addr                                lunId   active_transactions   rep_partner_count   notes
233039512   IBM02SEV1414935_79    dal13        endurance_file_storage   20            0            -      fsf-dal1303g-fz.adn.networklayer.com   -       0                     1                   -
703233985   IBM02SEV1414935_538   dal13        endurance_file_storage   20            0            -      fsf-dal1303d-fz.adn.networklayer.com   -       0                     0                   -
221349094   IBM02SEV1414935_68    dal13        endurance_file_storage   30            0            -      fsf-dal1302c-fz.adn.networklayer.com   -       0                     1                   Testing

$ slcli file volume-list --help
Usage: slcli file volume-list [OPTIONS]

        List file storage.

Example::
        slcli file volume-list -d dal10 --storage-type endurance --sortby capacity_gb

┌────┬────────────────┬──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ -u │ --username     │ Volume username                                                                                                                                                              │
│ -d │ --datacenter   │ Datacenter shortname                                                                                                                                                         │
│ -o │ --order        │ Filter by ID of the order that purchased the block storage                                                                                                                   │
│    │ --storage-type │ Type of storage volume Choices: performance, endurance                                                                                                                       │
│    │ --sortby       │ Column to sort by                                                                                                                                                            │
│    │ --columns      │ Columns to display. Options: id, username, datacenter, storage_type, capacity_gb, bytes_used, ip_addr, active_transactions, mount_addr, rep_partner_count, created_by, notes │
│ -h │ --help         │ Show this message and exit.                                                                                                                                                  │
└────┴────────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Visualización de la lista de volúmenes File Storage for Classic con la API

Para recuperar la lista de volúmenes File Storage for Classic con la API, puede utilizar el método list_file_volumes y filtrar los resultados con los parámetros datacenter, storage_type (Resistencia o Rendimiento) y order. La solicitud devuelve una lista de volúmenes de archivos con detalles.

También puede utilizar comandos curl como el siguiente ejemplo para consultar diversos aspectos del volumen de almacenamiento. Este ejemplo devuelve el número de bytes que se están utilizando actualmente.

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/{volume_ID}/collectBytesUsed'

La siguiente petición devuelve el valor máximo de IOPS para el volumen.

curl -g -u $SL_USER:$SL_APIKEY -X GET \
'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/{volume_ID}/getIops'

Para más información, consulte SoftLayer_Network_Storage en la referencia de la API.

Actualización de las notas de un volumen en la consola

1. Vaya a la consola deIBM Cloud®. En el menú, seleccione el ícono de Infraestructura > Infraestructura clásica.
2. Pulse Almacenamiento > File Storage for Classic.
3. Busca el volumen que deseas actualizar. Haga clic en el nombre del volumen para ver la página Detalles del volumen.
4. Haga clic en el icono Editar junto a Notas e introduzca su texto.

Actualización de las notas de un volumen desde la interfaz de línea de comandos

Puede utilizar el comando ibmcloud sl call-api para añadir y modificar notas para sus volúmenes.

$ ibmcloud sl call-api --help
NAME:
  call-api - Call arbitrary API endpoints

USAGE:
  ibmcloud sl call-api SERVICE METHOD [OPTIONS]

OPTIONS:
  --filter value      Object filters
  -h, --help          Usage information.
  --init value        Init parameter
  --limit value       Result limit
  --mask value        Object mask: use to limit fields returned
  --offset value      Result offset
  --output value      Specify output format, only JSON is supported now.
  --parameters value  Append parameters to web call

Especifique el ID del volumen en la opción --init, y utilice la opción --parameters para establecer la nueva nota. Consulte el ejemplo siguiente:

ibmcloud sl call-api SoftLayer_Network_Storage editObject --init 562193766 --parameters '[{"notes":"Testing."}]'

Para obtener más información, consulte ibmcloud sl call-api.

Actualización de las notas de un volumen mediante la API

Para actualizar las notas de un volumen con la API, puede realizar una solicitud curl a POST /SoftLayer_Network_Storage/$VOLUME_ID/editObject.json. El siguiente ejemplo de API añade la palabra "Probando" como nota al volumen de almacenamiento.

curl -u $SL_USER:$SL_APIKEY -X POST -H "Accept: */*" -H "Accept-Encoding: gzip, deflate, compress" -d '{"parameters": [{"notes": "Testing"}]}' 'https://api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/123456789/editObject.json'

También puede utilizar el método volume_set_note en el cliente de la API Python.

Ver la lista de hosts autorizados para acceder a un volumen de File Storage for Classic en la consola

1. Vaya a la consola deIBM Cloud®. En el menú, seleccione " Infraestructura " > " Infraestructura clásica.
2. Pulse Almacenamiento > File Storage for Classic y pulse el Nombre de volumen.
3. Pulse Hosts autorizados para visualizar las instancias de cálculo que tienen acceso a la compartición de archivos.
4. Haga clic en la elipsis " y seleccione " Ver detalles del anfitrión. Aparece un panel lateral con detalles como el nombre del dispositivo, la dirección IP, el nombre de usuario y la contraseña. También se muestra la sección Lista de control de acceso. En la sección Lista de control de acceso, puede añadir o eliminar subredes.

La dirección de destino aparece listada en la página Detalle de almacenamiento. Para NFS, la dirección de destino se describe como un nombre DNS y, para iSCSI, es la dirección IP de Descubrir portal de destino.

Cómo consultar la lista de hosts autorizados para acceder a un volumen de File Storage for Classic desde la interfaz de línea de comandos

ibmcloud sl file access-list 12345678 --sortby id

$ slcli file access-list --help
Usage: slcli file access-list [OPTIONS] VOLUME_ID

Options:
 --sortby TEXT   Column to sort by
 --columns TEXT  Columns to display. Options: id, name, type,
                 private_ip_address, source_subnet, host_iqn, username,
                 password, allowed_host_id
 -h, --help      Show this message and exit.

Visualización en la consola de los volúmenes de « File Storage for Classic » a los que tiene acceso un host

Puede ver los volúmenes a los que tiene acceso un host, incluida la información necesaria para establecer una conexión: nombre del volumen, tipo de almacenamiento, dirección de destino, capacidad y ubicación.

1. Vaya a la consola deIBM Cloud®.
2. En el menú, seleccione " Infraestructura " > " Infraestructura clásica.
3. Pulse Dispositivos > Lista de dispositivos.
4. Pulse el dispositivo adecuado.
5. Seleccione el separador Almacenamiento.

Se le presenta una lista de los volúmenes de almacenamiento a los cuales este host tiene acceso, todos están agrupados por tipo de almacenamiento (bloque, archivo, otros). Desde los menús respectivos de Acción, puede autorizar almacenamiento adicional o eliminar el acceso.

Revocar el acceso de un host a File Storage for Classic en la consola

Si quiere detener el acceso desde un host a un volumen de almacenamiento determinado, puede revocar el acceso. Cuando se revoca el acceso, la conexión de host se descarta del volumen. El sistema operativo y las aplicaciones ya no se pueden comunicar con el volumen.

Para impedir problemas del lado del host, desmonte el volumen de almacenamiento desde el sistema operativo antes de revocar el acceso para evitar perder unidades o corrupción de datos.

Puede revocar el acceso desde el Almacenamiento de la Lista de Dispositivos o desde las vistas de almacenamiento.

Revocar el acceso de un host a File Storage for Classic desde la CLI

ibmcloud sl file access-revoke 12345678 --virtual-id 87654321

$ slcli file access-revoke --help
Usage: slcli file access-revoke [OPTIONS] VOLUME_ID

Options:
  -h, --hardware-id TEXT    The ID of one hardware server to revoke authorization.
  -v, --virtual-id TEXT     The ID of one virtual server to revoke authorization.
  -i, --ip-address-id TEXT  The ID of one IP address to revoke authorization.
  -p, --ip-address TEXT     An IP address to revoke authorization.
  -s, --subnet-id TEXT      An ID of one subnet to revoke authorization.
  --help                    Show this message and exit.

Revocación del acceso de un host a File Storage for Classic con la API

Para revocar la autorización del host para acceder a su volumen de archivos, puede utilizar el método deauthorize_host_to_volume en el cliente de la API Python. Tienes que especificar el volume_id y los hosts de cómputo proporcionando uno de los siguientes parámetros: hardware_ids (para servidores bare metal),virtual_guest_ids (para instancias de servidores virtuales), ip_address_ids, subnet_ids. La petición devuelve un array de objetos SoftLayer_Network_Storage_Allowed_Host que tienen acceso al volumen especificado, de forma que puedas confirmar que los hosts de computación solicitados han sido eliminados.

Eliminación de un volumen de almacenamiento en la consola

Si ya no necesita un volumen específico, puede suprimir dicha compartición de archivos. Para cancelar un volumen de almacenamiento, primero debe revocar el acceso desde cualquier host.

1. Vaya a la consola deIBM Cloud®. En el menú, seleccione " Infraestructura " > " Infraestructura clásica.

2. Pulse Almacenamiento > File Storage for Classic.

3. Pulse Acciones para el volumen que se va a cancelar y seleccione Suprimir File Storage for Classic.

4. Confirme si desea eliminar el volumen inmediatamente o en la fecha de vencimiento de su aprovisionamiento.

   Si selecciona la opción de cancelar el volumen en su fecha de aniversario, puede anular la solicitud de cancelación antes de su fecha de aniversario.

5. Pulse Continuar o Cerrar.

6. Marca la casilla de aceptación y haz clic en « Confirmar ».

Cuando se cancela el volumen, la solicitud va seguida de un periodo de espera de reclamación de 24 horas. El volumen se sigue viendo en la consola durante esas 24 horas. La facturación del volumen se detiene inmediatamente. Al caducar el periodo de reclamación, los datos se destruyen y el volumen también se elimina de la consola. Para obtener más información, consulte el apartado Preguntas frecuentes.

Las réplicas activas y los duplicados dependientes pueden bloquear la reclamación del volumen de almacenamiento. Asegúrese de que el volumen ya no esté montado, de que las autorizaciones de host se hayan revocado, de que la réplica se haya cancelado y de que no existan duplicados dependientes antes de intentar suprimir el volumen original.

Eliminación de un volumen de almacenamiento desde la CLI

Cuando se cancela el volumen, la solicitud va seguida de un periodo de espera de reclamación de 24 horas. El volumen se sigue viendo en la consola durante esas 24 horas. La facturación del volumen se detiene inmediatamente. Al caducar el periodo de reclamación, los datos se destruyen y el volumen también se elimina de la consola. Para obtener más información, consulte el apartado Preguntas frecuentes.

Las réplicas activas y los duplicados dependientes pueden bloquear la reclamación del volumen de almacenamiento. Asegúrese de que el volumen ya no esté montado, de que las autorizaciones de host se hayan revocado, de que la réplica se haya cancelado y de que no existan duplicados dependientes antes de intentar suprimir el volumen original.

ibmcloud sl file volume-cancel 12345678 --immediate -f

$ slcli file volume-cancel --help
Usage: slcli file volume-cancel [OPTIONS] VOLUME_ID

Options:
  --reason TEXT  An optional reason for cancellation.
  --immediate    Cancels the File Storage volume immediately instead of on the
                 billing anniversary.
  -h, --help     Show this message and exit.

Eliminación de un volumen de almacenamiento mediante la API

Cuando se cancela el volumen, la solicitud va seguida de un periodo de espera de reclamación de 24 horas. El volumen se sigue viendo en la consola durante esas 24 horas. La facturación del volumen se detiene inmediatamente. Al caducar el periodo de reclamación, los datos se destruyen y el volumen también se elimina de la consola. Para obtener más información, consulte el apartado Preguntas frecuentes.

Las réplicas activas y los duplicados dependientes pueden bloquear la reclamación del volumen de almacenamiento. Asegúrese de que el volumen ya no esté montado, de que las autorizaciones de host se hayan revocado, de que la réplica se haya cancelado y de que no existan duplicados dependientes antes de intentar suprimir el volumen original.

A continuación, puede utilizar el método cancel_volume en el cliente de la API Python. Especifique el número de suscripción ( volume_id ) y si desea cancelar la suscripción de inmediato o en la fecha de vencimiento (immediate=False o immediate=True). Si lo desea, también puede indicar el motivo de la cancelación (reason='No longer needed').

Supresión de un volumen de almacenamiento con Terraform

Utilice el comando " terraform destroy " para eliminar cómodamente un objeto remoto, como un recurso compartido de un único archivo. El siguiente ejemplo cancela el recurso compartido de archivos con el ID ibm_file_share.example.id.

terraform destroy --target ibm_file_share.example.id

Para obtener más información, consulte terraform destroy.

Cuando se cancela el volumen, la solicitud va seguida de un periodo de espera de reclamación de 24 horas. El volumen se sigue viendo en la consola durante esas 24 horas. La facturación del volumen se detiene inmediatamente. Al caducar el periodo de reclamación, los datos se destruyen y el volumen también se elimina de la consola. Para obtener más información, consulte el apartado Preguntas frecuentes.

Las réplicas activas y los duplicados dependientes pueden bloquear la reclamación del volumen de almacenamiento. Asegúrese de que el volumen ya no esté montado, de que las autorizaciones de host se hayan revocado, de que la réplica se haya cancelado y de que no existan duplicados dependientes antes de intentar suprimir el volumen original.