Gerenciando compartilhamentos de arquivos, ligações de compartilhamento do acessador e destinos de montagem
Gerencie compartilhamentos d File Storage for VPC: renomeie-os, aumente a capacidade, ajuste o IOPS e a largura de banda, adicione destinos de montagem e gerencie as ligações de acesso aos compartilhamentos.
File Storage for VPC requer permissões de IAM para controle de acesso baseado em função. Por exemplo, para criar um compartilhamento de arquivos, é necessário ter, no mínimo, permissões de editor. Para obter mais informações, consulte Gerenciando o acesso ao IAM para serviços de infraestrutura VPC para compartilhamentos de arquivos.
Gerenciamento de compartilhamentos de arquivos, associações de compartilhamento de acessório e alvos de montagem no console
No console, você pode:
- Renomear um compartilhamento de arquivos.
- Renomear um destino de montagem de um compartilhamento de arquivos.
- Atualizar um perfil de compartilhamento de arquivo (não aplicável para compartilhamentos do acessador).
- Atualizar modos de criptografia de trânsito permitidos (não aplicável para compartilhamentos do acessador).
- Aumentar a capacidade de compartilhamento de arquivos
- Ajuste o IOPS para um compartilhamento de arquivos por zona
- Ajustar o limite de largura de banda para um compartilhamento de arquivos regional
- Adicione tags de usuário aos compartilhamentos de arquivos.
- Excluir o destino de montagem de um compartilhamento de arquivos.
- Excluir um compartilhamento de arquivos.
No console, é possível gerenciar compartilhamentos de arquivos normais e compartilhamentos do acessador. Apenas o proprietário do compartilhamento pode modificar propriedades como modo de controle de acesso, IOPS e perfil.. A conta do acessador não pode editar o compartilhamento de origem, e pode modificar um conjunto menor de propriedades do compartilhamento do acessador.
Os instantâneos são suportados somente para compartilhamentos que têm o grupo de segurança como modo de controle de acesso. Não é possível alterar o modo de controle de acesso para VPC, a menos que todos os instantâneos do compartilhamento sejam excluídos.
Como renomear um destino de montagem de um compartilhamento de arquivos no console
- Acesse a página Detalhes de compartilhamentos de arquivo
- Clique no ícone Ações
.
- Selecione Renomear.
- Insira um novo nome e clique em Renomear.
Os nomes de destino de montagem válidos podem incluir uma combinação de caracteres alfanuméricos minúsculos (a-z, 0-9) e o hífen (-), até 63 caracteres. Os nomes de destino de montagem devem começar com uma letra minúscula.
Atualização de um perfil de compartilhamento de arquivos no console
Essas instruções se referem à geração anterior de perfis de compartilhamento de arquivos (finalidade geral, 5-iops, 10-iops ou personalizado) que foram usados na versão beta dos compartilhamentos de arquivos zonais. A partir de 6 de maio de
2026, os perfis dessas ações são Deprecated. Para acessar os recursos atuais, você deve alterar o perfil de IOPS do seu compartilhamento para dp2. Os perfis de compartilhamentos de arquivos criados
com o perfil “ dp2 ” ou “ rfs ” não podem ser alterados.
É possível mudar o perfil para um compartilhamento de arquivo do perfil atual para outro perfil de camada de IOPS, para um perfil customizado, ou para um perfil de alto desempenho dp2 Sua cobrança é ajustada com base no perfil que você escolher.
- Acesse a página Detalhes de compartilhamentos de arquivo
- Clique no ícone Editar
próximo ao perfil atual ou use o menu Ações
e selecione Editar perfil do IOPS Um painel lateral mostra o perfil atual, o tamanho do compartilhamento de arquivo e o IOPS máximo.
- Para um Novo perfil, clique na flecha para baixo É possível selecionar uma nova camada de IOPS, um perfil customizado ou dp2. Para IOPS customizado ou dp2, especifique um novo IOPS máximo com base no tamanho do compartilhamento de arquivo. O preço da ação de arquivo é calculado automaticamente com base em sua seleção
- Clique em “Salvar e continuar ”.
Atualização dos modos de criptografia de trânsito permitidos no console
O proprietário de um compartilhamento pode alterar os modos de criptografia de trânsito permitidos. Entretanto, antes que essa propriedade possa ser alterada, todas as ligações devem ser excluídas. A exclusão das ligações separa o caminho de rede entre o compartilhamento de arquivo de origem e o compartilhamento do acessador e coloca o destino de montagem que está anexado ao compartilhamento do acessador em um estado com falha Para obter mais informações, consulte Removendo acesso a um compartilhamento de arquivo de outras contas.
- Selecione um compartilhamento de arquivo na lista de compartilhamentos de arquivos.
- Na página Detalhes do Compartilhamento de Arquivo, localize os modos de criptografia de trânsito permitidos
- Clique no ícone Editar
para alterar o valor atual.
Gerenciando compartilhamentos de arquivos, ligações de compartilhamento do acessador e destinos de montagem a partir da CLI
Ao usar a CLI, você pode:
- Renomear um compartilhamento de arquivos.
- Renomear um destino de montagem de um compartilhamento de arquivos.
- Atualizar um perfil de compartilhamento de arquivo (não aplicável para compartilhamento do acessador).
- Atualizar modos de criptografia de trânsito permitidos (não aplicável para o compartilhamento do acessador).
- Aumentar a capacidade de compartilhamento de arquivos
- Ajuste o IOPS para um compartilhamento de arquivos por zona
- Ajustar o limite de largura de banda para um compartilhamento de arquivos regional
- Adicione tags de usuário aos compartilhamentos de arquivos.
- Excluir o destino de montagem de um compartilhamento de arquivos.
- Excluir um compartilhamento de arquivos.
Os instantâneos são suportados somente para compartilhamentos que têm o grupo de segurança como modo de controle de acesso. Não é possível alterar o modo de controle de acesso para VPC, a menos que todos os instantâneos do compartilhamento sejam excluídos.
Renomeando um destino de montagem de um compartilhamento de arquivos pela CLI
-
Liste os compartilhamentos de arquivo na região com o comando
ibmcloud is sharesAnote o nome e o ID do compartilhamento de arquivo que tem o destino de montagem que você deseja renomear.. -
Use o nome ou ID do compartilhamento para localizar seus destinos de montagem com o comando
ibmcloud is share-mount-targets.ibmcloud is share-mount-targets r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03Listing share mount target of r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 in all resource groups and region us-south under account Test Account as user test.user@ibm.com... ID Name VPC Lifecycle state Transit Encryption r006-fdbffc45-618c-49f1-bb08-ec530d7be378 my-source-mount-target my-vpc stable none -
Para renomear o destino de montagem, execute o comando
share-mount-target-updatecom o nome ou ID do compartilhamento de arquivo e o nome do destino de montagem. Especifique um novo nome de destino de montagem com a opção--nameibmcloud is share-mount-target-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 r006-fdbffc45-618c-49f1-bb08-ec530d7be378 --name my-renamed-mount-target
Os nomes de destino de montagem válidos podem incluir uma combinação de caracteres alfanuméricos minúsculos (a-z, 0-9) e o hífen (-), até 63 caracteres. Os nomes de destino de montagem devem começar com uma letra minúscula.
Para obter mais informações sobre as opções de comandos, consulte ibmcloud is share-mount-target-update.
Atualização de um perfil de compartilhamento de arquivos na CLI
Essas instruções se referem à geração anterior de perfis de compartilhamento de arquivos (finalidade geral, 5-iops, 10-iops ou personalizado) que foram usados na versão beta dos compartilhamentos de arquivos zonais. A partir de 6 de maio de
2026, os perfis dessas ações são Deprecated. Para acessar os recursos atuais, você deve alterar o perfil de IOPS do seu compartilhamento para dp2. Os perfis de compartilhamentos de arquivos criados
com o perfil “ dp2 ” ou “ rfs ” não podem ser alterados.
-
Localize o compartilhamento de arquivo que deseja atualizar listando os compartilhamentos de arquivo na região com o comando
ibmcloud is shares.ibmcloud is sharesListing 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 Accessor binding role Snapshot count Snapshot size r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 my-file-share stable us-south-2 dp2 10 defaults none none 0 0 r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940 my-file-share-2 stable us-south-2 dp2 10 defaults none none 0 0 r006-a60bfa90-a893-40ad-be34-28ab51a963f9 replica-dal-2 stable us-south-2 dp2 10 defaults replica none 0 0 r006-3f21e3c3-e12d-425f-ab77-810cabfde8df source-dal-1 stable us-south-1 dp2 10 defaults source none 0 0 r006-455b601c-8fc1-4476-8771-4708c49c8ef7 my-replica-share-dal-1 stable us-south-1 dp2 10 defaults replica none 0 0 r006-4dadac27-cd17-42df-a5fe-1388705d33e0 my-source-share-dal-2 stable us-south-2 dp2 10 defaults source none 0 0 r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f my-old-file-share stable us-south-1 tier-3iops 40 defaults none - - - -
Use o comando
share-updatecom o parâmetro--profilepara indicar o novo perfil de compartilhamento de arquivo por nomeibmcloud is share-update my-old-file-share --profile dp2 --size 1000 --iops 3000Updating file share my-file-share-8 under account Test Account as user test.user@ibm.com... ID r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f Name my-old-file-share CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f Lifecycle state updating Access control mode vpc Zone us-south-1 Profile dp2 Size(GB) 1000 IOPS 3000 User Tags env:dev,env:prod Encryption provider_managed Mount Targets ID Name r006-c9d82a15-7ead-4388-abc8-88e81c12ed28 my-target121 Resource group ID Name 6edefe513d934fdd872e78ee6a8e73ef defaults Created 2023-03-27T20:43:36+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 obter mais informações sobre as opções de comandos, consulte ibmcloud is share-update.
Atualização dos modos de criptografia de trânsito permitidos na CLI
O proprietário do compartilhamento pode atualizar os modos de criptografia de trânsito permitidos com os seguintes valores.
- Para compartilhamentos de arquivos zonais, os valores permitidos são
ipsec,none,ipsec, ounone. - Para compartilhamentos de arquivos regionais, os valores permitidos são
stunnel,none,stunnel, ounone.
No entanto, antes que essa propriedade possa ser alterada, todos os vínculos e alvos de montagem devem ser excluídos. A exclusão das ligações separa o caminho de rede entre o compartilhamento de arquivo de origem e o compartilhamento do acessador e coloca o destino de montagem que está anexado ao compartilhamento do acessador em um estado com falha Para obter mais informações, consulte Remoção de acesso a um compartilhamento de arquivos de outras contas.
ibmcloud is share-update my-origin-share --allowed-transit-encryption-modes ipsec
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-origin-share
CRN crn:v1:bluemix:public:is:us-south-2:a/1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state stable
Access control mode security_group
Accessor binding role origin
Allowed transit encryption modes ipsec
Origin share CRN Name Remote account Remote region
crn:v1:bluemix:public:is:us-south-2:a/7654321::share:r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed my-origin-share a7654321 -
Zone us-south-2
Profile dp2
Size(GB) 1000
IOPS 1000
Encryption provider_managed
Mount Targets ID Name
No mounted targets found.
Resource group ID Name
db8e8d865a83e0aae03f25a492c5b39e Default
Created 2024-06-25T22:15:15+00:00
Replication role none
Replication status none
Replication status reasons Status code Status message
- -
Allowed Access Protocols nfs4
Availability Mode zonal
Bandwidth(Mbps) 1
Storage Generation 1
Gerenciando compartilhamentos de arquivos, ligações de compartilhamento do acessador e destinos de montagem com a API..
Ao usar a API, você pode:
- Renomear um compartilhamento de arquivos.
- Renomear um destino de montagem de um compartilhamento de arquivos.
- Atualizar um perfil de compartilhamento de arquivo (não aplicável para compartilhamentos do acessador).
- Atualizar modos de criptografia de trânsito permitidos com a API (não aplicável para compartilhamentos do acessador).
- Aumentar a capacidade de compartilhamento de arquivos
- Ajuste o IOPS para um compartilhamento de arquivos por zona
- Ajustar o limite de largura de banda para um compartilhamento de arquivos regional
- Adicione tags de usuário aos compartilhamentos de arquivos.
- Excluir o destino de montagem de um compartilhamento de arquivos.
- Excluir um compartilhamento de arquivos.
Para ver informações sobre os métodos de API File Storage for VPC, veja a seção a seguir na referência da API.
Os instantâneos são suportados somente para compartilhamentos que têm o grupo de segurança como modo de controle de acesso. Não é possível alterar o modo de controle de acesso para VPC, a menos que todos os instantâneos do compartilhamento sejam excluídos.
Como renomear um destino de montagem de um compartilhamento de arquivos usando a API
Execute uma chamada PATCH /shares/$share_id/mount_targets/$target_id para renomear um destino de montagem de um compartilhamento de arquivos. Consulte o exemplo a seguir.
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$target_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer ${API_TOKEN}" \
-d '{"name": "target-renamed1"}
Uma resposta bem-sucedida se parece com o exemplo a seguir.
{
"access_control_mode": "vpc",
"created_at": "2023-07-18T23:31:59Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
"id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
"lifecycle_state": "stable",
"mount_path": "domain.com:/vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
"name": "target-renamed1",
"resource_type": "share_target",
"transit_encryption": "none",
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs8c95b3c1-fe3c-45c-97a6-e43d14088287",
"id": "82a7b841-9586-43b4-85dc-c0ab5e8b1c7a",
"name": "vpc-name1",
"resource_type": "vpc"
}
}
Os nomes de destino de montagem válidos podem incluir uma combinação de caracteres alfanuméricos minúsculos (a-z, 0-9) e o hífen (-), até 63 caracteres. Os nomes de destino de montagem devem começar com uma letra minúscula.
Atualização de um perfil de compartilhamento de arquivos por meio da API
Essas instruções se referem à geração anterior de perfis de compartilhamento de arquivos (finalidade geral, 5-iops, 10-iops ou personalizado) que foram usados na versão beta dos compartilhamentos de arquivos zonais. A partir de 6 de maio de
2026, os perfis dessas ações são Deprecated. Para acessar os recursos atuais, você deve alterar o perfil de IOPS do seu compartilhamento para dp2. Os perfis de compartilhamentos de arquivos criados
com o perfil “ dp2 ” ou “ rfs ” não podem ser alterados.
Faça uma chamada de PATCH /shares/{share_ID} e especifique o nome do perfil na propriedade profile O seguinte exemplo altera o perfil para um perfil dp2.
curl -X PATCH "$vpc_api_endpoint/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{"profile": {"name": "dp2"}}'
Atualizando os modos de criptografia de trânsito permitidos com a API
O proprietário do compartilhamento pode atualizar os modos de criptografia de trânsito permitidos com os seguintes valores.
- Para compartilhamentos de arquivos zonais, os valores permitidos são
ipsec,none,ipsec, ounone. - Para compartilhamentos de arquivos regionais, os valores permitidos são
stunnel,none,stunnel, ounone.
No entanto, antes que essa propriedade possa ser alterada, todos os vínculos e alvos de montagem devem ser excluídos. A exclusão das ligações separa o caminho de rede entre o compartilhamento de arquivo de origem e o compartilhamento do acessador e coloca o destino de montagem que está anexado ao compartilhamento do acessador em um estado com falha Para obter mais informações, consulte Removendo acesso a um compartilhamento de arquivo de outras contas.
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer ${API_TOKEN}"
-d '{"allowed_transit_encryption_modes": "ipsec"}'
Gerenciando compartilhamentos de arquivos, ligações de compartilhamento do acessador e destinos de montagem com o Terraform
Com o Terraform, é possível:
- Alterar atributos de compartilhamento de arquivo como nome, tamanho, perfil, tags,
- Inclua ou remova um relacionamento de réplica
- Mude o nome de um destino de montagem
- Exclua um compartilhamento de arquivo ou um destino de montagem
Atualizando atributos de um destino de montagem com o Terraform
Atualize o recurso ibm_is_share_mount_target para alterar o nome do destino de montagem.. Quando aplicado, o recurso a seguir muda o nome do destino de montagem para my-new-share-target..
resource "ibm_is_share_mount_target" "is_share_target" {
access_protocol = "nfs4"
name = "my-new-share-target"
share = is_share.is_share.id
subnet = ibm_is_subnet.example.id
}`
Para obter mais informações sobre argumentos e atributos, consulte ibm_is_share_target.
Removendo o acesso a um compartilhamento de arquivo de outras contas
Revogar o acesso a um compartilhamento de arquivo é um processo de duas etapas.
- Remova a autorização do IAM entre as contas A remoção da autorização do IAM impede que a outra conta ou serviço crie um compartilhamento de acessador e destino de montagem.
- Removendo uma autorização no consoleRemovendo uma autorização usando a CLI Removendo uma autorização usando a APIRemovendo uma autorização usando o Terraform
- Exclua a ligação de compartilhamento que conecta o compartilhamento de origem com o compartilhamento do acessador Essa ação faz o destino de montagem da outra conta entrar em um estado
failed.
Montando e desmontando compartilhamentos de arquivos em uma instância de servidor virtual
A montagem é o processo pelo qual o sistema operacional de um servidor disponibiliza arquivos e diretórios no dispositivo de armazenamento para os usuários acessarem por meio do sistema de arquivos do servidor. Para montar um compartilhamento de arquivos em uma instância de servidor virtual, localize as informações do caminho de montagem. O caminho de montagem é criado quando você define um destino de montagem para o compartilhamento de arquivos. Consulte as informações a seguir para a instalação em alguns sistemas operacionais Linux. Outras distribuições do Linux seguem procedimentos semelhantes.
Monitoramento de compartilhamentos de arquivos
Você pode verificar o status e os estados de integridade do seu compartilhamento de arquivos usando o console, a CLI ou a API. Você pode monitorar a largura de banda total, o IOPS total, o número de alvos de montagem e o uso da capacidade do seu compartilhamento ao longo do tempo no console IBM Cloud. Você pode usar IBM Cloud® Activity Tracker Event Routing para configurar como encaminhar eventos de auditoria para compartilhamentos de arquivos. Você também pode configurar o IBM Cloud Logs Routing para lidar com os registros. Para obter mais informações, consulte Monitoramento dos estados de integridade do compartilhamento de arquivos, status do ciclo de vida e eventos.
Os compartilhamentos de arquivos podem ser integrados com IBM Cloud® Monitoring para obter visibilidade operacional do desempenho e da integridade de seus compartilhamentos. Na interface do usuário da Web da Sysdig, você pode visualizar as métricas de largura de banda, IOPS e capacidade com mais detalhes, personalizar seus painéis e configurar alertas. Para obter mais informações, consulte Métricas de monitoramento para o File Storage for VPC.
Exclusão de compartilhamentos de arquivos, associações de compartilhamento de acessório e alvos de montagem
Antes de excluir um compartilhamento de arquivos, certifique-se de que ele esteja desmontado de todas as instâncias de servidor virtual e que todos os destinos de montagem pertencentes ao compartilhamento de arquivos tenham sido excluídos. Se seu compartilhamento de arquivo for compartilhado com outra conta, exclua as ligações do acessador antes de excluir o compartilhamento.. Além disso, se o compartilhamento de arquivo tiver um compartilhamento de arquivo de réplica, você deverá remover o relacionamento de replicação. Para obter mais informações, consulte Remover a relação de replicação no consoleRemover a relação de replicação do CLIRemovera relação de replicação com o APIRemovera relação de replicação com o Terraform.
Como apagar definitivamente seus dados antes de excluir um compartilhamento de arquivos
Ao excluir um compartilhamento de arquivos, o sistema “ IBM ” garante que seus dados fiquem inacessíveis no disco físico e sejam, por fim, eliminados. Caso haja requisitos adicionais de conformidade, como as Diretrizes NIST 800-88 para a limpeza de mídias, é necessário realizar procedimentos de limpeza de dados antes de excluir seus compartilhamentos de arquivos. Para obter mais informações, consulte as Diretrizes do NIST 800-88 para a higienização de mídias.
A higienização do compartilhamento de arquivos antes da exclusão garante que os dados residuais no disco físico não possam ser detectados ou reconstruídos, mesmo que a mídia venha a cair em mãos alheias ao controle d IBM.