Gerenciando volumes Block Storage for VPC

Desconectando um volume do tipo “ Block Storage for VPC ” de uma instância de servidor virtual

É possível remover um volume de armazenamento de bloco conectado a uma instância de servidor virtual. A remoção libera o volume para uso por outra instância.

Para desmontar um volume, siga as etapas a seguir.

1. Acesse a lista de todos os volumes de armazenamento de bloco. No console IBM Cloud, clique no menu Navegação > de infraestrutura > Armazenamento > Volumes Block Storage.
2. Localize o volume e clique no ícone Ações para abrir uma lista de opções.
3. No menu de opções, clique em Remover da instância.
4. Confirme clicando em Desanexar instância na janela aberta.

Como alternativa, é possível clicar em um volume individual na lista de todos os volumes de armazenamento de bloco e acessar a página Detalhes do volume para esse volume. Em Instâncias anexadas, clique no sinal de menos ao lado da instância do servidor virtual para remover o volume dessa instância.

Quando você usa uma instância Hyper Protect Virtual Servers for IBM Cloud® Virtual Private Cloud, a remoção do volume de dados que está anexado a uma instância em execução faz com que a carga de trabalho que está sendo executada na instância falhe. Portanto, é recomendado que você não remova o volume de dados.

Transferência de um volume do Block Storage for VPC de uma instância de servidor virtual para outra

Para transferir um volume de armazenamento em bloco para outra instância de servidor virtual, conclua as etapas a seguir.

1. Remova o volume de sua instância do servidor virtual.
2. Acesse a instância de servidor virtual para a qual deseja transferir o volume. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Compute > Virtual server instances.
3. Selecione uma instância de servidor virtual na lista.
4. Clique na guia Storage (Armazenamento ) para ver todos os volumes que estão anexados ao servidor.
5. Clique em Anexar + adicionar um volume. Todos os volumes de armazenamento em bloco disponíveis são exibidos.
6. Na lista de volumes, selecione o volume removido anteriormente.
7. Clique em Salvar.

Anexar um volume de dados autônomo Block Storage for VPC

Você pode criar vários volumes de dados de armazenamento em bloco durante o provisionamento da instância; esses volumes são anexados automaticamente à nova instância do servidor virtual. Quando você desanexa um volume de uma instância, ele existe como um volume autônomo e é exibido na lista de todos os volumes de armazenamento em bloco sem nenhum tipo de anexo. É possível conectá-lo a outra instância da lista de volumes de armazenamento de bloco.

1. Acesse a lista de todos os volumes de armazenamento de bloco. No console IBM Cloud, clique no menu Navegação > de infraestrutura > Armazenamento > Volumes Block Storage.
2. Localize o volume e clique no Ações ícone para abrir uma lista de opções.
3. No menu de opções, clique em Conectar à instância.
4. Selecione uma instância de servidor virtual disponível.
5. Clique em “Anexar ” para confirmar sua seleção.

Atualização do nome de um volume do Block Storage for VPC

É possível mudar o nome de um volume existente para torná-lo mais significativo.

1. Acesse a lista de todos os volumes de armazenamento de bloco. No console IBM Cloud, clique no menu Navegação > de infraestrutura > Armazenamento > Volumes Block Storage.

2. Localize o volume e, em seguida, clique no nome do volume para ir para a página Detalhes do volume.

3. Clique no ícone Editar após o nome do volume para editar o nome. Insira um nome válido para o volume.

   Os nomes de volume válidos podem incluir uma combinação de caracteres alfanuméricos minúsculos (a-z, 0-9) e o hífen (-), até 63 caracteres. Os nomes de volume devem começar com letra minúscula. Os nomes de volume devem ser exclusivos em toda a infraestrutura da VPC. Por exemplo, se você criar dois volumes com o mesmo nome na mesma conta e na mesma região, será gerado um erro “ volume name duplicate ”.

4. Confirme sua edição.

Adição de tags de usuário a um volume Block Storage for VPC no console

Adicione tags de usuário ao armazenamento em bloco na lista de volumes ou na página de detalhes dos volumes.

1. Acesse a lista de volumes de armazenamento em bloco. No console IBM Cloud, clique no menu Navegação > de infraestrutura > Armazenamento > Volumes Block Storage.

2. Localize o volume na lista em que você deseja incluir tags de usuário

3. Na coluna tags, clique em Incluir tags.

4. Insira as tags de usuário que você deseja aplicar a este volume. As tags são exibidas conforme você digita.

   Você também pode adicionar tags de gerenciamento de acesso a um volume. Para obter mais informações sobre como criar e incluir tags de gerenciamento de acesso, consulte Aplicar tags de gerenciamento de acesso a um volume.

5. Ao concluir a inclusão de tags, clique em Salvar. Quando você atualiza a tela, a lista de volumes mostra o número de tags adicionadas na coluna Tags.

Também é possível incluir tags na página de detalhes do volume. Para isso, siga estas etapas.

1. Acesse a lista de volumes de armazenamento em bloco.
2. Nos detalhes do volume, clique em Incluir tags próximo ao nome do volume.
3. Insira as tags de usuário que você deseja aplicar a este volume. Ao concluir, clique em SALVAR.

Adição de tags de usuário associadas a uma política de backup a um volume no console

É possível adicionar tags de usuário associadas a uma política de backup a um volume de armazenamento em bloco. As políticas de backup planejam a criação automática de capturas instantâneas de backup. Quando uma tag de volume corresponde a uma tag de política de backup para recursos de destino, ela aciona um backup do conteúdo do volume. Uma política de backup define um plano de backup que planeja quando as capturas instantâneas de backup são feitas.

Na página detalhes do volume, é possível visualizar as políticas de backup que são aplicadas ao volume e incluir tags de usuário associadas a uma política de backup.

1. Acesse a lista de volumes de armazenamento em bloco. No console IBM Cloud, clique no menu Navegação > de infraestrutura > Armazenamento > Volumes Block Storage.
2. Localize o volume desejado e clique no link do nome.
3. Na página de detalhes do armazenamento em bloco, clique na guia “Políticas de backup ”.
4. Clique em Anexar.
5. No painel lateral, selecione uma política de backup na lista de políticas disponíveis e, em seguida, selecione as tags da política a serem aplicadas ao volume. Você também pode consultar os detalhes do plano, o que pode ajudá-lo a decidir se deseja aderir a essa apólice.
6. Clique em Aplicar política e tags. A política de backup aparece na lista de políticas de backup associadas ao volume.

Ao ir para a página de política de backup, o volume para o qual você incluiu tags é mostrado na lista de volumes.

Para obter mais informações sobre como criar backups, consulte “Criação de uma política de backup ”. Para obter mais informações sobre tags de usuário, consulte Trabalhando com tags.

Atualizando um nome de volume.

Para mudar um nome de volume, especifique o nome ou o ID do volume e, em seguida, indique o novo nome. O nome do volume pode ser de até 63 caracteres alfanuméricos, incluir caracteres especiais e deve começar com uma letra minúscula. O nome do volume deve ser exclusivo em toda a infraestrutura do VPC.

ibmcloud is volume-update VOLUME_ID [--name NEW_NAME] [--json]

Consulte o exemplo a seguir.

ibmcloud is volume-update r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 --name my-data-volume

Updating volume r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 under account Test Account as user test.user@ibm.com...
ID                                     r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Name                                   my-data-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Status                                 available
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-01-22T00:54:01+00:00
Zone                                   us-south-2
Health State
Volume Attachment Instance Reference   -
Source snapshot                        ID                                          Name
                                       r006-8428038a-a399-4894-8c84-c8d7a4a75fae   wdc-fst-rstore-c6a092f34118-4505
Active                                 false
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1

Adição de tags de usuário a um volume Block Storage for VPC a partir da CLI

Emita o comando ' ibmcloud is volume-update VOLUME com a opção ' --tags para atualizar as tags de usuário de um volume. O argumento do volume pode ser definido pela ID do volume ou pelo nome do volume.

Use a mesma opção para adicionar tags a um volume quando você criar um volume usando ' ibmcloud is volume-create.

O exemplo a seguir inclui as tags de usuário env:test e bkp:test em um volume identificado por ID. A saída mostra informações como nome, status, capacidade, perfil de desempenho e localização. As tags atualizadas aparecem no final da resposta.

ibmcloud is volume-update r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 --tags dev:test

Updating volume r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34 under account Test Account as user test.user@ibm.com...
ID                                     r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Name                                   my-data-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34
Status                                 available
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-01-22T00:54:01+00:00
Zone                                   us-south-2
Health State
Volume Attachment Instance Reference   -
Source snapshot                        ID                                          Name
                                       r006-8428038a-a399-4894-8c84-c8d7a4a75fae   wdc-fst-rstore-c6a092f34118-4505
Active                                 false
Adjustable IOPS                        false
Busy                                   false
Tags                                   dev:test
Storage Generation                     1

Atualização de uma conexão de volume pela CLI

É possível atualizar o nome do volume associado e alterar a configuração padrão de exclusão automática usando o comando instance-volume-attachment-update .

ibmcloud is instance-volume-attachment-update INSTANCE_ID VOLUME_ATTACHMENT_ID [--name NEW_NAME] [--auto-delete true | false] [--json]

Use a opção “ --name ” e especifique um novo nome para a conexão do volume. Especifique --auto-delete true para garantir que o volume seja excluído automaticamente quando a instância for excluída. Especifique --auto-delete false, se você desejar manter o volume como um volume independente após a instância ser excluída

ibmcloud is instance-volume-attachment-update doc-test-ro otp1 --name one-true-pairing --auto-delete false

Updating volume attachment otp1 of instance doc-test-ro under account Test Account as user test.user@ibm.com...
ID                0757-6757e676-0bf5-4b79-9a5b-29c24e17420c
Name              one-true-pairing
Volume            ID                                          Name
                  r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac   demo-volume-update
Status            attached
Bandwidth(Mbps)   393
Type              data
Device            0757-6757e676-0bf5-4b79-9a5b-29c24e17420c-bxsh7
Auto delete       false
Created           2023-06-29T18:14:57+00:00

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

Desconectando um volume pela CLI

Use o comando instance-volume-attachment-detach para remover um volume de uma instância e excluir o anexo do volume. O volume de armazenamento de bloco não é excluído; é possível anexá-lo a outra instância posteriormente.

Na sintaxe para esse comando, INSTANCE é o ID ou o nome da instância. VOLUME_ATTACHMENT é o ID ou nome do anexo do volume. É possível especificar vários anexos de volume Para obter mais informações sobre anexos de volumes, consulte a referência da CLI para criação de um anexo de volumes

ibmcloud is instance-volume-attachment-detach INSTANCE (VOLUME_ATTACHMENT1 VOLUME_ATTACHMENT2 ...) [--output JSON] [-f, --force] [-q, --quiet]

ibmcloud is instance-volume-attachment-detach kj-test-ro one-true-pairing

This will delete volume attachment one-true-pairing and cannot be undone. Continue [y/N] ?> y
Deleting volume attachment one-true-pairing from instance kj-test-ro under account Test Account as user test.user@ibm.com...
OK
Volume attachment one-true-pairing is deleted.

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

Um volume de inicialização não pode ser desconectado de uma instância enquanto ela existir. Se quiser manter o volume de inicialização depois que a instância for excluída, certifique-se de que a opção auto-delete no anexo do volume esteja definida como false.

Atualização do nome de um volume por meio da API

Faça uma chamada PATCH /volumes/{id} e especifique um novo nome para o volume.

curl -X PATCH "$vpc_api_endpoint/v1/volumes/$volume_id?version=2022-04-22&generation=2"  \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-volume-4-update"
    }'

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

{
  "capacity": 50,
  "created_at": "2022-04-22T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 100,
  "name": "my-volume-4-update",
  "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/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
    "name": "us-south-2"
  }
}

Adição de tags de usuário a um volume Block Storage for VPC com a API

Para incluir tags de usuário em um volume, primeiro faça uma chamada GET /volumes/{volume_id} e copie a sequência hash da propriedade Etag no cabeçalho de resposta. Você então usa a sequência de hash quando especifica If-Match em uma solicitação PATCH /volumes/{volume_id} para criar novas tags de usuário.

Para aplicar tags a um volume de armazenamento de bloco, siga estas etapas:

1. Faça uma chamada para GET /volumes/{volume_id} e copie a string de hash da propriedade Etag no cabeçalho da resposta. É necessário usar a string de hash ao especificar If-Match na solicitação PATCH /volumes/{volume_id} para criar tags de usuário para o volume na etapa 2. Para gerar as informações do cabeçalho de resposta, faça uma chamada de API semelhante ao exemplo a seguir:

   curl -sSL -D GET\
   "https://us-south.iaas.cloud.ibm.com/v1/volumes/{volume_id}?version=2022-04-25&generation=2"\
   -H "Authorization: Bearer $TOKEN" -o /dev/null
   

   No cabeçalho da resposta, você vê algo assim:

   HTTP/2 200
   date: Tue, 28 Apr 2022 17:48:03 GMT
   content-type: application/json; charset=utf-8
   content-length: 1049
   cf-ray: 69903d250c4966ef-DFW
   cache-control: max-age=0, no-cache, no-store, must-revalidate
   expires: -1
   strict-transport-security: max-age=31536000; includeSubDomains
   cf-cache-status: DYNAMIC
   expect-ct: max-age=604800, report-uri="[uri...]"
   pragma: no-cache
   x-content-type-options: nosniff
   x-request-id: 1fbe2384-6828-4503-ae7d-050426d1b11b
   x-xss-protection: 1; mode=block
   server: cloudflare
   etag: W/xxxyyyzzz123
   

