Expandindo a capacidade de compartilhamento de arquivos

Aumente a capacidade de compartilhamento de arquivos d File Storage for VPC até 32.000 GB sem tempo de inatividade nem migração de dados. A cobrança é atualizada automaticamente para refletir a nova capacidade.

O faturamento para o compartilhamento de arquivos é atualizado automaticamente para incluir a diferença rateada do novo preço para o ciclo de faturamento atual. A nova quantia integral será faturada no próximo ciclo de faturamento.

Conceitos de compartilhamento de arquivos expansível

É possível aumentar a capacidade do compartilhamento de arquivos. O tamanho do compartilhamento de arquivos não pode ser menor do que o tamanho do compartilhamento de arquivos atual.

A capacidade pode ser aumentada para compartilhamentos de arquivos que estão em um estado stable. Sua autorização do usuário é verificada antes que o compartilhamento de arquivo seja expandido. Você pode usar a interface do usuário, a linha de comando, a API ou o Terraform para aumentar a capacidade do compartilhamento de arquivos. É possível ampliar um compartilhamento de arquivos várias vezes, até atingir seu limite máximo de capacidade. Depois que você expandiu o compartilhamento de arquivo, não é possível reduzir a capacidade.

A capacidade expandida é determinada pelo máximo que é permitido pelo perfil de compartilhamento de arquivos.

Selecione a disponibilidade Os compartilhamentos de arquivos regionais criados com o perfil rfs podem ser aumentados para até 32 TB sem restrições.

Os compartilhamentos de arquivos zonais criados com o perfil personalizado dp2 ou o perfil personalizado Deprecated podem ser expandidos dentro do intervalo de IOPS permitido para esse tamanho de compartilhamento de arquivo.

Os compartilhamentos de arquivos zonais criados com um dos perfis de camada de IOPS do Deprecated podem ser expandidos até o tamanho máximo de sua camada de IOPS:

  • Um perfil de propósito geral de 3 IOPS/GB pode ser expandido até 32.000 GB
  • Um perfil de 5 IOPS/GB pode ser expandido até 9.600 GB
  • Um perfil de 10 IOPS/GB pode ser expandido até 4.800 GB

O IOPS é ajustado automaticamente para os perfis de compartilhamento de arquivos em camadas, que estão em desuso, com base no tamanho do compartilhamento de arquivos. Por exemplo, se você expandir um compartilhamento com um perfil de 5 IOPS/GB de 250 GB para 1.000 GB, ele terá um IOPS máximo de 5.000 IOPS (1.000 IOPS de capacidade x 5 IOPS). Como um compartilhamento de arquivos de 5 IOPS/GB pode, potencialmente, chegar a 9.600 GB, o número máximo de IOPS é ajustado para 48.000 IOPS. A capacidade e o IOPS são alterados imediatamente, e não é necessário reiniciar a instância.

É possível monitorar o progresso de sua expansão de compartilhamento de arquivos por meio da IU ou da CLI. Você também pode consultar os eventos de rastreamento de atividades para verificar se o compartilhamento de arquivos foi expandido. Depois que um compartilhamento de arquivos é expandido, não é possível reduzir a capacidade.

Requisitos

O compartilhamento de arquivos deve estar no estado “ stable ” antes que você possa solicitar o aumento da capacidade.

Limitações

As limitações a seguir se aplicam a esta liberação.

  • Os compartilhamentos de arquivos podem se expandir, com as restrições a seguir:
    • Se o compartilhamento de arquivos tiver sido criado com um perfil em camadas que limite a capacidade a menos de 32.000 GB, ele poderá ser expandido apenas até a capacidade permitida para essa camada.
    • Se o compartilhamento de arquivos tiver sido criado com o perfil Personalizado em um intervalo de IOPS que não permita a expansão para 16.000 GB, o compartilhamento poderá ser expandido somente até a capacidade máxima do intervalo especificado.
    • Se o compartilhamento de arquivos tiver sido criado com o perfil dp2 em um intervalo de IOPS que não permita a expansão para 32.000 GB, o compartilhamento poderá ser expandido somente até a capacidade máxima do intervalo especificado.
    • Os compartilhamentos de arquivos podem expandir-se várias vezes até que a capacidade máxima seja atingida.
  • Aumentar o número de IOPS até o máximo permitido pelo perfil.
  • Não é possível modificar de forma independente o IOPS para um compartilhamento de arquivo que foi criado por meio de um perfil de camada IOPS. O IOPS é ajustado quando você aumenta a capacidade.
  • Ao expandir um compartilhamento de arquivo que foi criado a partir de um perfil customizado ou dp2, a capacidade é aumentada, mas o IOPS permanece o mesmo, a menos que você escolha ajustar o IOPS.
  • O número máximo de IOPS para um compartilhamento de arquivos por zona é limitado a 48.000 IOPS, caso seja acessado por um único host. Para um compartilhamento de arquivos por zona acessado por vários hosts, o IOPS pode chegar a até 96.000 IOPS.
  • Depois que um compartilhamento de arquivos é expandido, não é possível reduzir seu tamanho.

