Migração de volume de armazenamento em bloco

Migrar volumes do “ Block Storage for VPC ” dos perfis de primeira geração ( em camadas ou personalizados ) para o perfil de segunda geração “ sdp ”. Personalize o IOPS e a largura de banda durante a migração, mantendo a integridade dos dados e minimizando o tempo de inatividade.

Selecione a disponibilidade O perfil sdp está disponível apenas para contas incluídas na lista de permissões. Os clientes que não estiverem na lista de permissões não podem iniciar uma migração para o sdp no console, pela CLI, pela API ou pelo Terraform. Os volumes existentes do sdp não são afetados. Para obter mais informações, consulte “Sobre o Block Storage for VPC ”.

Ao criar um trabalho de migração, você pode personalizar os limites de IOPS e de largura de banda. Se você não especificar esses valores, o sistema aplicará os valores padrão do perfil.

Enquanto a migração estiver em andamento, o volume estará no estado updating. Todas as áreas utilizadas do volume são copiadas, e os volumes de origem e de destino são mantidos em sincronia por meio do espelhamento das gravações. Se o volume estiver conectado a uma instância, a conexão do volume à instância será convertida de forma transparente do volume de origem para o de destino assim que a operação de cópia for concluída. Você pode acompanhar o status e o progresso de seus trabalhos de migração na interface do usuário, na CLI, com a API e o Terraform.

Você pode cancelar uma migração enquanto o processo de cópia estiver em execução.

Quando a migração for concluída, o volume passará para o estado “ available ” e seguirá o modelo de cobrança do novo perfil.

A criptografia em repouso não é afetada pelo processo de migração. O volume é criptografado usando o mesmo CRK e WDEK antes e depois da migração.

Os instantâneos tirados antes da migração do volume não são migrados junto com o volume, e seus valores de geração de armazenamento permanecem inalterados. O primeiro instantâneo tirado do volume após a migração é uma cópia completa do volume e herda o valor de geração de armazenamento do volume. Os instantâneos subsequentes que são obtidos após o primeiro tornam-se instantâneos incrementais.

Se você não estiver satisfeito com o desempenho ou os recursos do volume migrado, crie um caso de suporte para ser adicionado à lista de permissões. Quando sua conta estiver na lista de permissões, você poderá iniciar uma migração para retornar o volume à geração 1.

Limitações

Os volumes de inicialização que foram criados a partir de imagens criptografadas com chaves gerenciadas pelo cliente não podem ser migrados nesta versão.
Em um período de 24 horas, uma conta pode iniciar um máximo de 10 migrações por região.
Se uma migração off-line estiver em andamento, qualquer nova solicitação de anexo de volume falhará. Para continuar com o anexo, você deve cancelar o processo de migração.
Se uma migração on-line estiver em andamento, iniciar um desprendimento de volume pode cancelar o processo de migração.
Não é possível criar novos instantâneos a partir de um volume enquanto ele estiver sendo migrado.
Se um volume estiver vinculado a uma instância de servidor virtual que utilize alocação de largura de banda em pool, esse volume não poderá ser migrado. Defina a alocação de largura de banda para weighted para dar suporte ao processo de migração de volume.
Selecione a disponibilidade Somente os volumes de segunda geração podem ser migrados de volta para um perfil de primeira geração que foram originalmente criados como volumes de primeira geração. Os volumes que foram criados com o perfil sdp não podem ser convertidos em um perfil de primeira geração.
Selecione a disponibilidade Se a capacidade de um volume migrado for aumentada para mais de 16 TB, ele não poderá ser migrado novamente para usar um perfil de primeira geração. Os perfis tradicionais de primeira geração não suportam capacidades maiores que 16 TB.

Iniciando a migração de volume no console

Você pode migrar seu volume de armazenamento para o perfil sdp selecionando Migrate volume (Migrar volume) no menu Actions (Ações), ) na lista Block storage volumes for VPC (Bloquear volumes de armazenamento para VPC).

Vá para a lista de Block Storage for VPC volumes. No site IBM Cloud console, clique no ícone Menu de navegação > Infraestrutura > Armazenamento > Block Storage volumes.
Selecione na lista o volume que você deseja migrar. Clique no menu Actions (Ações), ) e clique em Migrate volume (Migrar volume ).