2. Faça uma solicitação PATCH /volumes/{volume_id}. Especifique a Sequência hash de tag de entidade para a propriedade If-Match no cabeçalho. Especifique a tag do usuário na propriedade user_tags .

   Você também pode adicionar tags ao fazer uma chamada " POST /volumes para criar um volume e especificar a propriedade " user_tags.

   Este exemplo atualiza o volume especificando as tags de usuário env:test e env:prod. O valor que você obteve do parâmetro ' Etag é especificado no cabeçalho ' If-Match na chamada.

   curl -X PATCH\
   "$vpc_api_endpoint/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34?version=2025-01-21&generation=2"\
      -H "Authorization: Bearer $iam_token"\
      -H "If-Match: <_Etag-hash-string_>"\
      -d `{
         "user_tags": [
            "env:test",
            "env:prod"
         ]
      }'
   

   A resposta mostra as tags que foram adicionadas ao volume:

   {
    "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": "",
    "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": [],
    "adjustable_capacity_states": [
        "attached"
    ],
    "storage_generation": 1,
    "user_tags": [
        "env:test",
        "env:prod"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
   }
   

Atualização de um volume anexado por meio da API

Execute uma chamada PATCH /instances/$instance_id/volume_attachments/$volume_attachment_id e especifique os IDs da instância e do volume conectado. No corpo da solicitação, especifique o novo nome do anexo ou o novo valor da propriedade delete_volume_on_instance_delete. Se a propriedade delete_volume_on_instance_delete estiver definida como true, quando a instância for excluída, o volume anexado será excluído. Se você quiser manter o volume após a exclusão da instância, especifique o valor “ false ” para a propriedade “ delete_volume_on_instance_delete ”.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments/$volume_attachment_id?version=2022-04-22&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "delete_volume_on_instance_delete": false,
      "name": "my-volume-attachment-data-5iops-updated"
    }'

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

{
  "created_at": "2022-04-22T16:35:47.000Z",
  "delete_volume_on_instance_delete": false,
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5/volume_attachments/9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "id": "9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "name": "my-volume-attachment-data-5iops-updated",
  "status": "attached",
  "type": "data",
  "volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "id": "d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "name": "my-volume-data-5iops"
  }
}

Desconectando um volume com a API

Envie uma solicitação DELETE /instances/{instance_id}/volume_attachments/{id} e especifique o ID da conexão do volume para excluir uma conexão de volume. A exclusão de um anexo de volume desanexa um volume de uma instância.

curl -X DELETE "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments/$volume_attachment_id?version=2022-04-22&generation=2" \
-H "Authorization: Bearer $iam_token"

Um volume de inicialização não pode ser desconectado de uma instância enquanto ela existir. Se quiser manter o volume de inicialização depois que a instância for excluída, certifique-se de que a propriedade delete_volume_on_instance_delete no anexo do volume esteja definida como false.

Verifique se o volume foi desanexado da instância fazendo uma chamada GET /instances/{instance_id}.

Atualizando o nome de um volume com o Terraform

Para alterar o nome de um volume, use o recurso " ibm_is_volume. O exemplo a seguir especifica o volume " r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4 e seu novo nome como " my-new-name-volume. Quando aplicado, o volume é renomeado.

resource "ibm_is_volume" "example" {
  name    = "my-new-name-volume"
  id      = "r010-bdb8fc70-8afb-4622-826a-d65a9fc477a4"
  profile = "10iops-tier"
  zone    = "us-south-1"
}

Aplicação de tags a volumes com o Terraform

Para aplicar tags de usuário a um volume, use o recurso " ibm_is_volume. O exemplo a seguir especifica o volume " my-new-volume e a tag " dev:test a ser anexada ao volume. Quando aplicada, a tag é adicionada ao volume.

resource "ibm_is_volume" "example" {
  name    = "my-new-volume"
  profile = "10iops-tier"
  zone    = "us-south-1"
  tags    = ["dev:test"]
}