Atualização dos anexos de software do snapshot do Block Storage for VPC

É possível atualizar o nome dos anexos de software de um snapshot.

O provisionamento de uma instância de servidor virtual a partir de uma imagem de catálogo com um plano de cobrança de software cria um volume de inicialização com um componente de software associado. O anexo de software contém o plano de software e os detalhes do software sujeito a licenciamento. Ao criar um instantâneo desse volume de inicialização, o instantâneo herda a associação de software. Os instantâneos criados antes da disponibilização desse recurso e que fazem referência a um plano de cobrança de software também são atualizados com um anexo de software. É possível atualizar o anexo de software do snapshot pela CLI, pela API ou pelo Terraform.

Atualização de um anexo de software de snapshot no console

A atualização de um anexo de software de snapshot não é suportada no console. Para atualizar um anexo de software de snapshot, use a CLI, a API ou as instruções do Terraform.

Atualizando um anexo de software de snapshot usando a CLI

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.

Para atualizar um anexo de software de snapshot, use o ibmcloud is snapshot-software-attachment-update comando. A variável SNAPSHOT é o ID ou o nome do snapshot. A variável SWAC é o ID ou o nome do anexo do software de snapshot. O valor “ --name ” é o novo nome do anexo de software de snapshot.

ibmcloud is snapshot-software-attachment-update SNAPSHOT SWAC --name NEW_NAME [--output JSON] [-q, --quiet]

O exemplo a seguir renomeia o anexo de software my-snapshot-software-attachment para my-renamed-snapshot-software-attachment no instantâneo my-snapshot.

ibmcloud is snapshot-software-attachment-update my-snapshot my-snapshot-software-attachment --name my-renamed-snapshot-software-attachment

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

Recuperação de um anexo de software de snapshot por meio da CLI

É possível recuperar um anexo de software específico de um snapshot por ID ou nome a partir da CLI. Utilização ibmcloud is snapshot-software-attachment. A variável SNAPSHOT é o ID ou o nome do snapshot. A variável SWAC é o ID ou o nome do anexo do software de snapshot.

ibmcloud is snapshot-software-attachment SNAPSHOT SWAC [--output JSON] [-q, --quiet]

  • Para recuperar um anexo de software de snapshot por ID, especifique o ID do anexo de software como a variável SWAC .

    O exemplo a seguir recupera o anexo de software com o ID r134-fbb5d014-5cf1-4bf9-af23-86fc238c3c0a para o snapshot cli-snap.

    ibmcloud is snapshot-software-attachment cli-snap r134-fbb5d014-5cf1-4bf9-af23-86fc238c3c0a

  • Para recuperar um anexo de software de snapshot pelo nome, especifique o nome do anexo de software como a variável SWAC .

    O exemplo a seguir recupera o anexo de software chamado “ twiddling-thud-stash-reliant ” para o snapshot “ cli-snap ”.

    ibmcloud is snapshot-software-attachment cli-snap twiddling-thud-stash-reliant

Para obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is snapshot-software-attachment.

Atualização de um anexo de software de snapshot por meio da API

Faça uma solicitação de “ PATCH /snapshots/{snapshot_id}/software_attachments/{id} ” e especifique o ID do snapshot e o ID do anexo de software para atualizar o anexo de software com as informações fornecidas em um objeto de patch do anexo de software do snapshot.

O exemplo a seguir atualiza um anexo de software com o ID $software_attachment_id para um snapshot com o ID $snapshot_id.

curl -X PATCH "https://us-south.iaas.cloud.ibm.com/v1/snapshots/$snapshot_id/software_attachments/$software_attachment_id?version=2026-06-23&generation=2" \
  -H "accept: application/json" \
  -H "Content-Type: application/merge-patch+json" \
  -H "Authorization: Bearer $iam_token" \
  -d '{"name":"my-renamed-snapshot-software-attachment"}'

Para obter mais informações, consulte “Atualizar um anexo de software de instantâneo” na referência da API da VPC.

Como recuperar um anexo de software de instantâneo usando a API

Envie uma solicitação de “ GET /snapshots/{snapshot_id}/software_attachments/{id} ” e especifique o ID do anexo de software e o ID do snapshot. Esta solicitação recupera um único anexo de software do tipo “snapshot” especificado por um identificador na URL.

O exemplo a seguir recupera um anexo de software específico com o ID $software_attachment_id para um snapshot com o ID $snapshot_id.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/snapshot/$snapshot_id/software_attachments/$software_attachment_id?version=2026-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token"

Para obter mais informações, consulte “Recuperar um anexo de software de snapshot ” na API da VPC.

Próximas etapas