Eliminar Tabela

  • Artigo

A Delete Table operação elimina a tabela especificada e quaisquer dados que contenha.

Pedir

Pode construir o pedido da Delete Table seguinte forma. É recomendado HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento e mytable pelo nome da tabela a eliminar.

Método URI do pedido Versão HTTP
DELETE https://myaccount.table.core.windows.net/Tables('mytable') HTTP/1.1

URI do serviço de armazenamento emulado

Quando fizer um pedido contra o serviço de armazenamento emulado, especifique o nome de anfitrião do emulador e a porta do Armazenamento de Tabelas do Azure como 127.0.0.1:10002, seguido do nome da conta de armazenamento emulada.

Método URI do pedido Versão HTTP
DELETE http://127.0.0.1:10002/devstoreaccount1/Tables('mytable') HTTP/1.1

O Armazenamento de Tabelas no serviço de armazenamento emulado difere do Armazenamento de Tabelas do Azure de várias formas. Para obter mais informações, veja Diferenças entre o emulador de armazenamento e os serviços de Armazenamento do Azure.

Parâmetros URI

Nenhum.

Cabeçalhos do pedido

O pedido tem de incluir o Authorization cabeçalho e o Date cabeçalho ou x-ms-date , conforme especificado em Autorizar pedidos para o Armazenamento do Azure. Os cabeçalhos adicionais são descritos na tabela seguinte.

Cabeçalho do pedido Description
Authorization Obrigatório. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
Date ou x-ms-date Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
x-ms-version Opcional. Especifica a versão da operação a utilizar para este pedido. Para obter mais informações, veja Controlo de versões dos serviços de Armazenamento do Azure.
Content-Type Obrigatório. Especifica o tipo de conteúdo do payload. Os valores possíveis são:

- application/atom+xml (versões anteriores apenas a 2015-12-11)
- application/json

Para obter mais informações, veja Formato payload para operações de Armazenamento de Tabelas.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de carateres de 1 kibibyte (KiB) que é registado nos registos quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe. Para obter mais informações, veja Monitorizar o Armazenamento de Tabelas do Azure.

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 204 (Sem Conteúdo). Para obter informações sobre códigos de estado, veja Códigos de estado e de erro e códigos de erro do Armazenamento de Tabelas.

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 padrão 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 utilizado para resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API.
x-ms-version Indica a versão do Armazenamento de Tabelas utilizada para executar o pedido. Este cabeçalho é devolvido para pedidos feitos na versão 2009-09-19 e posterior.
Date Um valor de data/hora UTC que indica a hora em que a resposta foi iniciada. Este serviço gera este valor.
x-ms-client-request-id Pode utilizar este cabeçalho para resolver problemas de 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. O valor é, no máximo, 1024 carateres 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.

Corpo da resposta

Nenhum.

Autorização

Apenas o proprietário da conta pode chamar esta operação.

Observações

Quando elimina uma tabela com êxito, esta é imediatamente marcada para eliminação e já não está acessível aos clientes. A tabela é posteriormente removida do Armazenamento de Tabelas durante a recolha de lixo.

Tenha em atenção que a eliminação de uma tabela poderá demorar, pelo menos, 40 segundos a concluir. Se tentar uma operação na tabela enquanto esta está a ser eliminada, o serviço devolve o código de estado 409 (Conflito). O serviço devolve informações de erro adicionais que indicam que a tabela está a ser eliminada.

Ver também

Códigos de erro do Armazenamento de Tabelas
Definir os cabeçalhos da versão do serviço de dados OData
Autorizar pedidos para o Armazenamento do Azure
Códigos de estado e de erro