Exibição de informações sobre todos os volumes Block Storage for VPC no console

Acesse a lista de volumes Block Storage for VPC. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Storage > Block Storage volumes.

Por padrão, os volumes do Block Storage for VPC são exibidos em conjuntos de 10 para todos os grupos de recursos em sua região. Altere essa configuração pré-definida clicando na seta para baixo do controle de página e aumente a lista para 20 ou 50 volumes. Use as setas de controle de página para ir para a página seguinte ou retornar. Na lista de todos os volumes do “ Block Storage for VPC ”, você verá as seguintes informações.

Detalhes sobre todos os volumes

Campo	Descrição
Região	A região onde esses volumes estão localizados, por exemplo, o Sul dos EUA. Clique na seta para baixo para ver os volumes em outra região na qual você tenha uma conta.
Nome	Clique no nome do volume para ver detalhes do volume individual.
Status	Status do volume, que funciona como o filtro padrão para todas as linhas.
Local	Zona de disponibilidade em sua região, herdada do VPC (por exemplo, Sul dos EUA 1).
Tamanho	Tamanho do volume especificado, em GBs.
Tipo de anexo	Dados, para um volume secundário anexado a uma instância, inicializar quando anexado como volume de inicialização ou em branco para um volume não anexado.
Funcionamento	O recurso “Saúde” monitora o estado geral do volume, incluindo o desempenho de E/S e a consistência dos dados. Os status de funcionamento do volume são OK ou degraded Os volumes em um estado degradado têm desempenho, capacidade ou problemas de conexão degradados. Os volumes que estão sendo restaurados de uma captura instantânea também mostram um estado degradado. O serviço exibe uma possível razão para o estado degradado para que seja possível resolver quaisquer problemas Para obter mais informações, consulte Block Storage for VPC estados de funcionamento do volume.
Criptografia	A criptografia com chaves gerenciadas pela IBM é ativada por padrão em todos os volumes. Você também pode usar suas próprias chaves raiz em uma instância do Key Protect para proteger seus dados. Para obter mais informações, consulte “Criação de volumes d Block Storage for VPC s com criptografia gerenciada pelo cliente ”.
Tags	Número de tags de usuário aplicadas ao volume. Clique no número desta coluna para visualizar ou editar as tags em uma nova janela. Se nenhuma tag tiver sido aplicada ao volume, clique em “Adicionar tags” e adicione-as na nova janela. As tags de usuário podem associar o volume a uma política de backup para criar backups do volume. Para obter mais informações, consulte Adição de tags de usuário associadas a uma política de backup a um volume no console.
Ações	Clique em Ações para exibir um menu de ações específicas de contexto que você pode realizar.

No menu Ações, na página da lista de volumes, as seguintes ações estão disponíveis. Algumas ações só estão disponíveis quando o volume atende a condições específicas, como estar conectado ou desconectado.

• Renomear — renomeie este volume.
• Conectar ao servidor — conectar um volume não conectado a uma instância de servidor virtual. Essa ação só está disponível quando o volume não está conectado. Para obter mais informações, consulte Anexando um volume para uma instância.
• Desconectar da instância — desconecta um volume conectado de sua instância de servidor virtual. Essa ação só está disponível quando o volume estiver conectado. Para obter mais informações, consulte “Desconectando um volume de uma instância de servidor virtual ”.
• Criar instantâneo — criar um instantâneo deste volume. Essa ação pode aparecer desativada quando não estiver disponível. Para obter mais informações, consulte “Criação de um snapshot no console ”.
• Criar imagem — criar uma imagem personalizada a partir de um volume de inicialização. Essa ação pode aparecer desativada quando não estiver disponível. Para obter mais informações, consulte Criação de uma imagem a partir de um volume no console.
• Adicionar ou editar tags – adicione ou edite tags de usuário e acesse as tags de gerenciamento neste volume. Para obter mais informações, consulte Trabalhando com tags.
• Excluir — excluir este volume. Essa ação fica desativada quando o volume está conectado a uma instância. Para obter mais informações, consulte Exclusão de um volume de dados no console.
• Migrar volume — migrar este volume para um perfil ou configuração diferente. Para obter mais informações, consulte “Migração de volumes de armazenamento em bloco ”.

Exibição de detalhes de um volume Block Storage for VPC

Para visualizar detalhes sobre um volume do “ Block Storage for VPC ”, acesse a lista de todos os volumes do “ Block Storage for VPC ” e selecione um volume.

Próximo ao nome do volume está o status do volume e as tags associadas a esse volume. As tags de usuário identificam o recurso. Quando as tags de usuário são associadas a uma política de backup, elas são usadas para criar instantâneos de backup do volume. Com tags de gerenciamento de acesso, é possível criar agrupamentos de recursos flexíveis para gerenciar o acesso. Para obter mais informações sobre essas tags, consulte Trabalhando com tags.

Informações específicas por volume

A página possui 4 abas. Por padrão, a guia Visão Geral é selecionada para detalhes do volume.

Detalhes do volume

Campo	Descrição
Detalhes do volume
Nome	O nome do volume que você especificou ao criá-lo. Clique no ícone Editar para editar o nome do volume. O nome do volume pode ter até 63 caracteres alfanuméricos minúsculos e incluir o hífen (-) e deve começar com uma letra minúscula. Os nomes de volume devem ser exclusivos para a conta e para a região
ID do volume	ID do volume gerado pelo sistema.
Funcionamento	O recurso “Saúde” monitora o estado geral do volume, incluindo o desempenho de E/S e a consistência dos dados. Os status de funcionamento do volume são OK ou degraded Os volumes em um estado degradado têm desempenho e capacidade abaixo do normal ou apresentam problemas de conexão. Os volumes que estão sendo restaurados a partir de uma captura instantânea também mostram um estado degradado. O serviço exibe uma possível razão para o estado degradado para que você possa resolvê-lo, Para obter mais informações, consulte Block Storage for VPC estados de funcionamento do volume.
Grupo de recursos	Grupo de recursos definido quando você configura seu VPC. Os grupos de recursos gerenciam o acesso aos recursos, mas não afetam o faturamento ou o monitoramento.
Tipo de anexo	Dados, para um volume secundário conectado a uma instância; inicialização, quando conectado como volume de inicialização; ou em branco, para um volume não conectado.
Data de criação	Data gerada pelo sistema quando o volume foi criado.
Local	Zona de disponibilidade em sua região.
Tamanho	Tamanho do volume especificado. Quando o volume for anexado a uma instância de servidor virtual e não estiver na capacidade máxima para o seu alcance, será possível clicar no ícone para expandi-lo. Para obter mais informações, consulte expansão da capacidade do volume Block Storage for VPC.
Profile	Este campo exibe o perfil perfil de volume: sdp, IOPS personalizadas ou um dos perfis Nível de IOPS.
Máximo de IOPS	O valor máximo de IOPS para um nível de IOPS predefinido ou o valor que você especificou para IOPS personalizadas.
Rendimento	O campo mostra a largura de banda alocada do volume de armazenamento, que é medida em Gigabits por segundo (Gbps). A taxa de transferência é calculada como resultado do número de IOPS para o qual o volume é provisionado vezes o multiplicador de taxa de transferência. Dependendo do perfil do volume, o multiplicador da taxa de transferência pode ser de 16 KB ou 256 KB. Para volumes criados com o perfil sdp, o valor da taxa de transferência pode ser personalizado no intervalo de 1000 a 8192 Mbps.
Criptografia	A criptografia com chaves gerenciadas pela IBM é ativada por padrão em todos os volumes. Também é possível usar suas próprias chaves raiz para proteger seus dados. O campo “Criptografia” exibe o nome do serviço de gerenciamento de chaves (KMS) que você provisionou (por exemplo, Key Protect ) e que é gerenciado pelo cliente. Para obter mais informações, consulte Criando volumes Block Storage for VPC com criptografia gerenciada pelo cliente.
Instância de criptografia	Opcional. Um link para a instância de KMS provisionada para um volume de criptografia gerenciado pelo cliente.
Chave	Opcional. O nome e o ID copiável da chave raiz utilizada para criptografar a senha, que protege um volume de criptografia gerenciado pelo cliente.
Políticas de backup	O número de políticas de backup associadas ao volume. Clique no link de número para acessar a guia de políticas de backup.
Capturas instantâneas	O número de capturas instantâneas que foram criadas do volume Clique no link de número para acessar a guia Capturas instantâneas e backups.
Função de replicação	O papel deste volume em uma relação de replicação: source, replica ou none. Este campo está presente apenas nos volumes de perfil “ sdp ”.
Servidor virtual anexado	Os volumes anexados a uma instância do servidor virtual estão listados aqui. Clique em “Anexar” para selecionar uma instância à qual anexar este volume. Para obter mais informações, consulte Anexando um volume para uma instância.
Status	Esse campo rastreia o estado geral do ciclo de vida do volume, que vai desde a criação até a exclusão do volume. O status de conexão, por exemplo, é “conectado” quando o volume está conectado a uma instância e “conectando” quando o processo está em andamento.
Nome	Clique no nome da instância do servidor virtual para ver detalhes da instância.
Exclusão Automática	Quando ativado, o volume é excluído automaticamente quando você exclui a instância. Clique na alternância para ativar a exclusão automática.
Políticas de backup	Mostra as políticas de backup associadas a esse volume. Para associar políticas de backup, é possível incluir tags de uma política de backup para recursos de destino para esse volume. Clique em Aplicar para selecionar uma política de backup, em seguida, aplique suas tags para o recurso de destino no volume.

No menu Ações, na página de detalhes do volume, estão disponíveis as seguintes ações:

• Visualizar o histórico de atividades — visualize o registro de atividades deste volume.
• Criar instantâneo — crie um instantâneo a partir de um volume de dados conectado ou de um volume de inicialização. Para obter mais informações, consulte “Criação de um snapshot no console ”.
• Criar imagem — criar uma imagem personalizada a partir de um volume de inicialização. Esta ação fica desativada quando indisponível. Para obter mais informações, consulte Criação de uma imagem a partir de um volume no console.
• Expandir volume — aumentar o tamanho de um volume conectado em incrementos de 1 GB. Para obter mais informações, consulte Expandindo a capacidade do volume de armazenamento de bloco.
• Editar perfil de IOPS — altere as características de desempenho de um volume de dados conectado, aumentando ou diminuindo o número de IOPS por meio da edição do perfil de IOPS.
• Aplicar política de backup — aplicar uma política de backup a este volume. Para obter mais informações, consulte “Aplicando políticas de backup a recursos ”.
• Migrar volume — migrar este volume para um perfil diferente. Para obter mais informações, consulte “Migração de volumes de armazenamento em bloco ”.
• Excluir — exclui um volume não associado. Para obter mais informações, consulte Exclusão de um volume de dados no console.

Para visualizar uma lista de instantâneos deste volume criados manualmente ou por meio de uma política de backup, clique na guia “Instantâneos e backups ”.

Visualizando detalhes do volume Block Storage for VPC anexado em detalhes da instância

Você também pode visualizar informações sobre um volume do Block Storage for VPC conectado na página de detalhes da instância do servidor virtual:

1. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Compute > Virtual server instances e selecione uma instância.

2. Em Volumes de armazenamento de bloco conectados, clique no nome de um volume para acessar a página de detalhes dele.

Visualização de todos os volumes na CLI

Execute o seguinte comando para listar informações resumidas sobre todos os volumes:

ibmcloud is volumes [--json]

Especificar o ID ou o nome do grupo de recursos filtra a lista para volumes que pertencem a um grupo de recursos. Quando você omite esse argumento, o padrão é todos os grupos de recursos. Também é possível visualizar todos os volumes em uma determinada zona de disponibilidade. Por padrão, os primeiros 25 volumes são exibidos por página.

O exemplo a seguir mostra todos os volumes para todos os grupos de recursos em sua zona de disponibilidade.

ibmcloud is volumes

Listing volumes in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                                            Status      Capacity   IOPS    Profile           Attachment state   Attachment type   Zone         Resource group   Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-1dad641f-3a17-4117-8bb6-e30e09e64dff   my-2nd-data-volume                              available   9600       48000   5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-f336511e-ece5-4407-9c8e-ef030c94aaa0   my-3rd-data-volume                              available   4800       48000   10iops-tier       unattached         -                 us-south-2   Default          -                          -                       1
r006-45ca6ddd-9942-4dd2-9ae9-d3edcb9fa076   my-data-volume-1                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-6a1ac889-d232-4beb-84dd-93c63cf9a156   my-data-volume-2                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-862ddcd3-59a6-4c69-9a10-275c894195b9   my-new-boot-volume                              available   250        3000    general-purpose   unattached         -                 us-south-2   Default          -                          -                       1
r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05   my-sdp-volume                                   available   250        3000    sdp               attached.          -                 us-south-2   Default          -                          -                       2
r006-693f555e-fec7-4afb-b1e3-a16bf8b0d744   my-virtual-server-instance-boot-1756849222000   available   100        3000    general-purpose   attached           boot              us-south-2   Default          -                          -                       1

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

Visualizando detalhes sobre um volume pela CLI

Execute o seguinte comando para mostrar detalhes sobre um volume específico. Você pode usar o nome ou o ID do volume para identificá-lo.

ibmcloud is volume VOLUME_ID [--json]

Consulte o exemplo a seguir.

ibmcloud is volume my-sdp-volume

Getting volume my-sdp-volume  under account under account Test Account as user test.user@ibm.com...
ID                                     r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Name                                   my-sdp-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Status                                 available
Attachment state                       attached
Capacity                               250
IOPS                                   3000
Bandwidth(Mbps)                        1000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-06-23T16:35:10+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name                Auto delete   Attachment ID                               Attachment name
                                       data              0726_6cf2d984-e825-458d-8048-11572b72d040   my-virtual-server-instance   false         0717-beec02ac-7edf-4b59-ab9f-7c004bf4d8fa   outpour-perm-cosmic-gander
Active                                 true
Adjustable IOPS                        true
Adjustable Capacity States             unattached,attached
Adjustable IOPS States                 unattached,attached
Busy                                   false
Tags                                   -
Storage Generation                     2

No exemplo, o volume está anexado a uma instância de servidor virtual, portanto, os nomes e IDs do anexo de volume e da instância também são exibidos na saída do comando. A propriedade Active é true porque a instância do servidor virtual à qual o volume está anexado está em execução. A propriedade Busy com o valor false indica que esse volume não está executando uma operação que deve ser serializada.

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

Propriedades extras da CLI para volumes de inicialização

Quando você solicita a visualização de detalhes de volumes de inicialização, algumas propriedades adicionais são retornadas na resposta. Consulte o seguinte exemplo:

ibmcloud is volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e

Getting volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e under account Test Account as user test.user@ibm.com...
ID                                     r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Name                                   vsi-test-boot-1712686424000
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-04-01T18:18:57+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       boot              0727_a9910bc9-3ea0-40d2-b3de-2b03e752f989   vsi-lvm-test    true          0727-7ff0df1b-ba0b-40c7-ad99-122819342f39   prissy-reason-unselect-overcome
Operating system                       CentOS Stream 9 - Minimal Install (amd64)
Source image                           ID                                          Name
                                       r006-0950e619-325e-446e-b895-e0bdd21dd1ea   ibm-centos-stream-9-amd64-9
Active                                 true
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1
Allowed Use API Version                2025-03-31
Allowed Use Bare Metal Server          true
Allowed Use Instance                   true

As propriedades de uso permitido são herdadas da imagem ou snapshot de origem a partir do qual o volume de inicialização pai foi criado. Usando a CLI ou a API, você pode substituir esses valores ao criar uma instância ou ao atualizar o volume de inicialização. Você deve ter a função de IAM is.volume.volume.manage-allowed-use para fazer essas atualizações.

Essas propriedades compreendem uma expressão booleana da Common Expression Language. Quando a expressão é avaliada como true, o provisionamento da instância do servidor virtual ou do servidor bare metal é permitido com o volume de inicialização ou com uma imagem que foi criada a partir do volume de inicialização. Quando a expressão é avaliada como false, o provisionamento é bloqueado. Para obter mais informações, consulte Adição de expressões de uso permitido a imagens personalizadas.

Visualização de todos os volumes com a API

Faça uma chamada GET /volumes para listar as informações de resumo sobre todos os volumes. Consulte o exemplo a seguir.

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2025-01-212&generation=2" \
-H "Authorization: Bearer $iam_token"

Uma resposta bem-sucedida se parece com o exemplo a seguir. Este exemplo mostra três volumes de dados. O segundo item da lista está vinculado a uma instância.

[
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2025-01-22T00:54:01.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "id": "r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "iops": 3000,
    "name": "my-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_snapshot": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "id": "r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "name": "wdc-fst-rstore-c6a092f34118-4505",
        "resource_type": "snapshot"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "env:prod",
        "env:test"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
  },
  {
    "active": false,
    "allowed_use": {
      "api_version": "2025-03-31",
      "instance": "true",
      "bare_metal_server": "false"
    },
    "attachment_state": "attached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2024-04-01T16:48:16.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "id": "r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "iops": 3000,
    "name": "my-vsi--boot-volume-1711989834000",
    "operating_system": {
      "architecture": "amd64",
      "dedicated_host_only": false,
      "display_name": "Ubuntu Linux® 20.04 LTS Focal Fossa Minimal Install (amd64)",
      "family": "Ubuntu Linux",
      "gpu_supported": [],
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
      "name": "ubuntu-20-04-amd64",
      "resource_type": "operating_system",
      "vendor": "Canonical",
      "version": "20.04 LTS Focal Fossa Minimal Install"
    },
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_image": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "id": "r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "name": "ibm-redhat-8-6-minimal-amd64-7",
        "resource_type": "image"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "backup-policy-tag"
    ],
    "volume_attachments": [
        {
            "delete_volume_on_instance_delete": true,
            "device": {
                "id": ""
            },
            "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d/volume_attachments/0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "id": "0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "instance": {
                "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "id": "0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "name": "my-vsi-test",
                "resource_type": null
            },
            "name": "perfectly-parting-humble-skewer",
            "type": "boot"
        }
    ],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
  },
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 10,
    "created_at": "2021-09-10T15:56:30.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-3:a/a1234567::volume:r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "id": "r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "iops": 3000,
    "name": "my-other-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
    }
  }
]

Visualizando detalhes de volume com a API

Faça uma chamada GET /volumes/{id} para ver detalhes de um volume. Consulte o exemplo a seguir.

curl -X GET "$vpc_api_endpoint/v1/volumes/$volume_id?version=2025-01-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Uma resposta bem-sucedida fornece detalhes sobre o volume, incluindo capacidade e IOPS, o status do volume e se ele está conectado a uma instância.

{
  "active": false,
  "adjustable_capacity_states": ["attached"],
  "adjustable_iops_states": ["attached"],
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  "attachment_state": "attached",
  "bandwidth": 1000,
  "busy": false,
  "capacity": 100,
  "created_at": "2024-10-07T23:16:53.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "id": "r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "iops": 1000,
  "name": "my-volume",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
    "name": "custom"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "volume",
  "status": "available",
  "status_reasons": [],
  "storage_generation": 1,
  "user_tags": [],
  "volume_attachments": [
    {
      "delete_volume_on_instance_delete": false,
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "id": "0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "instance": {
        "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "id": "0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "name": "my-instance",
        "resource_type": "instance"
      },
      "name": "my-volume-attachment",
      "type": "data"
    }
  ],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Propriedades extras da API para volumes de inicialização

Quando você solicita a visualização dos detalhes dos volumes de inicialização, algumas propriedades adicionais são retornadas na resposta para as solicitações GET /volumes e GET /volumes/{id}.

