Ajuste de IOPS para um compartilhamento de arquivos em zonas

Ajuste os limites de operações de entrada/saída por segundo (IOPS) para compartilhamentos de arquivos zonais com o perfil “ dp2 ” de 100 a 96.000 IOPS, sem interrupção do serviço.

As alterações entram em vigor imediatamente, sem interrupção do serviço. É possível gerenciar o limite de IOPS por meio do console, da CLI, da API ou do Terraform.

O faturamento para um compartilhamento atualizado é atualizado 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.

Selecione a disponibilidade Não é possível modificar o valor de IOPS dos compartilhamentos de arquivos regionais criados com o perfil rfs. No entanto, você pode ajustar o valor da largura de banda para aperfeiçoar o desempenho do compartilhamento.

Conceitos de IOPS ajustáveis

Você pode ajustar o IOPS dos seus compartilhamentos de arquivos por zona para otimizar o desempenho de acordo com suas necessidades.

Por exemplo, você pode perceber que uma aplicação foi dimensionada de tal forma que o limite atual de IOPS agora se tornou um gargalo de desempenho. Você pode alterar as características de desempenho do compartilhamento de arquivos existente aumentando o IOPS.
Em outro cenário, talvez seja recomendável definir inicialmente o armazenamento de arquivos em um nível mais alto de IOPS para agilizar o upload de dados. Após a conclusão do upload, você pode redefinir o armazenamento para 5 IOPS/GB para operações normais. Ou, você pode querer aumentar o IOPS de seu compartilhamento de arquivo durante os horários de pico para seu aplicativo e diminuir o IOPS durante os horários fora de pico.

Quando seu compartilhamento usa o perfil dp2 o IOPS do compartilhamento pode variar de 100 a 96.000. Você pode especificar seu valor de IOPS com restrições mínimas. O IOPS pode ser ajustado várias vezes até que o limite máximo ou mínimo seja atingido.

Para que os 96.000 IOPS sejam alcançados, um único compartilhamento de arquivos deve ser acessado por várias instâncias de servidores virtuais. Um único compartilhamento de arquivo acessado por um cliente está limitado a 48.000 IOPS.

Quando o compartilhamento de arquivos usa o perfil de compartilhamento personalizado Deprecated, o intervalo de IOPS é baseado no tamanho do compartilhamento de arquivos.

Por exemplo, para um compartilhamento de arquivo de 25 GB, é possível aumentar IOPS em qualquer lugar no intervalo de 100 a 1.000 IOPS com um perfil customizado. Se, posteriormente, você aumentar o tamanho de um compartilhamento de arquivos para a faixa imediatamente superior, poderá aumentar o IOPS novamente. O IOPS pode ser ajustado várias vezes até que o limite máximo ou mínimo seja atingido.
Ou você pode mudar de um perfil personalizado para um perfil de camada de IOPS ou para o perfil dp2. A seleção da camada de IOPS é restrita pelo tamanho do compartilhamento de arquivos. Quando você muda de um perfil personalizado para qualquer perfil em camadas, o faturamento é atualizado e o IOPS é ajustado de acordo com o perfil.

Quando o compartilhamento de arquivos usa um dos perfis de compartilhamento em camadas do Deprecated, você pode ajustar o limite de IOPS:

Mudança de um perfil de nível IOPS para o perfil dp2 ou custom. Nesse caso, o tamanho do compartilhamento de arquivos limita o intervalo de IOPS que você seleciona.
- Por exemplo, se você estiver ajustando o IOPS para compartilhamento de arquivos com um perfil de 3 IOPS/GB e ele tiver 12.000 GB, poderá ajustar o IOPS usando um perfil personalizado ou dp2. Isso é possível porque ambos suportam um tamanho de compartilhamento de 12.000 GB.
- Se o tamanho do compartilhamento de arquivos fosse maior que 16.000 GB, o perfil personalizado não daria suporte ao ajuste de IOPS, mas o perfil dp2 daria, pois ele dá suporte a tamanhos de compartilhamento de até 32.000 GB. Os tamanhos máximos dos níveis de IOPS são 32.000 GB para 3 IOPS/GB, 9.600 GB para 5 IOPS/GB e 4.800 GB para 10 IOPS/GB.
Ao mudar de um perfil em camadas para um perfil personalizado ou “ dp2 ”, a cobrança é atualizada com base no IOPS especificado.
Selecionando um nível de IOPS diferente. O IOPS é ajustado dentro do nível. O nível até o qual as IOPS podem ser aumentadas é determinado pelo valor máximo permitido pelo perfil de nível de IOPS do compartilhamento de arquivos. É possível ajustar o IOPS para uma camada de IOPS com base no tamanho do compartilhamento ou selecionar o próximo perfil que permita o aumento do desempenho.

