Exibição da lista de volumes File Storage for Classic no console

Você pode visualizar seus volumes na lista Recursos ou acessando a lista de volumes File Storage for Classic.

1. Vá para o IBM Cloud® console. No menu, selecione " Infraestrutura, " > " Infraestrutura clássica.
2. Clique em Armazenamento > File Storage for Classic. A lista de compartilhamentos de arquivos é exibida.
3. Você pode filtrar a lista clicando no ) e selecionando um local ou inserindo uma capacidade específica. Clique em “Aplicar” para confirmar sua seleção.
4. Clique no nome do volume apropriado na lista.

Você pode baixar a lista no formato CSV clicando .

A tabela mostra informações sobre o volume, como nome, local, status, tipo de armazenamento, IOPS máximo, capacidade, uso, capacidade de instantâneo, data de início e notas, que são editáveis.

Exibição da lista de volumes File Storage for Classic na CLI

Antes de iniciar, decida sobre o cliente CLI que deseja usar.

• É possível instalar a IBM Cloud e instalar o plug-in do SL com ibmcloud plugin install sl Para obter mais informações, consulte Estendendo IBM Cloud CLI com plug-ins.
• Ou é possível instalar o 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.                                                                                                                                                  │
└────┴────────────────┴──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Exibição da lista de volumes File Storage for Classic com a API

Para recuperar a lista de volumes File Storage for Classic com a API, você pode usar o método list_file_volumes e filtrar os resultados com os parâmetros datacenter, storage_type (Endurance ou Performance) e order. A solicitação retorna uma lista de volumes de arquivos com detalhes.

Você também pode usar comandos curl, como o exemplo a seguir, para consultar vários aspectos do volume de armazenamento. Este exemplo retorna o número de bytes que estão sendo usados no momento.

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

A solicitação a seguir retorna o valor máximo de IOPS para o volume.

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

Para obter mais informações, consulte SoftLayer_Network_Storage na referência da API.

Atualização das notas de um volume no console

1. Vá para o IBM Cloud® console. No menu, selecione de infraestrutura > Infraestrutura clássica.
2. Clique em Armazenamento > File Storage for Classic.
3. Localize o volume que você deseja atualizar. Clique no nome do volume para exibir a página de detalhes do volume.
4. Clique no ícone ao lado de Notes e digite seu texto.

Atualização das notas de um volume pela CLI

Você pode usar o comando ibmcloud sl call-api para adicionar e modificar notas para seus volumes.

$ 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 a ID do volume na opção --init e use a opção --parameters para definir a nova nota. Consulte o seguinte exemplo:

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

Para obter mais informações, consulte ibmcloud sl call-api.

Atualização das notas de um volume por meio da API

Para atualizar as anotações em um volume com a API, você pode fazer uma solicitação POST /SoftLayer_Network_Storage/$VOLUME_ID/editObject.json curl. O exemplo de API a seguir adiciona a palavra "Testing" (Teste) como uma nota ao volume de armazenamento.

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'

Como alternativa, você pode usar o método volume_set_note no cliente da API Python.

Visualização da lista de hosts autorizados a acessar um volume do File Storage for Classic no console

1. Vá para o IBM Cloud® console. No menu, selecione " Infraestrutura, " > " Infraestrutura clássica.
2. Clique em Armazenamento > File Storage for Classic e clique em seu Nome do volume.
3. Clique em Hosts autorizados para exibir as instâncias de computação que têm acesso ao seu Compartilhamento de arquivos.
4. Clique nas reticências " e selecione " Exibir detalhes do host. Um painel lateral é exibido com detalhes como nome do dispositivo, endereço IP, nome de usuário e senha. A seção Lista de controle de acesso também é exibida. Na seção Access Control List (Lista de controle de acesso), é possível adicionar ou remover sub-redes.

O endereço de Destino é listado na página Detalhe de armazenamento. Para NFS, o endereço de destino é descrito como um nome DNS e, para iSCSI, é o endereço IP do portal de destino de descoberta.

Visualização da lista de hosts autorizados a acessar um volume do File Storage for Classic a partir da CLI

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.

Visualização dos volumes do serviço de armazenamento em nuvem ( File Storage for Classic ) aos quais um host tem acesso autorizado no console

Você pode visualizar os volumes aos quais um host tem acesso, incluindo as informações necessárias para estabelecer uma conexão – nome do volume, tipo de armazenamento, endereço de destino, capacidade e localização.

1. Vá para o IBM Cloud® console.
2. No menu, selecione " Infraestrutura, " > " Infraestrutura clássica.
3. Clique em Dispositivos > Lista de dispositivos.
4. Clique no dispositivo apropriado.
5. Selecione a guia Armazenamento.

Você é apresentado a uma lista de volumes de armazenamento aos quais esse host específico tem acesso, todos agrupados por tipo de armazenamento (bloco, arquivo, outro). Nos respectivos menus Ação, é possível autorizar mais armazenamento ou remover o acesso.

Revogar o acesso de um host ao site File Storage for Classic no console

Se você deseja parar o acesso de um host a um volume de armazenamento específico, é possível revogar o acesso. Quando o acesso é revogado, a conexão de host é eliminada do volume. O sistema operacional e os aplicativos não podem mais se comunicar com o volume.