A migração de volumes geralmente só está disponível para volumes de primeira geração. Para volumes de segunda geração, a opção Migrar volume é visível apenas para contas com acesso especial.
Selecione o perfil de destino. Atualmente, o único perfil de volume de segunda geração disponível é o sdp. Se quiser retornar um volume migrado para um perfil de primeira geração (perfis general-purpose, 5-iops, 10-iops ou custom ), selecione o perfil que atenda às suas necessidades de capacidade e desempenho. Os perfis que não suportam a capacidade atual de seu volume são desativados.
Clique em Migrar.

Iniciando a migração de volume a partir da CLI

Você pode migrar seu volume de armazenamento para um perfil de volume de outra geração de armazenamento usando o comando volume-job-create. Especifique a ID ou o nome do volume que você deseja converter e o perfil do volume de destino. A adição dos novos valores de IOPS e largura de banda é opcional e depende do perfil do volume de destino. Consulte o exemplo a seguir.

ibmcloud is volume-job-create r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 --profile sdp --name my-volume-migration-job --iops 3000 --bandwidth 1000

Creating volume job for r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 under account test account as user test.user@ibm.com...
ID                r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Name              my-volume-migration-job
Status            queued
Bandwidth(Mbps)   1000
IOPS              3000
Profile           sdp
Auto Delete       false
Created at        2026-03-17T14:26:02+05:30
Href              https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Job type          migrate
Resource type     volume_job

Para obter mais informações sobre todas as opções de comando disponíveis, consulte a referência da CLI do VPC.

Início da migração de volume com a API

Antes de começar, certifique-se de configurar seu ambiente de API. Para obter mais informações, consulte Configurando o seu ambiente de API e CLI.

Você pode acessar programaticamente migrar seu volume de armazenamento em um perfil de volume de outra geração de armazenamento fazendo uma solicitação POST /volumes/{volume_id}/jobs para a API do VPC. Especifique o tipo de trabalho "migrate" (migrar) e o perfil de volume de destino. Quando o volume é migrado para o perfil sdp, você pode, opcionalmente, especificar novos valores de IOPS e largura de banda. Consulte o exemplo a seguir.

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
  --request POST \
  --data '{
    "job_type": "migrate",
    "parameters": {
      "profile": {
        "name": "sdp"
      }
    },
    "name": "my-volume-migration-job"
  }'

Uma resposta bem-sucedida mostra que o trabalho de migração de volume foi criado.

{
  "auto_delete": false,
  "created_at": "2026-03-17T04:15:00.000Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "job_type": "migrate",
  "name": "my-volume-migration-job",
  "parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
  },
  "resource_type": "volume_job",
  "status": "queued",
  "status_reasons": []
}

Iniciando a migração de volume com o Terraform

Você pode migrar seu volume de armazenamento para o perfil sdp usando o recurso ibm_is_volume_job. Especifique o job_type "migrate" e o nome do trabalho de volume. A adição dos novos valores de IOPS e largura de banda é opcional e depende do perfil do volume de destino. Consulte o exemplo a seguir.

resource "ibm_is_volume_job" "vol-job1" {
  job_type = "migrate"
  name    = "vol-job1"
  parameters {
    profile {
      name = "sdp"
    }
    bandwidth = 2000
    iops      = 5000
  }
}

A progressão do status do trabalho de migração

O processo de migração não é instantâneo. A duração da migração depende do tamanho do volume. Um volume 1‑TiB normalmente leva cerca de 6 horas para ser migrado. No entanto, a migração pode demorar mais quando muitos volumes estão sendo processados ao mesmo tempo.

O trabalho de volume começa no status queued, depois passa para o estado running e, em seguida, para completed quando a operação é concluída com êxito. Durante a migração, o estado do ciclo de vida do volume é mostrado como updating. A tabela a seguir mostra os valores de status que podem ser vistos no console, na CLI e nas respostas da API quando você verifica o andamento da migração.

Status dos trabalhos de volume.
Status do trabalho de volume	Atividade
`queued`	O trabalho está na fila, esperando para começar.
`running`	O trabalho está em andamento.
`failed`	O trabalho não foi concluído.
`succeeded`	O trabalho foi concluído com sucesso.
`deleting`	O trabalho está sendo excluído.
`deleted`	O trabalho foi excluído.
`canceling`	O trabalho está sendo cancelado.
`canceled`	A tarefa foi cancelada.

