Gestión de File Storage for Classic

Gestione los volúmenes de almacenamiento de archivos a través de la consola de IBM Cloud, la CLI, la API o Terraform para autorizar hosts, ajustar la capacidad y las IOPS, y controlar las instantáneas y la replicación.

Puedes gestionar tus volúmenes de « IBM Cloud® File Storage for Classic » a través de la consola de IBM Cloud®, desde la CLI, mediante la API o con Terraform. Puede añadir notas, autorizar hosts de cálculo para acceder a su volumen, revocar el acceso y eliminar el volumen cuando ya no sea necesario. Puede aumentar la capacidad, ajustar las IOPS, gestionar las instantáneas y gestionar la replicación.

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 " Icono VPC > " Infraestructura clásica.
  2. Haga clic en Almacenamiento > File Storage for Classic. Se muestra la lista de archivos compartidos.
  3. Puede filtrar la lista haciendo clic en el icono Filtro 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 el icono de descarga.

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.

Visualización de la lista de volúmenes desde la CLI de IBMCLOUD

Para obtener la lista de su File Storage for Classic desde la CLI de IBMCLOUD, utilice el comando ibmcloud sl file volume-list. El siguiente ejemplo muestra todos los volúmenes de almacenamiento de larga duración de la cuenta corriente que se encuentran en dal13 y los ordena por capacidad.

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

La salida del comando muestra información sobre el volumen, como el ID del volumen, el nombre del volumen, la ubicación, el tipo de almacenamiento, la capacidad, el uso, las IOPS máximas, la dirección IP, lunID, recuentos de transacciones activas, recuento de socios de replicación y notas.

Para obtener más información sobre todos los parámetros que están disponibles para este comando, consulte ibmcloud sl file volume-list.

Visualización de la lista de volúmenes desde el SL CLI

Para obtener la lista de tus File Storage for Classic s desde el SL CLI, utiliza el comando slcli file volume-list.

$ 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 VPC > Infraestructura clásica.
  2. Haga clic en 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 CLI

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.

Autorización de hosts para acceder a File Storage for Classic

Los hosts autorizados son aquellos a los que se les concede acceso a un volumen concreto. Sin la autorización del host, no puede acceder ni utilizar el almacenamiento de su sistema. Al autorizar a un host a acceder a tu volumen, se generan el nombre de usuario y la contraseña.

Puede autorizar y conectar hosts que estén ubicados en el mismo centro de datos que su almacenamiento. Puede tener varias cuentas, pero no puede autorizar a un host de una cuenta a que acceda a su almacenamiento en otra cuenta.

Puede autorizar hasta 64 servidores para acceder a la compartición de archivos. Este límite incluye todas las autorizaciones de subred, host e IP combinadas. Para obtener más información sobre cómo aumentar este límite, consulte las Preguntas más frecuentes.

Una vez que el host esté autorizado, puede montar el recurso compartido de archivos y asignar propietarios a su nueva estructura de carpetas y archivos. En Linux, puede refinar el control de acceso utilizando los comandos chown y chmod para asignar permisos de lectura, escritura y ejecución a usuarios y grupos individuales. Para más información, consulte Mounting File Storage for Classic en Red Hat Linux® y Mounting File Storage for Classic en Ubuntu.

Autorizar a los hosts para que accedan a File Storage for Classic en la consola

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

  2. Haga clic en Storage > File Storage for Classic y, a continuación, haga clic en el nombre de su volumen.

  3. Desplácese a la sección Hosts autorizados de la página.

  4. Pulse Autorizar host en la parte derecha.

  5. Filtre la lista de hosts disponibles seleccionando el tipo de dispositivo, la subred o la dirección IP.

    Cuando la lista está filtrada por subred, las subredes que se muestran son subredes suscritas al mismo centro de datos que el volumen de almacenamiento.

  6. Seleccione uno o más hosts en la lista y pulse Guardar.

Autorizar a los hosts a acceder a File Storage for Classic desde la CLI

Autorización de hosts desde IBMCLOUD CLI

Utilice el mandato ibmcloud sl file access-authorize para autorizar a un host a acceder a la compartición de archivos. El ejemplo siguiente autoriza a la instancia de servidor virtual 87654321 a montar la compartición de archivos 12345678.

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

Para obtener más información sobre todos los parámetros disponibles para este mandato, consulte ibmcloud sl file access-authorize.

Autorización de hosts desde SLCLI

Para autorizar a un host a acceder al volumen, puede utilizar el comando slcli file access-authorize.

$ slcli file access-authorize --help
Usage: slcli file access-authorize [OPTIONS] VOLUME_ID
Options:
  -h, --hardware-id TEXT    The ID of one hardware server to authorize.
  -v, --virtual-id TEXT     The ID of one virtual server to authorize.
  -i, --ip-address-id TEXT  The ID of one IP address to authorize.
  -p, --ip-address TEXT     An IP address to authorize.
  -s, --subnet-id TEXT      An ID of one subnet to authorize.
  --help                    Show this message and exit.

Autorización de hosts para acceder a File Storage for Classic con la API

Para autorizar a los hosts a acceder a su volumen de archivos, puede utilizar el método authorize_host_to_volume en el cliente de la API Python. Debe especificar el volume_id y los hosts de computación 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 solicitud devuelve una matriz de objetos SoftLayer_Network_Storage_Allowed_Host que tienen acceso al volumen especificado.

