No console

Na página de provisionamento de armazenamento em bloco, você pode ver uma lista de todos os perfis disponíveis na página Criar armazenamento em bloco, como o perfil sdp, os três perfis tiered e o perfil custom. Ao selecionar um dos perfis em camadas, você precisa especificar a capacidade. Ao selecionar o perfil personalizado, você precisa especificar a capacidade e um valor de IOPS que esteja no intervalo aplicável à sua capacidade (Tabela 3 ). Ao selecionar o perfil sdp, você pode especificar a capacidade e o IOPS sem nenhuma restrição de intervalo baseada em capacidade. Você também pode especificar o limite máximo de throughput para o seu volume.

Na CLI

Para visualizar a lista de perfis disponíveis usando a CLI, execute o comando a seguir:

ibmcloud is volume-profiles

Listing volume profiles in region us-east under account TEST as user test.user@ibm.com...
Name              Family                Bandwidth(Mbps) default value   Storage Generation
general-purpose   tiered                -                               1
5iops-tier        tiered                -                               1
10iops-tier       tiered                -                               1
sdp               defined_performance   1000                            2
custom            custom                -                               1

Para visualizar detalhes do perfil, execute o comando ibmcloud is volume-profile com o nome do perfil que você está interessado em ver. O exemplo a seguir mostra os detalhes do perfil sdp.

ibmcloud is volume-profile sdp

Getting volume profile sdp under account Test Account as user test.user@ibm.com...
Name                                   sdp
Family                                 defined_performance
Adjustable IOPS                        true
Boot capacity                          Max     Min
                                       32000   1
Capacity                               Max     Min   Default   Step
                                       32000   1     -         1
IOPS                                   Max     Min    Default   Step
                                       64000   3000   3000      1
Bandwidth(Mbps)                        Max    Min    Default   Step   Value
                                       8192   1000   1000      1      -
Storage Generation                     2
Adjustable Bandwidth Supported         true
Adjustable Capacity States             attached, unattached
Adjustable IOPS State                  attached, unattached

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

Com a API

Para ver os perfis disponíveis, faça uma solicitação de GET /volume/profiles

curl -X GET \
$vpc_api_endpoint/v1/volume/profiles?$api_version&generation=2 \
-H "Authorization: Bearer $iam_token"

Para a maioria das contas, a API responde com os campos name, href, family. Para contas com acesso especial para visualizar o perfil de desempenho definido, a resposta é aprimorada para incluir os seguintes campos:

• boot_capacity indica os valores de capacidade que são permitidos para volumes de inicialização para cada perfil. O valor retornado é um intervalo com valores mínimo e máximo especificados para cada perfil.
  • Para os perfis custom e tiered, o intervalo é de 10 GB a 250 GB.
  • Para o perfil sdp, o intervalo é de 10 GB a 250 GB.
• capacity indica os valores de capacidade permitidos para os volumes de dados de cada perfil. O valor retornado é um intervalo com valores mínimo e máximo especificados para cada perfil.
  • Para os perfis custom e tiered, o intervalo é de 10 GB a 16 TB.
  • Para o perfil sdp, o intervalo é de 1 GB a 32 TB.
• iops esse campo indica o IOPS alcançável em cada perfil.
  • Para os perfis tiered, esse valor é fixo: 3 IOPS/GB, 5 IOPS/GB e 10 IOPS/GB.
  • Para o perfil custom, esse valor pode variar de 1 a 48.000.
  • Para o perfil sdp, esse valor pode variar de 1 a 64.000.
• family agora tem um valor extra,defined_performance, juntamente com os valores tiered e custom que existem atualmente.
• adjustable_capacity_states indica se a capacidade do volume pode ser alterada quando o volume não está anexado a uma instância de servidor virtual em execução. Esse campo é informativo. Ele descreve as características do perfil do volume e não pode ser alterado.
  • Para os perfis custom e tiered, esse valor é attached.
  • Para o perfil sdp, esse valor é attached, unattached.
• adjustable_iops_states indica se o IOPS do volume pode ser alterado quando o volume não estiver anexado a uma instância de servidor virtual em execução. Esse campo é informativo. Ele descreve as características do perfil do volume e não pode ser alterado.
  • Para os perfis custom, esse valor é attached.
  • Para os perfis tiered, esse valor está vazio porque não há suporte para alterações no IOPS em nenhum estado. Se quiser alterar o valor de IOPS de um volume, você poderá mudar para outro perfil tiered.
  • Para o perfil sdp, esse valor é attached, unattached.
• adjustable_bandwidth_supported indica se o limite de largura de banda provisionado pode ser ajustado.
  • Para os perfis custom e tiered, esse valor é false.
  • Para o perfil sdp, esse valor é true.
• storage_generation indica a qual geração a família de perfil pertence.
  • Para os perfis custom e tiered, esse valor é 1.
  • Para o perfil sdp, esse valor é 2.

O novo perfil está listado como sdp. Para ver detalhes desse perfil, faça uma solicitação para GET /volume/profiles/sdp.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/sdp?version=2024-09-24&generation=2"\
 -H "Authorization: Bearer $iam_token"

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

{
    "boot_capacity": {
        "max": 32000,
        "min": 1,
        "type": "dependent_range"
    },
    "capacity": {
        "default": 1,
        "max": 32000,
        "min": 1,
        "step": 1,
        "type": "range"
    },
    "family": "defined_performance",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/sdp",
    "iops": {
        "default": 100,
        "max": 64000,
        "min": 100,
        "step": 1,
        "type": "range"
    },
    "name": "sdp",
    "adjustable_capacity_states": {
        "type": "fixed",
        "value": "attached, unattached"
    },
    "adjustable_iops_states": {
        "type": "fixed",
        "value": "attached, unattached"
    },
    "adjustable_bandwidth_supported": true,
    "max_throughput": 8192,
    "max_bandwidth_mbps": 8192,
    "min_bandwidth_mbps": 1000,
    "default_bandwidth_mbps": 1000,
    "storage_generation": 2
}

Para obter mais informações sobre esse método, consulte a referência de API para listar todos os perfis do volume e recuperar um perfil do volume

Com Terraform

1. Para usar o Terraform, faça download da CLI do Terraform e configure o plug-in do Provedor IBM Cloud®. Para obter mais informações, consulte Introdução ao Terraform.

2. Os serviços de infraestrutura de VPC usam um terminal regional específico, que tem como destino o us-south por padrão Se sua VPC for criada em outra região, certifique-se de destinar a região apropriada no bloco do provedor no arquivo provider.tf. Veja o exemplo a seguir de destinação de uma região diferente do us-south padrão:

   provider "ibm" {
      region = "eu-de"
   }
   

3. Importe a lista de perfis de volume disponíveis como uma origem de dados somente leitura

   data "ibm_is_volume_profiles" "example" {
   }
   

   Para obter mais informações, consulte ibm_is_volume_profile.