Expansão da capacidade de compartilhamento de arquivos no console

Siga estas etapas para ampliar a capacidade de compartilhamento de arquivos no console:

  1. No console IBM Cloud, clique no ícone do menu Navegação > ícone VPC de infraestrutura > Armazenamento > Compartilhamentos de armazenamento de arquivos.

  2. A página da Lista de compartilhamentos de arquivo para VPC mostra todos os compartilhamentos de arquivo que foram criados nessa zona. Clique no nome do compartilhamento de arquivos para acessar a página de detalhes.

  3. Na página de detalhes de compartilhamentos de arquivos, expanda o menu Ações.

  4. Selecione Expandir o compartilhamento de arquivos. O painel “Expandir tamanho do compartilhamento de arquivos” mostra o tamanho atual do compartilhamento de arquivos (em GB) e o perfil ao qual ele está associado. Alternativamente, também é possível clicar no ícone de edição ao lado das informações do tamanho do compartilhamento de arquivo.

  5. Insira um tamanho de compartilhamento de arquivos maior, com base no máximo permitido para o perfil de compartilhamento de arquivos. O padrão é o tamanho atual + 1 GB.

  6. Revise o resumo de pedido mensal estimado para sua geografia e a nova precificação.

  7. Se você estiver satisfeito, clique em Salvar e continuar.

A sua nova alocação de armazenamento de arquivos estará disponível em poucos minutos. Se seus requisitos mudarem, será possível aumentar a capacidade novamente depois que o tamanho do compartilhamento de arquivos for aumentado e quando ele estiver no estado stable.

Não é possível reduzir o tamanho do compartilhamento de arquivos depois de aumentar sua capacidade.

Expandindo compartilhamentos de arquivos a partir do CLI

Para aumentar a capacidade de um compartilhamento de arquivo da CLI, use o comando share-update com a opção --size e indique o novo tamanho do compartilhamento de arquivo em GBs.

  1. Localize seu compartilhamento na CLI listando seus 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

  2. Visualize os detalhes do compartilhamento de arquivo que deseja modificar com o comando ibmcloud is share.

    ibmcloud is share my-file-share

 ```sh {: screen}
 Getting file share my-file-share under account Test Account as user test.user@ibm.com...
 ID                           r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
 Name                         my-file-share
 CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
 Lifecycle state              stable
 Access control mode          security_group
 Accessor binding role        none
 Zone                         us-south-2
 Profile                      dp2
 Size(GB)                     1000
 IOPS                         1000
 User Tags                    docs:test
 Encryption                   provider_managed
 Mount Targets                ID                                          Name
                              r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
 Resource group               ID                                 Name
                              db8e8d865a83e0aae03f25a492c5b39e   Default
 Created                      2023-10-18T22:15:15+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
  1. Execute o comando ibmcloud is share-update para aumentar a capacidade de seu compartilhamento de arquivo
ibmcloud is share-update my-file-share --size 1500

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-file-share
CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state              updating
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-2
Profile                      dp2
Size(GB)                     1500
IOPS                         1000
Encryption                   provider_managed
Mount Targets                ID                                          Name
                             r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
Resource group               ID                                 Name
                             db8e8d865a83e0aae03f25a492c5b39e   Default
Created                      2023-10-18T22:15:15+00:00
Latest job                   Job status   Job status reasons
                             succeeded    -
Replication share            ID                                          Name               Resource type
                             r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share   share
Replication role             source
Replication status           active
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 my-file-share.

Ampliando a capacidade de compartilhamento de arquivos com a API

É possível expandir compartilhamentos de arquivos existentes chamando a API da VPC. Faça uma solicitação PATCH /shares/{id} e especifique o ID do compartilhamento de arquivos para o qual você deseja aumentar o tamanho.

Este exemplo de solicitação expande um compartilhamento de arquivos com capacidade de 50 GB a 2.500 GB para um perfil de 5 IOPS/GB.

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

O status de compartilhamento de arquivos mostra updating enquanto a capacidade é aumentada. A capacidade atual é exibida enquanto está sendo atualizada.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "updating",
  "name": "share-name1",
    .
    .
	"size": 2500,
    .
    .
    .
}

Quando a expansão de compartilhamento de arquivos for concluída, o novo valor será exibido, e o status será stable.

{
  "created_at": "2023-08-08T23:31:59Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63",
  "id": "199d78ec-b971-4a5c-a904-8f37ae710c63",
  "iops": 12500,
  "lifecycle_state": "stable",
  "name": "share-name1",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
    "name": "dp2",
    "resource_type": "share_profile"
  },
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/875623bcde2b4ebda924d32640908845",
    "id": "875623bcde2b4ebda924d32640908845",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 2500,
  .
  .
  .
}

Expandindo compartilhamentos de arquivos com o Terraform

Para aumentar a capacidade de um compartilhamento de arquivo, use o recurso ibm_is_share.. Quando aplicado o exemplo a seguir atualiza a capacidade de compartilhamento para 300 GB.

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

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

Próximas etapas

Monte e use seus compartilhamentos de arquivo: