Renomear um compartilhamento de arquivos no console

1. Na página de detalhes de compartilhamentos de arquivo, clique no ícone Editar ao lado do nome do compartilhamento de arquivos

2. Forneça um novo nome para o compartilhamento de arquivos.

Os nomes de compartilhamento de arquivo 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 compartilhamento de arquivos devem começar com uma letra minúscula.

Como renomear um destino de montagem de um compartilhamento de arquivos no console

1. Acesse a página Detalhes de compartilhamentos de arquivo
2. Clique no ícone Ações .
3. Selecione Renomear.
4. 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 06 de maio de 2026, esses perfis de ações serão descontinuados. Para acessar os recursos atuais, você deve alterar o perfil de IOPS do seu compartilhamento para dp2. Os perfis de compartilhamentos de arquivos que foram 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.

1. Acesse a página Detalhes de compartilhamentos de arquivo
2. 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.
3. 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
4. Clique em “Salvar” e continue.

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.

1. Selecione um compartilhamento de arquivo na lista de compartilhamentos de arquivos.
2. Na página Detalhes do Compartilhamento de Arquivo, localize os modos de criptografia de trânsito permitidos
3. Clique no ícone Editar para alterar o valor atual.

Renomeando um compartilhamento de arquivos pela CLI

1. Localize o compartilhamento de arquivo que deseja renomear listando os compartilhamentos de arquivo na região com o comando ibmcloud is shares. Anote o nome e o ID do compartilhamento de arquivos.

   ibmcloud is shares
   

   Listing 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               -                       -                -
   

2. Execute o comando ibmcloud is share-update e especifique um novo nome de compartilhamento de arquivo com as opções de --name

   ibmcloud is share-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 --name my-renamed-share
   

   Updating file share r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 under account Test Account as user test.user@ibm.com...
   ID                           r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   Name                         my-renamed-share
   CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
   Lifecycle state              stable
   Access control mode          vpc
   Zone                         us-south-2
   Profile                      dp2
   Size(GB)                     100
   IOPS                         100
   Encryption                   ipsec
   Mount Targets                ID                          Name
                                No mounted targets found.
   Resource group               ID                                 Name
                                6edefe513d934fdd872e78ee6a8e73ef   defaults
   Created                      2023-08-01T17:02:01+00:00
   Encryption key               crn:v1:bluemix:public:kms:eu-de:a/a1234567:key:f602ae93-b915-49bc-a0e1-af29c73e7788
   Latest job                   Job status   Job status reasons
                                -            -
   Replication cron spec        00 11 * * 0
   Replication role             replica
   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
   

Os nomes de compartilhamento de arquivo 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 compartilhamento de arquivos devem começar com uma letra minúscula.

Para obter mais informações sobre as opções de comandos, consulte ibmcloud is share-update.

Como renomear um destino de montagem de um compartilhamento de arquivos pela CLI

1. Liste os compartilhamentos de arquivo na região com o comando ibmcloud is shares Anote o nome e o ID do compartilhamento de arquivo que tem o destino de montagem que você deseja renomear..

2. 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-fbefdc1e1e03
   

   Listing 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
   

3. Para renomear o destino de montagem, execute o comando share-mount-target-update com 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 --name

   ibmcloud 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 06 de maio de 2026, esses perfis de ações serão descontinuados. Para acessar os recursos atuais, você deve alterar o perfil de IOPS do seu compartilhamento para dp2. Os perfis de compartilhamentos de arquivos que foram criados com o perfil dp2 ou rfs não podem ser alterados.

1. Localize o compartilhamento de arquivo que deseja atualizar listando os compartilhamentos de arquivo na região com o comando ibmcloud is shares.

   ibmcloud is shares
   

   Listing 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               -                       -                -
   

2. Use o comando share-update com o parâmetro --profile para indicar o novo perfil de compartilhamento de arquivo por nome

   ibmcloud is share-update my-old-file-share --profile dp2 --size 1000 --iops 3000
   

   Updating 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, ou none.
• Para compartilhamentos de arquivos regionais, os valores permitidos são stunnel,none, stunnel, ou none.

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

Renomeando um compartilhamento de arquivos com a API

Faça uma chamada PATCH /shares/$share_id para renomear um compartilhamento de arquivo específico. Consulte o exemplo a seguir.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"\
  -d '{"name": "share-renamed1"}'

Uma resposta bem-sucedida se parece com o exemplo a seguir.

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-17T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "id": "0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "share-renamed1",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-10iops",
    "name": "tier-10iops",
    "resource_type": "share_profile"
  },
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "id": "bfb4a7c7-00d8-400b-98ba-5a67e5851970",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 100,
  "mount_targets": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Os nomes de compartilhamento de arquivo 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 compartilhamento de arquivos devem começar com uma letra minúscula.

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 06 de maio de 2026, esses perfis de ações serão descontinuados. Para acessar os recursos atuais, você deve alterar o perfil de IOPS do seu compartilhamento para dp2. Os perfis de compartilhamentos de arquivos que foram 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, ou none.
• Para compartilhamentos de arquivos regionais, os valores permitidos são stunnel,none, stunnel, ou none.

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"}'

Atualizando atributos de um compartilhamento de arquivo com o Terraform

Atualize o recurso ibm_is_share para alterar quaisquer atributos do compartilhamento de arquivo, como nome, tamanho, perfil, identificações. Quando aplicado, o seguinte exemplo atualiza o nome do compartilhamento para new_name.

resource "ibm_is_share" "example" {
  name    = "new_name"
  size    = 300
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
}

Os nomes válidos para compartilhamento de arquivos e destinos de montagem podem incluir uma combinação de caracteres alfanuméricos em letras minúsculas (a-z, 0-9) e o hífen (-), com até 63 caracteres. Os nomes de compartilhamento de arquivos devem começar com uma letra minúscula.

Alguns atributos, como perfil, modos de criptografia de trânsito permitidos e criptografia em repouso, não são editáveis para compartilhamentos de acessantes.

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, ou none.
• Para compartilhamentos de arquivos regionais, os valores permitidos são stunnel,none, stunnel, ou none.

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.

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_share.

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.