Exportar (0) Imprimir
Expandir Tudo

Excluir Contêiner

Atualizado: janeiro de 2014

A operação Delete Container marca o contêiner especificado para exclusão. O contêiner e todos os blobs contidos são excluídos posteriormente, durante a coleta de lixo.

A solicitação Delete Container pode ser criada da seguinte maneira. HTTPS é recomendado. Substitua myaccount pelo nome da sua conta de armazenamento:

 

Método URI de solicitação Versão de HTTP

DELETE

https://myaccount.blob.core.windows.net/mycontainer?restype=container

HTTP/1.1

Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome de host do emulador e a porta do serviço Blob como 127.0.0.1:10000, seguido pelo nome da conta de armazenamento emulado:

 

Método URI de solicitação Versão de HTTP

DELETE

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container

HTTP/1.1

Para obter mais informações, consulte Uso do Azure Storage Emulator para desenvolvimento e testes.

Os seguintes parâmetros adicionais podem ser especificados no URI de solicitação.

 

Parâmetro Descrição

timeout

Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Definição de tempos limite para operações de serviço Blob.

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

 

Cabeçalho de solicitação Descrição

Authorization

Obrigatória. Especifica o esquema de autenticação, o nome da conta e a assinatura. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

Date ou x-ms-date

Obrigatória. Especifica o Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

x-ms-lease-id: <ID>

Necessário para a versão 2012-02-12 e mais recente se o contêiner tiver uma concessão ativa. Para chamar Delete Container em um contêiner que tenha uma concessão ativa, especifique a ID da concessão nesse cabeçalho. Se esse cabeçalho não for especificado quando houver uma concessão ativa, Delete Container retornará 409 (Conflict). Se você especificar a ID de concessão errada ou uma ID de concessão em um contêiner que não tenha uma concessão ativa, Delete Container retornará 412 (Precondition failed).

x-ms-version

Obrigatório para todas as solicitações autenticadas. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte Controle de versão para os Serviços de Armazenamento do Azure.

x-ms-client-request-id

Opcional. Fornece um valor opaco, gerado pelo cliente, com um limite de caracteres de 1 KB que é registrado nos logs de análise quando o log de análise de armazenamento está habilitado. É altamente recomendável usar esse cabeçalho para correlacionar atividades do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o registro em log da Análise de Armazenamento e Log do Windows Azure: Usando logs para rastrear solicitações de armazenamento.

Essa operação também dará suporte ao uso de cabeçalhos condicionais para excluir o contêiner somente se uma determinada condição for atendida. Para obter mais informações, consulte Especificando cabeçalhos condicionais para operações do serviço Blob.

Request Syntax:
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1

Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 21:44:34 GMT
Authorization: SharedKey devstoreaccount1:t7mf5htNuwLFX9g0S2LDdRtRn1FQzMAluBvHy1QPpnM=

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

Uma operação bem-sucedida retorna o código de status 202 (Aceito).

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

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

x-ms-request-id

Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação. Para obter mais informações, consulte Solucionando problemas de operações de API.

x-ms-version

Indica a versão do serviço Blob usado para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recentes.

Date

Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.

Response Status:
HTTP/1.1 202 Accepted

Response Headers:
Transfer-Encoding: chunked
Content-Type: application/xml
Date: Sun, 25 Sep 2011 21:45:00 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Somente o proprietário da conta pode chamar essa operação.

Quando um contêiner é excluído, não é possível criar um contêiner com o mesmo nome por, no mínimo, 30 segundos; o contêiner poderá ficar indisponível por mais de 30 segundos se o serviço ainda estiver processando a solicitação. Durante a exclusão do contêiner, ocorrerá uma falha nas tentativas de criar um contêiner do mesmo nome com o código de status 409 (Conflito), e o serviço retornará informações adicionais sobre o erro, indicando que o contêiner está sendo excluído. Todas as outras operações, inclusive operações em todos os blobs no contêiner, falharão com o código de status 404 (Não Localizado) durante a exclusão do contêiner.

Mostrar:
© 2014 Microsoft