Autorización del host con Terraform

Para autorizar a un host de cálculo a acceder a la compartición, utilice el recurso ibm_storage_file y especifique allowed_virtual_guest_ids para servidores virtuales, o allowed_hardware_ids para servidores nativos. Especifique allowed_ip_addresses para definir qué direcciones IP tienen acceso al almacenamiento.

El ejemplo siguiente define que el servidor virtual con el ID 28961689 puede acceder al volumen desde la subred 10.146.139.64/26 y la dirección 10.146.139.84.

resource "ibm_storage_file" "fs_endurance" {
  type       = "Endurance"
  datacenter = "dal09"
  capacity   = 20
  iops       = 0.25
  allowed_virtual_guest_ids = ["28961689"]
  allowed_subnets           = ["10.146.139.64/26"]
  allowed_ip_addresses      = ["10.146.139.84"]
  snapshot_capacity         = 10
  hourly_billing            = true
}

Después de crear el recurso de almacenamiento, puede acceder a los atributos hostname y volumename, que puede utilizar para determinar el destino de montaje más adelante. Por ejemplo, un recurso File Storage con el argumento hostname establecido en nfsdal0901a.service.softlayer.com y el argumento volumename establecido en IBM01SV278685_7 tiene el punto de montaje nfsdal0901a.service.softlayer.com:-IBM01SV278685_7.

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

Visualización de 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 " Icono VPC > " Infraestructura clásica.
  2. Haga clic en Storage > File Storage for Classic y, a continuación, haga clic en el nombre de su 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 " Acciones icono 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 ver la lista de hosts autorizados para acceder a un volumen de File Storage for Classic desde la CLI

Visualización de la lista de hosts autorizados desde IBMCLOUD CLI

Puede utilizar el mandato ibmcloud sl file access-list para listar los hosts que tienen autorización para acceder a la compartición de archivos. El ejemplo siguiente lista los hosts que pueden montar la compartición de archivos 12345678 y los ordena por sus ID.

ibmcloud sl file access-list 12345678 --sortby id

Para obtener más información sobre todos los parámetros disponibles para este mandato, consulte ibmcloud sl file access-list.

Visualización de la lista de hosts autorizados desde SLCLI

Para mostrar la lista de hosts autorizados, puedes utilizar el siguiente comando.

$ 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 File Storage for Classic a los que tiene acceso un host

Puede consultar 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 " Icono VPC > " Infraestructura clásica.
  3. Haga clic en 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 desde la Lista de dispositivos de la consola

  1. Vaya a la consola deIBM Cloud®.
  2. En el menú, seleccione " Infraestructura " Icono VPC > " Infraestructura clásica.
  3. Haga clic en Dispositivos > Lista de dispositivos.
  4. Efectúe una doble pulsación en el dispositivo adecuado.
  5. Seleccione el separador Almacenamiento.
  6. Se le presenta una lista de los volúmenes de almacenamiento a los cuales este host tiene acceso, todos agrupados por tipo de almacenamiento (bloque, archivo, otros). Seleccione el menú respectivo de Acción situado junto al volumen del que desea revocar el acceso y pulse Revocar acceso.
  7. Confirme si desea revocar el acceso al volumen, porque la acción no puede deshacerse. Pulse Sí para revocar el acceso al volumen o No para cancelar la acción.

Si desea desconectar varios volúmenes desde un host específico, debe repetir la acción Revocar acceso para cada volumen.

Revocación del acceso desde la vista Storage de la consola

  1. Vaya a la consola deIBM Cloud®.
  2. En el menú, seleccione " Infraestructura " Icono VPC > " Infraestructura clásica.
  3. Haga clic en Almacenamiento > File Storage for Classic y seleccione el volumen al que desea revocar el acceso.
  4. Pulse Hosts autorizados para visualizar las instancias de cálculo que tienen acceso a la compartición de archivos.
  5. Haz clic en el iconode acciones situado junto al host cuyo acceso se va a revocar y selecciona Revocar acceso.
  6. Confirme si desea revocar el acceso al volumen, porque la acción no puede deshacerse. Pulse Sí para revocar el acceso al volumen o No para cancelar la acción.

Si desea desconectar varios hosts desde un host específico, debe repetir la acción Revocar acceso para cada host.

Revocación del acceso de un host a File Storage for Classic desde la CLI

Revocación de la autorización de host de IBMCLOUD CLI

Puede utilizar el mandato ibmcloud sl file access-revoke para eliminar la autorización de un host. El mandato siguiente no permite que la instancia de servidor virtual 87654321 monte la compartición de archivos 12345678.

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

Para obtener más información sobre todos los parámetros disponibles para este mandato, consulte ibmcloud sl file access-revoke.

Revocación de la autorización de host desde SLCLI

Puede utilizar el mandato siguiente en SLCLI.

$ 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.

Si desea desconectar varios hosts desde un host específico, debe repetir la acción Revocar acceso para cada host.

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

Antes de eliminar un volumen, complete la lista de comprobación previa a la eliminación para confirmar que el volumen no está en uso y que comprende el plazo de recuperación.

Para obtener instrucciones paso a paso sobre cómo eliminar volúmenes en la consola, la CLI, la API y Terraform, consulta Desactivación y eliminación de volúmenes de File Storage for Classic.