Para evitar problemas do lado do host, desmonte o volume de armazenamento de seu sistema operacional antes de revogar o acesso para evitar unidades ausentes ou distorção de dados.

É possível revogar o acesso do Armazenamento da Lista de dispositivos ou das visualizações de Armazenamento.

Revogar o acesso de um host ao File Storage for Classic pela 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.

Revogação do acesso de um host a File Storage for Classic com a API

Para revogar a autorização do host para acessar seu volume de arquivos, você pode usar o método deauthorize_host_to_volume no cliente da API Python. Você precisa especificar o endereço volume_id e os hosts de processamento fornecendo um dos seguintes parâmetros: hardware_ids (para servidores bare metal),virtual_guest_ids (para instâncias de servidor virtual), ip_address_ids, subnet_ids. A solicitação retorna uma matriz de objetos SoftLayer_Network_Storage_Allowed_Host que têm acesso ao volume especificado, para que você possa confirmar que os hosts de processamento solicitados foram removidos.

Excluindo um volume de armazenamento no console

Se você não precisar mais de um volume específico, será possível excluir esse compartilhamento de arquivos. Para cancelar um volume de armazenamento, é necessário revogar o acesso de qualquer host primeiro.

1. Vá para o IBM Cloud® console. No menu, selecione " Infraestrutura, " > " Infraestrutura clássica.

2. Clique em Armazenamento > File Storage for Classic.

3. Clique em Ações para que o volume seja cancelado, e selecione Excluir File Storage for Classic.

4. Confirme se deseja excluir o volume imediatamente ou na data de vencimento da data em que o volume foi provisionado.

   Se você selecionar a opção para cancelar o volume na data de aniversário dele, será possível anular a solicitação de cancelamento antes da data de aniversário.

5. Clique em Continuar ou Fechar.

6. Marque a caixa de seleção de confirmação e clique em Confirmar.

Quando o volume é cancelado, a solicitação é seguida por um período de espera de rereclamação de 24 horas. Ainda será possível ver o volume no console durante essas 24 horas. O faturamento para o volume para imediatamente. Quando o período de recuperação expirar, os dados serão destruídos e o volume também será removido do console. Para obter mais informações, consulte as Perguntas mais frequentes.

As réplicas ativas e as duplicatas dependentes podem bloquear a recuperação do volume de armazenamento. Certifique-se de que o volume não esteja mais montado, que as autorizações de host tenham sido revogadas, que a replicação tenha sido cancelada e que nenhuma duplicata dependente exista antes de tentar excluir o volume original.

Excluindo um volume de armazenamento pela CLI

Quando o volume é cancelado, a solicitação é seguida por um período de espera de rereclamação de 24 horas. Ainda será possível ver o volume no console durante essas 24 horas. O faturamento para o volume para imediatamente. Quando o período de recuperação expirar, os dados serão destruídos e o volume também será removido do console. Para obter mais informações, consulte as Perguntas mais frequentes.

As réplicas ativas e as duplicatas dependentes podem bloquear a recuperação do volume de armazenamento. Certifique-se de que o volume não esteja mais montado, que as autorizações de host tenham sido revogadas, que a replicação tenha sido cancelada e que nenhuma duplicata dependente exista antes de tentar excluir o volume 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.

Exclusão de um volume de armazenamento por meio da API

Quando o volume é cancelado, a solicitação é seguida por um período de espera de rereclamação de 24 horas. Ainda será possível ver o volume no console durante essas 24 horas. O faturamento para o volume para imediatamente. Quando o período de recuperação expirar, os dados serão destruídos e o volume também será removido do console. Para obter mais informações, consulte as Perguntas mais frequentes.

As réplicas ativas e as duplicatas dependentes podem bloquear a recuperação do volume de armazenamento. Certifique-se de que o volume não esteja mais montado, que as autorizações de host tenham sido revogadas, que a replicação tenha sido cancelada e que nenhuma duplicata dependente exista antes de tentar excluir o volume original.

Em seguida, você pode usar o método cancel_volume no cliente da API Python. Especifique o endereço de e-mail volume_id e se deseja cancelar a assinatura imediatamente ou na data de vencimento (immediate=False ou immediate=True). Opcionalmente, você também pode indicar o motivo do cancelamento (reason='No longer needed').

Excluindo um volume de armazenamento com o Terraform.

Use o comando terraform destroy para remover convenientemente um objeto remoto, como um único compartilhamento de arquivo. O exemplo a seguir cancela o compartilhamento de arquivos com o ID ibm_file_share.example.id.

terraform destroy --target ibm_file_share.example.id

Para obter mais informações, consulte terraform destroy

Quando o volume é cancelado, a solicitação é seguida por um período de espera de rereclamação de 24 horas. Ainda será possível ver o volume no console durante essas 24 horas. O faturamento para o volume para imediatamente. Quando o período de recuperação expirar, os dados serão destruídos e o volume também será removido do console. Para obter mais informações, consulte as Perguntas mais frequentes.

As réplicas ativas e as duplicatas dependentes podem bloquear a recuperação do volume de armazenamento. Certifique-se de que o volume não esteja mais montado, que as autorizações de host tenham sido revogadas, que a replicação tenha sido cancelada e que nenhuma duplicata dependente exista antes de tentar excluir o volume original.