Monitoramento da migração de volumes no console

É possível verificar o status e o progresso da migração do volume no console.

Vá para a lista de Block Storage for VPC volumes. No site IBM Cloud console, clique no ícone Menu de navegação > Infraestrutura > Armazenamento > Block Storage volumes.
Na lista, clique no nome do volume que você começou a migrar.
Clique na guia Volume jobs (Trabalhos de volume) para exibir a lista de trabalhos associados ao volume.
Clique no trabalho de migração que está em andamento para ver o status e o tempo estimado de conclusão.

Monitoramento da migração de volumes pela CLI

Você pode verificar o status e o progresso da migração do volume na CLI. Primeiro, liste todos os trabalhos de volume com o comando ibmcloud is volume-jobs e selecione um trabalho na saída. O exemplo a seguir usa o ID do volume para listar o trabalho de volume associado. Você também pode usar o nome do volume.

ibmcloud is volume-jobs r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3

Listing volume job for r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 under account test account as user test.user@ibm.com...
ID                                         Name       Created at                 Auto Delete  Job type  Status     Bandwidth(Mbps)   IOPS  Profile
r006-10d88923-1102-4859-a2b8-628bb9fb0d70  my-volume-migration-job   2026-03-17T14:26:02+05:30  false        migrate   succeeded  1000              3000  sdp

Em seguida, obtenha os detalhes do trabalho de volume com o comando ibmcloud is volume-job. Especifique o nome ou a ID do volume como argumento e especifique o nome ou a ID do trabalho como parte da opção --job.

ibmcloud is volume-job r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 --job r006-10d88923-1102-4859-a2b8-628bb9fb0d70

Quando a migração está em andamento, a resposta é semelhante ao exemplo a seguir:

ID                        r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Name                      my-volume-migration-job
Status                    running
Bandwidth(Mbps)           1000
IOPS                      3000
Profile                   sdp
Auto delete               false
Created at                2026-03-17T10:54:52-06:00
Estimated completion at   2026-03-17T12:03:30-06:00
Href                      https://us-south.cloud.ibm.com/v1/volumes/r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Job type                  migrate
Started at                2026-03-17T10:55:07-06:00
Resource type             volume_job

Anote a data e a hora estimadas para a conclusão na resposta.

Quando a migração estiver concluída, a resposta será semelhante ao exemplo a seguir:

Getting volume job r006-10d88923-1102-4859-a2b8-628bb9fb0d70 for r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 under account test account as user test.user@ibm.com...
ID                r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Name              my-volume-migration-job
Status            succeeded
Bandwidth(Mbps)   1000
IOPS              3000
Profile           sdp
Auto Delete       false
Completed at      2026-03-17T14:26:23+05:30
Created at        2026-03-17T14:26:02+05:30
Href              https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Job type          migrate
Started at        2026-03-17T14:26:18+05:30
Resource type     volume_job

Para obter mais informações sobre todas as opções de comando disponíveis, consulte a referência da CLI do VPC.

Monitoramento da migração de volume com a API

Você pode verificar o status e o progresso da migração do volume programaticamente com a API. Primeiro, liste os trabalhos de volume do volume e selecione um trabalho de migração na resposta da API. Em seguida, recupere o trabalho de volume selecionado.

Liste os trabalhos de migração do volume. O exemplo a seguir lista os trabalhos de migração para o volume r006-567faad4-81f4-440a-95f0-6f4c98f22c25.

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
 --request GET

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

{
"first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs?limit=50"
   },