O valor máximo de IOPS para um compartilhamento de arquivos com um perfil de camada de 3 IOPS/GB é de 96.000 IOPS. Todos os outros perfis são limitados em 48.000 IOPS. Para que 96.000 IOPS seja realizado, um único compartilhamento de arquivo deve ser acessado por várias instâncias de servidor virtual. Um único compartilhamento de arquivos acessado por uma instância está limitado a 48.000 IOPS.

Para ajustar um IOPS de compartilhamento de arquivo, o compartilhamento de arquivo deve estar em um estado estável. Sua autorização do usuário é verificada antes que o IOPS seja ajustado.

É possível monitorar o progresso da mudança de IOPS do seu compartilhamento de arquivo por meio da IU ou da CLI. Você também pode verificar os eventos de monitoramento de atividades para confirmar se as IOPS foram ajustadas.

Limitações

As limitações a seguir aplicam-se.

Para ajustar o IOPS, o compartilhamento de arquivo deve estar em um estado estável.
Um dp2 perfil pode expandir para o máximo permitido pela banda dp2. Não é possível mudar as faixas de IOPS d dp2, a menos que você aumente o tamanho do compartilhamento de arquivos e, em seguida, mude para uma faixa superior.
Para um compartilhamento de arquivos criado com um perfil da camada IOPS para aumentar ou diminuir o IOPS, selecione um perfil diferente para o tamanho do compartilhamento de arquivos. Se o tamanho do compartilhamento de arquivo exceder o do novo perfil da camada IOPS, não será possível mudar o perfil.
Um perfil IOPS customizado pode expandir para o máximo permitido pela banda customizada. Não é possível mudar de faixa personalizada a menos que você aumente o tamanho do compartilhamento de arquivos e, em seguida, mude para uma faixa superior.
Ajustar IOPS movendo entre perfis é restrito pelo tamanho do compartilhamento de arquivo.
O IOPS máximo para um compartilhamento de arquivo para todos os perfis é 96.000 IOPS. Para que 96.000 IOPS seja realizado, um único compartilhamento de arquivo deve ser acessado por várias instâncias de servidor virtual. Um único compartilhamento de arquivos em uma instância está limitado a 48.000 IOPS.

Ajuste de IOPS no console

Siga estas etapas para ajustar as IOPS selecionando uma nova camada de IOPS ou faixa de IOPS customizadas:

Acesse a lista de compartilhamentos de arquivos. No console IBM Cloud, clique no menu Navegação > de infraestrutura > Armazenamento > Compartilhamentos de armazenamento de arquivos. Por padrão, os compartilhamentos de arquivo são exibidos para todos os grupos de recursos da sua região.
Na página da lista Compartilhamentos de arquivo para VPC, clique no nome de um compartilhamento de arquivo para ver seus detalhes.
Na página de detalhes do compartilhamento de arquivos, localize “Perfil” e clique no ícone ou use o menu “Ações ” e selecione “Editar perfil de IOPS ”. Os volumes devem ser conectados a uma instância de servidor virtual para essas ações.
No painel lateral, ajuste as IOPS como a seguir:
- Para o perfil “ dp2 ” ou o perfil personalizado, são exibidos o valor atual de IOPS e o tamanho do compartilhamento de arquivos. Insira um novo valor de IOPS no intervalo permitido para esse tamanho.
- Para um nível de IOPS, selecione um nível diferente no menu. Por exemplo, você pode ter um perfil de uso geral IOPS/GB de 3 que você deseja aumentar para um perfil IOPS/GB de 5.
Revise o resumo de pedido mensal estimado para sua geografia e a nova precificação.
Se você estiver satisfeito, clique em Salvar e continuar. Sua nova alocação de IOPS entra em vigor quando você reiniciar a instância.

