Eliminar Blob

A Delete Blob operação marca a bolha ou o instantâneo especificados para eliminação. A bolha é mais tarde apagada durante a recolha do lixo.

Note que para eliminar uma bolha, deve apagar todas as suas imagens. Pode apagar ambos ao mesmo tempo com a Delete Blob operação.

Pedir

O Delete Blob pedido pode ser construído da seguinte forma. HTTPS é recomendado. Substitua a minha conta pelo nome da sua conta de armazenamento:

APAGAR Pedido de Método URI Versão HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>
HTTP/1.1

Serviço de armazenamento emulsionado URI

Ao fazer um pedido contra o serviço de armazenamento emulsionado, especifique o nome de anfitrião emulador e a porta de serviço Blob como 127.0.0.1:10000 , seguido do nome da conta de armazenamento emulada:

APAGAR Pedido de Método URI Versão HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

Para obter mais informações, consulte a Utilização do Armazenamento Emulator Azure para Desenvolvimento e Testes.

Parâmetros URI

Os seguintes parâmetros adicionais podem ser especificados no pedido URI.

Parâmetro Descrição
snapshot Opcional. O parâmetro instantâneo é um valor opaco DateTime que, quando presente, especifica o instantâneo blob para apagar. Para obter mais informações sobre o trabalho com imagens blob, consulte Criar uma Imagem instantânea de uma bolha.
versionid Opcional, versão 2019-12-12 e mais recente. O parâmetro versídico é um valor opaco DateTime que, quando presente, especifica a versão da bolha para eliminar.
timeout Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, consulte os intervalos de definição para operações de serviço de blob.
deletetype Opcional, versão 2020-02-10 ou posterior. O valor de deletetype só pode permanent ser. Para mais informações, consulte comentários abaixo.

Pedido cabeçalhos

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.

Cabeçalho do Pedido Description
Authorization Obrigatório. Especifica o esquema de autorização, nome da conta e assinatura. Para mais informações, consulte Os pedidos autorizados à Azure Armazenamento.
Date ou x-ms-date Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para mais informações, consulte Os pedidos autorizados à Azure Armazenamento.
x-ms-version Requerido para todos os pedidos autorizados. Para mais informações, consulte a versão para os Serviços Azure Armazenamento.
x-ms-lease-id:<ID> Necessário se a bolha tiver um arrendamento ativo.

Para realizar esta operação numa bolha com um arrendamento ativo, especifique o ID de locação válido para este cabeçalho. Se não for especificado um ID de locação válido no pedido, a operação falhará com o código de estado 403 (Proibido).
x-ms-delete-snapshots: {include, only} Necessário se a bolha tiver instantâneos associados. Especificar uma das duas opções seguintes:

- include: Elimine a bolha de base e todas as suas fotografias.
- only: Elimine apenas as fotos da bolha e não a bolha em si.

Este cabeçalho deve ser especificado apenas para um pedido contra o recurso blob base. Se este cabeçalho for especificado num pedido para apagar uma imagem individual, o código de estado do serviço Blob 400 (Mau Pedido).

Se este cabeçalho não for especificado no pedido e o blob tiver instantâneos associados, o código de estado do serviço Blob 409 (Conflito).
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 KiB que é gravado nos registos de análise quando o registo de análise de armazenamento está ativado. Recomenda-se a utilização deste cabeçalho para correlacionar as atividades do lado do cliente com os pedidos recebidos pelo servidor. Para obter mais informações, consulte Sobre Armazenamento Analítica registação e registo de registos Azure: Utilização de Registos para rastrear pedidos de Armazenamento.

Esta operação também suporta a utilização de cabeçalhos condicional para apagar a bolha apenas se uma condição especificada for satisfeita. Para obter mais informações, consulte especificar cabeçalhos condicional para operações de serviço de bolhas.

Corpo do Pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.

Código de Estado

Uma operação bem sucedida devolve o código de estado 202 (Aceite).

Para obter informações sobre códigos de estado, consulte códigos de estado e de erro.

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos standard estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho de Resposta Descrição
x-ms-request-id Este cabeçalho identifica exclusivamente o pedido que foi feito e pode ser usado para resolver problemas no pedido. Para obter mais informações, consulte operações de API de resolução de problemas.
x-ms-version Indica a versão do serviço Blob utilizado para executar o pedido. Este cabeçalho é devolvido para pedidos feitos contra a versão 2009-09-19 e acima.
x-ms-delete-type-permanent Para as versões 2017-07-29 e posteriormente, o serviço Blob retorna verdadeiramente se a bolha tiver sido permanentemente apagada, e falsa se a bolha tiver sido apagada suavemente.
Date Uma data/valor de hora UTC gerado pelo serviço que indica o momento em que a resposta foi iniciada.
x-ms-client-request-id Este cabeçalho pode ser usado para resolver pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente no pedido e o valor for no máximo 1024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, este cabeçalho não estará presente na resposta.

Autorização

Esta operação pode ser realizada pelo proprietário da conta ou por qualquer pessoa que utilize uma Assinatura de Acesso Partilhado que tenha permissão para apagar a bolha.

Observações

Se a bolha tiver um contrato de arrendamento ativo, o cliente deve especificar um ID de locação válido no pedido para eliminá-lo.

Se uma bolha tiver um grande número de instantâneos, é possível que a Delete Blob operação tenha um tempo de tempo. Se isso acontecer, o cliente deve voltar a tentar o pedido.

Para a versão 2013-08-15 e posteriormente, o cliente pode ligar Delete Blob para apagar bolhas não comprometidas. Uma bolha não comprometida é uma bolha que foi criada com chamadas para a operação Put Block mas nunca comprometida com a operação Put Block List. Para versões anteriores, o cliente deve cometer a bolha primeiro antes de a eliminar.

Funcionalidade de eliminação suave desativada

Quando uma bolha é eliminada com sucesso, é imediatamente removida do índice da conta de armazenamento e já não está acessível aos clientes. Os dados da bolha são posteriormente removidos do serviço durante a recolha do lixo.

Funcionalidade de eliminação suave ativada

Quando uma bolha é eliminada com sucesso, é suavemente eliminada e já não é acessível aos clientes. O serviço Blob mantém o blob ou instantâneo para o número de dias especificados para a propriedade DeleteRetentionPolicy do serviço Blob. Para obter informações sobre a leitura das propriedades do serviço Blob, consulte As Propriedades de Serviço Blob set.

Após o número especificado de dias, os dados da bolha são removidos do serviço durante a recolha do lixo. Uma bolha ou instantâneo suavemente apagado está acessível chamando a operação List Blobs e especificando a include=deleted opção.

Bolha ou instantâneo apagado macio pode ser restaurado usando Undelete Blob.

Para qualquer outra operação em blob ou snapshot apagado suave, o Blob Service devolve o erro 404 (ResourceNotFound).

Eliminação Permanente

Uma funcionalidade para eliminar permanentemente um snapshot/versão foi adicionada para eliminar a API blob com a versão 2020-02-10 e mais tarde. Para alavancar a funcionalidade, a conta de armazenamento precisa de ter uma eliminação permanente ativada. Para obter mais informações, consulte As Propriedades de Serviço Blob .

Armazenamento contas com exclusão permanente ativado pode utilizar o deletetype=permanent parâmetro de consulta para eliminar permanentemente uma versão de instantâneo ou blob eliminado. O serviço Blob devolveria 409 (Conflito) se o parâmetro de consulta apresentar com um dos seguintes:

  • A eliminação permanente não está ativada para a conta de armazenamento.
  • Nem versionid snapshot são fornecidos.
  • O instantâneo ou versão especificado não é (macio) eliminado.

A eliminação permanente também inclui uma nova permissão SAS (y) conceder permissão para eliminar permanentemente uma versão blob snapshot ou blob. Para mais informações, consulte Criar um serviço SAS.

Ver também

Autorizar pedidos à Azure Armazenamento
Códigos de Estado e erro
Códigos de erro de serviço blob Undelete Blob List Blob