"jobs": [
 {
   "auto_delete": false,
   "created_at": "2026-03-17T06:47:41.000Z",
   "estimated_completion_at": "2026-03-17T06:51:58.000Z",
   "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-45e29fb5-aa4a-4772-a857-da2f31a97726",
   "id": "r006-45e29fb5-aa4a-4772-a857-da2f31a97726",
   "job_type": "migrate",
   "name": "my-volume-migration-job-reverse",
   "parameters": {
     "bandwidth": 1000,
     "iops": 100,
     "profile": {
       "name": "custom"
     }
   },
   "resource_type": "volume_job",
   "started_at": "2026-03-17T06:47:44.000Z",
   "status": "running",
   "status_reasons": [
   ]
 },
 {
   "auto_delete": false,
   "completed_at": "2026-03-17T06:44:29.000Z",
   "created_at": "2026-03-17T06:40:11.000Z",
   "estimated_completion_at": "2026-03-17T06:44:25.000Z",
   "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70",
   "id": "r006-10d88923-1102-4859-a2b8-628bb9fb0d70",
   "job_type": "migrate",
   "name": "my-volume-migration-job",
   "parameters": {
     "bandwidth": 1000,
     "iops": 3000,
     "profile": {
       "name": "sdp"
     }
   },
   "resource_type": "volume_job",
   "started_at": "2026-03-17T06:40:14.000Z",
   "status": "succeeded",
   "status_reasons": [
   ]
 }
],
"limit": 50,
"total_count": 2
}

Recuperar detalhes do trabalho de migração. O exemplo a seguir usa o ID do volume 006-567faad4-81f4-440a-95f0-6f4c98f22c25 e o ID do trabalho r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d da solicitação de API anterior.

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
  --request GET

Uma resposta bem-sucedida se parece com o exemplo a seguir quando o trabalho ainda está em execução. Anote a data e a hora de conclusão estimada na resposta.

{
"auto_delete": false,
"created_at": "2026-03-17T04:15:00.000Z",
"estimated_completion_at": "2026-03-17T06:51:58.000Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
"id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
"job_type": "migrate",
"name": "my-volume-migration-job",
"parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
},
"resource_type": "volume_job",
"started_at": "2026-03-17T04:15:15.000Z",
"status": "running",
"status_reasons": []
}

Uma resposta bem-sucedida se parece com o exemplo a seguir quando o trabalho é concluído.

{
"auto_delete": false,
"completed_at": "2026-03-17T06:44:29.000Z",
"created_at": "2026-03-17T04:15:00.000Z",
"estimated_completion_at": "2026-03-17T06:51:58.000Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
"id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
"job_type": "migrate",
"name": "my-volume-migration-job",
"parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
},
"resource_type": "volume_job",
"started_at": "2026-03-17T04:15:15.000Z",
"status": "running",
"status_reasons": []
}

Monitoramento da migração de volumes com o Terraform

Importe a lista de trabalhos de volume que pertencem a um volume como uma fonte de dados somente leitura com o recurso ibm_is_volume_job.

`data "ibm_is_volume_job" "example" {
  volume_job_id = ibm_is_volume_job.example.id
  }

Atualização do trabalho de migração de volume no console

Enquanto o trabalho de migração estiver em execução, você também poderá atualizar o nome do trabalho de volume, se desejar.

Vá para a lista de Block Storage for VPC volumes. No site IBM Cloud console, clique no ícone Menu de navegação > Infraestrutura > Armazenamento > Block Storage volumes.
Na lista, clique no nome do volume que você começou a migrar.
Clique na guia Volume jobs (Trabalhos de volume) para exibir a lista de trabalhos associados ao volume.
Selecione o trabalho que você deseja atualizar. Clique no menu Actions (Ações), ) e selecione Rename (Renomear ).

Atualização do trabalho de migração de volume a partir da CLI

Enquanto o trabalho de migração estiver em execução, você também poderá atualizar o nome do trabalho de volume, se desejar, usando o comando volume-job-update. Especifique o ID do trabalho de volume que você deseja atualizar e o novo nome.

ibmcloud is volume-job-update r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 --volume-job r006-10d88923-1102-4859-a2b8-628bb9fb0d70 --name new-name-for-migration-jon

Updating volume job r006-10d88923-1102-4859-a2b8-628bb9fb0d70 for r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 under account test account as user test.user@ibm.com...
ID                        r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Name                      new-name-for-migration-job
Status                    running
Bandwidth(Mbps)           1000
IOPS                      3000
Profile                   sdp
Auto Delete               false
Created at                2026-03-17T10:54:52-06:00
Estimated completion at   2026-03-17T12:03:30-06:00
Href                      https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Job type                  migrate
Started at                2026-03-17T10:58:52-06:00
Resource type             volume_job

Para obter mais informações sobre todas as opções de comando disponíveis, consulte a referência da CLI do VPC.

Atualização do trabalho de migração de volume com a API

Enquanto o trabalho de migração estiver em execução, você também poderá atualizar o nome do trabalho de volume, se desejar, com uma solicitação PATCH/v1/volumes/{volume_id}/jobs/{job_id}. Consulte o exemplo a seguir.

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
  --request PATCH \
  --data '{
    "name": "my-updated-migration-job"
  }'

Uma resposta bem-sucedida mostra que o nome do trabalho de volume foi atualizado.

{
  "auto_delete": false,
  "created_at": "2026-03-17T04:15:00.000Z",
  "estimated_completion_at": "2026-03-17T06:51:58.000Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "job_type": "migrate",
  "name": "my-updated-migration-job",
  "parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
  },
  "resource_type": "volume_job",
  "started_at": "2026-03-17T04:15:15.000Z",
  "status": "running",
  "status_reasons": []
}

Atualização do trabalho de migração de volume com o Terraform

Enquanto o trabalho de migração estiver em execução, você também poderá atualizar o nome do trabalho de volume, se desejar, usando o recurso ibm_is_volume_job.

`resource "ibm_is_volume_job" "example" {
  volume_job_id = ibm_is_volume_job.example.id
  name          =
  }