Ajustando IOPS por meio da CLI

Ajustando o IOPS para um perfil customizado ou dp2

Na CLI, use o comando share-update com a propriedade --iops para indicar o novo valor de IOPS para um perfil personalizado ou do tipo “ dp2 ”. O valor de IOPS indicado deve estar dentro do intervalo correspondente ao tamanho do compartilhamento de arquivos. Para obter mais informações, consulte o " dp2 ou o " Perfil de IOPS personalizado.

Para usar a CLI, deve-se instalar a CLI da IBM Cloud e o plug-in da CLI da VPC. Para obter mais informações, consulte os Pré-requisitos da CLI.

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
r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   stable            us-south-1   dp2       1500       Default          replica
r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share    stable            us-south-2   dp2       1500       Default          source
r006-6d1719da-f790-45cc-9f68-896fd5673a1a   my-replica-share        stable            us-south-3   dp2       1500       Default          replica
r006-925214bc-ded5-4626-9d8e-bc4e2e579232   my-new-file-share       stable            us-south-2   dp2       500        Default          none
r006-b1707390-3825-41eb-a5bb-1161f77f8a58   my-vpc-file-share       stable            us-south-2   dp2       1000       Default          none
r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6   my-file-share           stable            us-south-2   dp2       1500       Default          source

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

ibmcloud is share my-file-share

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              -

Use o comando ibmcloud is share-update para aumentar ou diminuir as IOPS de seu compartilhamento de arquivo

ibmcloud is share-update my-file-share --iops 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              updating
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-2
Profile                      dp2
Size(GB)                     1000
IOPS                         2000
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

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

Ajustando o IOPS especificando um perfil de camada de IOPS diferente

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 compartilhamento serão descontinuados. Para acessar os recursos mais recentes, você deve alterar o perfil de IOPS do seu compartilhamento para dp2.

Na CLI, use o comando ibmcloud is share-update com a propriedade --profile e indique o nome ou href do perfil da camada IOPS.

O exemplo a seguir altera um perfil de 3 IOPS/GB para um perfil de 5 IOPS/GB. Nesse caso, o compartilhamento de arquivo não pode ultrapassar 9.600 GB para mover para o perfil mais alto.

ibmcloud is share-update my-file-share --profile tier-5iops

Updating file share my-file-share under account Test Account as user user@mycompany.com...
ID                           ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Name                         my-file-share
CRN                          crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Lifecycle state              updating
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-1
Profile                      tier-5iops
Size(GB)                     100
IOPS                         3000
User Tags                    docs:test
Encryption                   provider_managed
Mount targets                ID                          Name   VPC ID   VPC Name
                             No mount targets found.
Resource group               ID                                     Name
                             7f1645c5-8afa-4a7e-860d-3df563e0aa8d   Default
Created                      2023-02-26T20:01:18+05:30
Snapshot count               0
Snapshot size                0
Source snapshot              -

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

Ajustando o IOPS com a API

É possível ajustar o IOPS para compartilhamentos de arquivo de dados existentes chamando a API do Virtual Private Cloud (VPC).

Ajuste de IOPS para o dp2 ou o perfil personalizado

Faça uma solicitação PATCH /shares e especifique a propriedade iops para ajustar o IOPS dentro do intervalo permitido para um perfil dp2 customizado.

Não é possível atualizar o nome do compartilhamento de arquivo e ajustar o IOPS na mesma solicitação PATCH /shares. Fala duas solicitações de PATCH /shares.

O exemplo a seguir mostra um aumento de 100 IOPS para 3.000 IOPS em um compartilhamento de arquivos de 100 GB, com base em um perfil personalizado de 100 a 499. O intervalo de IOPS para essa faixa customizada é de 100 a 6.000 IOPS. Para obter mais informações sobre os intervalos de IOPS disponíveis, consulte Visão geral do perfil de armazenamento de arquivos.

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

