Eliminar tabla

La operación Delete Table elimina la tabla especificada y los datos que contiene.

Request

Puede construir la Delete Table solicitud como se indica a continuación. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento y mytable por el nombre de la tabla que se va a eliminar.

Método URI de solicitud Versión de HTTP
DELETE https://myaccount.table.core.windows.net/Tables('mytable') HTTP/1.1

URI del servicio de almacenamiento emulado

Al realizar una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto de Azure Table Storage como 127.0.0.1:10002, seguido del nombre de la cuenta de almacenamiento emulada.

Método URI de solicitud Versión de HTTP
DELETE http://127.0.0.1:10002/devstoreaccount1/Tables('mytable') HTTP/1.1

Table Storage en el servicio de almacenamiento emulado difiere de Azure Table Storage de varias maneras. Para más información, consulte Diferencias entre el emulador de almacenamiento y los servicios de Azure Storage.

Parámetros del identificador URI

Ninguno.

Encabezados de solicitud

La solicitud debe incluir el Authorization encabezado y el Date encabezado o x-ms-date , tal y como se especifica en Autorización de solicitudes a Azure Storage. En la tabla siguiente se describen otros encabezados adicionales.

Encabezado de solicitud Descripción
Authorization Necesario. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
x-ms-version Opcional. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Versiones de los servicios de Azure Storage.
Content-Type Necesario. Especifica el tipo de contenido de la carga. Los valores posibles son:

- application/atom+xml (solo versiones anteriores a 2015-12-11)
- application/json

Para más información, consulte Formato de carga para las operaciones de Table Storage.
x-ms-client-request-id Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kibibyte (KiB) que se registra en los registros cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor. Para más información, consulte Supervisión de Azure Table Storage.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

status code

Una operación correcta devuelve el código de estado 204 (Sin contenido). Para obtener información sobre los códigos de estado, consulte Códigos de error y estado y Códigos de error de Table Storage.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir encabezados HTTP adicionales y estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Encabezado de respuesta Descripción
x-ms-request-id Este encabezado identifica de forma única la solicitud que se realizó y se puede usar para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
x-ms-version Indica la versión de Table Storage usada para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y versiones posteriores.
Date Valor de fecha y hora UTC que indica la hora a la que se inició la respuesta. Este servicio genera este valor.
x-ms-client-request-id Puede usar este encabezado para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado, si está presente en la solicitud. El valor tiene como máximo 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, este encabezado no estará presente en la respuesta.

Response body

Ninguno.

Authorization

Solo el propietario de la cuenta puede llamar a esta operación.

Comentarios

Cuando se elimina correctamente una tabla, se marca inmediatamente para su eliminación y ya no es accesible para los clientes. La tabla se quita posteriormente de Table Storage durante la recolección de elementos no utilizados.

Tenga en cuenta que la eliminación de una tabla suele llevar como mínimo 40 segundos. Si intenta realizar una operación en la tabla mientras se elimina, el servicio devuelve el código de estado 409 (conflicto). El servicio devuelve información de error adicional que indica que se está eliminando la tabla.

Consulte también

Códigos de error de Table Storage
Establecimiento de los encabezados de versión del servicio de datos de OData
Autorización de solicitudes a Azure Storage
Estado y códigos de error