Cancelamento da migração de volume no console

Você pode cancelar um trabalho de migração se ele ainda estiver na fase de migração no site queued ou running.

Vá para a lista de Block Storage for VPC volumes. No site IBM Cloud console, clique no ícone Menu de navegação > Infraestrutura > Armazenamento > Block Storage volumes.
Na lista, clique no nome do volume que você começou a migrar.
Clique na guia Volume jobs (Trabalhos de volume) para exibir a lista de trabalhos associados ao volume.
Selecione o trabalho que você deseja atualizar. Clique no menu Actions (Ações), ) e selecione Cancel migration (Cancelar migração ).

Cancelamento da migração de volume pela CLI

Você pode cancelar um trabalho de migração se ele ainda estiver na fase de migração usando o comando volume-job-cancel. Especifique o ID da tarefa em lote que você deseja cancelar.

ibmcloud is volume-job-cancel r006-ef750f93-70f3-45db-bb10-71901d5371e2 --volume-job r006-55e8105d-61bd-46cc-b714-042eadfc6e17

Cancelling volume job r006-55e8105d-61bd-46cc-b714-042eadfc6e17 for r006-ef750f93-70f3-45db-bb10-71901d5371e2 under account test account as user test.user@ibm.com...
ID                        r006-55e8105d-61bd-46cc-b714-042eadfc6e17
Name                      my-volume-migration-job
Status                    canceling
Bandwidth(Mbps)           1000
IOPS                      3000
Profile                   sdp
Auto delete               false
Created at                2026-03-17T17:24:53+05:30
Estimated completion at   2026-03-17T17:38:39+05:30
Href                      https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ef750f93-70f3-45db-bb10-71901d5371e2/jobs/r006-55e8105d-61bd-46cc-b714-042eadfc6e17
Job type                  migrate
Started at                2026-03-17T17:25:00+05:30
Resource type             volume_job

Para obter mais informações sobre todas as opções de comando disponíveis, consulte a referência da CLI do VPC.

Cancelamento da migração de volume com a API

Você pode cancelar uma migração se ela ainda estiver na fase de migração de forma programática, fazendo uma solicitação POST /v1/volumes/{id}/jobs/{job-id}/cancel para a API do VPC.

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d/cancel?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
  --request POST

Uma resposta bem-sucedida mostra que o trabalho de migração de volume foi cancelado.

{
  "auto_delete": false,
  "created_at": "2026-03-17T04:15:00.000Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "job_type": "migrate",
  "name": "my-volume-migration-job",
  "parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
  },
  "resource_type": "volume_job",
  "started_at": "2026-03-17T04:15:15.000Z",
  "status": "canceling",
  "status_reasons": []
}

Cancelamento da migração de volume com o Terraform

Você pode cancelar uma migração se ela ainda estiver na fase de migração usando o recurso ibm_is_volume_job_operations e adicionando o argumento cancel = true.

resource "ibm_is_volume_job_operations" "cancel" {
  cancel = true
  volume_job = ibm_is_volume_job.example.id
}

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