O status do compartilhamento de arquivos exibe “ updating ” enquanto o IOPS está sendo ajustado. As IOPS atuais são mostradas até que você reinicie a instância. No exemplo a seguir, o valor de IOPS é ajustado de 100.

{
   "created_at": "2023-08-08T22:58:49.000Z",
   "crn": "crn:[...]",
   "encryption": "provider_managed",
   "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-a0c07083-f411-446c-9316-7b08d6448c86",
   "id": "r006-a0c07083-f411-446c-9316-7b08d6448c86",
   "iops": 100,
    .
    .
    .
	"status": "updating",
    .
    .
    .
}

Quando a expansão das IOPS for concluída, reinicie a instância. O novo valor é exibido, e o status do compartilhamento de arquivos é “ stable ”.

{
  "created_at": "2023-08-08T22:58:49.000Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86",
  "id": "a0c07083-f411-446c-9316-7b08d6448c86",
  "iops": 3000,
  "lifecycle_state": "stable",
  "name": "my-share-updated",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-3iops",
    "name": "custom",
    "resource_type": "share_profile"
  },
  "access_control_mode": "security-group",
  "allowed_transit_encryption_modes": ["none", "user-managed"],
  "replication_role": "none",
  "replication_status": "none",
  "replication_status_reasons": [],
  "resource_group": {
    "crn": "crn:[...]",
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "678523bcbe2b4eada913d32640909956",
    "name": "Default"
  },
  "resource_type": "share",
  "size": 4800,
  "mount_targets": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86/mount_targets/1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "name": "my-mount-target",
      "resource_type": "share_target",
      "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/r006-12bb28fc-856d-4902-813b-dc065d1ed084",
        "id": "12bb28fc-856d-4902-813b-dc065d1ed084",
        "name": "my-vpc",
        "resource_type": "vpc"
      }
    }
  ],
  "snapshot_count": 10,
  "snapshot_size": 10,
  "user_tags": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1",
    "resource_type": "zone"
  }
}

Ajustando o IOPS especificando um perfil de camada de IOPS diferente

Faça uma solicitação PATCH /shares e especifique a propriedade profile e indique o nome ou href do perfil da camada IOPS.

O exemplo a seguir altera um perfil de 3 IOPS/GB para um perfil de 5 IOPS/GB. Nesse caso, o compartilhamento de arquivo não pode ultrapassar 9.600 GB para mover para o perfil mais alto.

curl -X PATCH \
 "$vpc_api_endpoint/v1/shares/$share_id?version=2023-07-18&generation=2" \
 -H "Authorization: Bearer $iam_token" \
 -d '{
      "profile": "5iops-tier"
    }'

Ajustando IOPS com o Terraform

É possível ajustar IOPS para compartilhamentos de arquivo de dados existentes no Terraform.

Ajustando o IOPS para um perfil customizado ou dp2

Para modificar o nível de desempenho de um compartilhamento de arquivo, use o recurso ibm_is_share e forneça o valor de IOPS desejado. Ao especificar o valor de IOPS, certifique-se de que ele esteja dentro do intervalo de desempenho para o tamanho do compartilhamento de arquivo. Para obter mais informações, consulte dp2 file storage profile.

Quando aplicado, o exemplo a seguir atualiza o desempenho de compartilhamento para 5000 IOPS.

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

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

Ajustando o IOPS especificando um perfil de camada de IOPS diferente

Para modificar o nível de desempenho de um compartilhamento de arquivo com um perfil de camada IOPS, utilize o recurso ibm_is_share e especifique uma camada IOPS diferente. Quando aplicado, o exemplo a seguir atualiza o desempenho de compartilhamento para 5000 IOPS.

resource "ibm_is_share" "example" {
  name    = "my-share"
  size    = 220
  profile = "tier-5iops"
  zone    = "us-south-2"
}

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

Próximas etapas

Crie mais compartilhamentos de arquivos ou gerencie seus compartilhamentos existentes: