Ajuste do limite de largura de banda para um compartilhamento de arquivos regional

Selecione a disponibilidade Os clientes com acesso especial para visualizar a nova oferta de compartilhamento de arquivos regionais podem usar o perfil rfs para criar compartilhamentos de arquivos com disponibilidade de dados regionais e valores de largura de banda ajustáveis.

Ajuste a largura de banda para compartilhamentos de arquivos regionais com o perfil rfs de 800 a 8192 Mbps (1024 MBps) para a taxa de transferência combinada de leitura e gravação. Gerencie o limite de largura de banda pelo console, pela CLI ou pela API.

Com esse recurso, você pode aumentar ou diminuir o limite de largura de banda do seu compartilhamento no console, na CLI ou com a API. Para alterar esse atributo, o compartilhamento deve estar em um estado disponível. Sua autorização de usuário é verificada antes que o limite de largura de banda seja ajustado.

A cobrança referente a um compartilhamento de arquivos atualizado é atualizada automaticamente. A diferença rateada do novo preço é incluída no ciclo de faturamento atual. A nova quantia integral será faturada no próximo ciclo de faturamento.

Ajuste da largura de banda no console

  1. Acesse a lista de todos os compartilhamentos de arquivos. No console IBM Cloud, clique no ícone do menu Navegação > ícone VPC de infraestrutura > Armazenamento > Compartilhamentos de armazenamento de arquivos.
  2. Clique no nome de um compartilhamento de arquivo para ver a página de detalhes.
  3. Localize a seção Profile (Perfil ) e clique no ícone Edit(Editar) ) ou use o menu Actions ( Ações) s ) e selecione Edit bandwidth (Editar largura de banda).
  4. No painel lateral, você pode especificar um limite de largura de banda de compartilhamento de arquivos entre o valor mínimo de 800 e o máximo de 8192 Mbps.
  5. Analise o resumo do pedido mensal estimado.
  6. Se você estiver satisfeito, clique em Salvar e continuar.

Ajuste da largura de banda na CLI

Na CLI, use o comando ibmcloud is share-update com a opção --bandwidth para indicar o novo valor de largura de banda para um perfil personalizado.

ibmcloud is share-update share_ID --bandwidth BANDWIDTH

Este exemplo mostra um aumento do limite de largura de banda para 3.000 Mbps.

ibmcloud is share-update my-file-share --bandwidth 2000

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                    stable
   Access control mode                security_group
   Accessor binding role              none
   Allowed transit encryption modes   stunnel,none
   Zone                               us-south-1
   Profile                            rfs
   Size(GB)                           1000
   IOPS                               35000
   Bandwidth                          3000
   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                            2025-09-23T22: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           nsf4
   Availability Mode                  zonal
   Storage Generation                 2

Os compartilhamentos de arquivos com disponibilidade regional servem dados em todas as zonas da região. A resposta do comando mostra a primeira zona da região por padrão.

Para obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is share-update.

Ajustar a largura de banda com a API

Você pode ajustar a largura de banda dos compartilhamentos de dados existentes chamando a API do VPC. Faça uma solicitação PATCH /shares e especifique o parâmetro bandwidth para ajustar o limite de largura de banda.

Não é possível atualizar o nome do compartilhamento, aumentar o tamanho, ajustar o IOPS e ajustar o limite de largura de banda na mesma solicitação PATCH /shares. Faça solicitações separadas para PATCH /shares.

Este exemplo mostra o valor da largura de banda aumentado para 3.000 Mbps.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2025-09-23&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "bandwidth": 3000
    }'

O status do compartilhamento de arquivos exibe “ updating ” enquanto a largura de banda está sendo ajustada. A largura de banda predefinida é exibida até que a atualização seja concluída.

{
	"bandwidth": 400,
	"created_at": "2025-09-23T09:46:43.000Z",
	"crn": "crn:v1:bluemix:public:is:us-east-1:a/<Acc id>::share:<file shareID>",
    .
    .
    .
	"status": "updating",
    .
    .
    .
}

Ajuste do limite de largura de banda com o Terraform

Para modificar o IOPS de um compartilhamento, use o recurso ibm_is_share. Quando aplicado, o exemplo a seguir atualiza o limite de largura de banda do compartilhamento de arquivos para 4.000 Mbps.

resource "ibm_is_share" "storage" {
   name         = "demo-share-update"
   size         = 8000
   bandwidth    = 4000
}

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