• A propriedade active indica se a instância do servidor virtual a qual um volume está anexado está em execução ou parada. Quando active = true, a instância está em execução e as operações que exigem uma instância em execução, como a criação de uma imagem a partir do volume de inicialização, também funcionam.

• A propriedade busy indica se este volume está realizando uma operação que deve ser serializada. Se uma operação exigir serialização, ela falhará, a menos que essa propriedade seja false``.

• As expressões de uso permitido são herdadas da imagem ou snapshot de origem a partir do qual o volume de inicialização pai foi criado. Você pode atualizar as expressões de uso permitido somente em volumes de inicialização desvinculados. Usando a CLI ou a API, você pode substituir esses valores ao criar uma instância ou ao atualizar o volume de inicialização. Você deve ter a função de IAM is.volume.volume.manage-allowed-use para fazer essas atualizações. Essas propriedades compreendem uma expressão booleana da Common Expression Language. Quando a expressão é avaliada como true, o provisionamento da instância do servidor virtual ou do servidor bare metal é permitido com o volume de inicialização ou com uma imagem que foi criada a partir do volume de inicialização. Quando a expressão é avaliada como false, o provisionamento é bloqueado. Para obter mais informações, consulte Adição de expressões de uso permitido a imagens personalizadas.

Consulte o exemplo a seguir.

  "active": "true",
  "busy": "false",
  "capacity": 100,
  "created_at": "2022-12-08T06:26:17Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
  "id": "ccbe6fe1-5680-4865-94d3-687076a38293",
  "iops": 300,
  "name": "boot-volume-1",
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  .
  .
  .

Visualização de todos os volumes com o Terraform

Importar a lista de volumes que pertencem a uma conta como uma fonte de dados somente leitura. É possível filtrar por nome do volume, nome da zona, estado do anexo, tipo de criptografia, família do sistema operacional (aplicável a volumes de inicialização) ou arquitetura do sistema operacional (aplicável a volumes de inicialização).

data "ibm_is_volumes" "example" {
}

Os atributos que são exportados incluem a contagem total de volumes e a lista de volumes. Os atributos aninhados incluem ID do volume, nome, data de criação, tamanho, IOPS, CRN, tags de acesso e de usuário, perfil, tipo e chave de criptografia, estado do ciclo de vida, estado de integridade e motivo, sistema operacional e outros atributos.

Para obter mais informações, consulte ibm_is_volumes.

Exibição de detalhes do volume com o Terraform

Importar os detalhes de um volume como uma fonte de dados somente leitura. Você deve identificar o volume por ID ou nome.

data "ibm_is_volume" "example1" {
  name = ibm_is_volume.example.name
}

Os atributos que são exportados incluem a contagem total de volumes e a lista de volumes. Os atributos aninhados incluem ID do volume, nome, data de criação, tamanho, IOPS, CRN, tags de acesso e de usuário, perfil, tipo e chave de criptografia, estado do ciclo de vida, estado de integridade e motivo, sistema operacional e outros atributos.

Para obter mais informações, consulte ibm_is_volume.

Propriedades extras do Terraform para volumes de inicialização

As expressões de uso permitido são herdadas da imagem ou snapshot de origem a partir do qual o volume de inicialização pai foi criado. Você pode atualizar as expressões de uso permitido somente em volumes de inicialização desvinculados. Usando o Terraform, você pode substituir esses valores ao criar uma instância ou ao atualizar o volume de inicialização. Você deve ter a função de IAM is.volume.volume.manage-allowed-use para fazer essas atualizações. Essas propriedades compreendem uma expressão booleana da Common Expression Language. Quando a expressão é avaliada como true, o provisionamento da instância do servidor virtual ou do servidor bare metal é permitido com o volume de inicialização ou com uma imagem que foi criada a partir do volume de inicialização. Quando a expressão é avaliada como false, o provisionamento é bloqueado. Para obter mais informações, consulte Adição de expressões de uso permitido a imagens personalizadas.