Crear tabla

  • Artículo

La Create Table operación crea una nueva tabla en una cuenta de almacenamiento.

Request

Puede construir la Create Table solicitud como se muestra aquí. Se recomienda usar HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento:

Método URI de solicitud Versión de HTTP
POST https://myaccount.table.core.windows.net/Tables HTTP/1.1

Solicitud de servicio de almacenamiento emulada

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
POST http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

Table service en el emulador de almacenamiento difiere del servicio 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

Los encabezados de solicitud obligatorios y opcionales se describen en la tabla siguiente:

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.
Accept Opcional. Especifica el tipo de contenido aceptado de la carga de respuesta. Los valores posibles son:

- application/atom+xml (solo versiones anteriores a 2015-12-11)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Para más información, consulte Formato de carga para las operaciones de Table Service.
Prefer Opcional. Especifica si la respuesta debe incluir la entidad insertada en la carga. Los valores posibles son return-no-content y return-content.

Para obtener más información sobre este encabezado, vea Establecer el encabezado para administrar el Prefer eco de respuesta en las operaciones de inserción.
Content-Length Necesario. Longitud del cuerpo de la solicitud.
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

El cuerpo de la solicitud especifica el nombre de la tabla que se va a crear. Los nombres de tabla deben cumplir las restricciones de nomenclatura que se describen en Descripción del modelo de datos de Table Storage.

El cuerpo de la solicitud es un conjunto de entidades OData, que se puede expresar como JSON o como una fuente Atom.

Nota:

JSON es el formato de carga recomendado y es el único formato compatible con la versión 2015-12-11 y posteriores.

Para obtener instrucciones sobre los nombres de tabla válidos, consulte la sección "Nombres de tabla" en Descripción del modelo de datos de Table Storage.

JSON (versión 2013-08-15 y posteriores)

El cuerpo de la solicitud como fuente JSON tiene el siguiente formato general:

{   
    "TableName":"mytable"  
}

Fuente Atom (versiones anteriores a 2015-12-11)

El cuerpo de la solicitud como fuente Atom tiene el siguiente formato general:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>     
  <entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices"   
    xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"  
    xmlns="https://www.w3.org/2005/Atom">   
    <title />   
    <updated>2009-03-18T11:48:34.9840639-07:00</updated>   
    <author>  
      <name/>   
    </author>   
      <id/>   
      <content type="application/xml">  
        <m:properties>  
          <d:TableName>mytable</d:TableName>  
        </m:properties>  
      </content>   
    </entry>

Response

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

status code

El código de estado depende del valor del encabezado Prefer. Si el Prefer encabezado se establece return-no-contenten , una operación correcta devuelve el código de estado 204 (No Content). Si no se especifica el Prefer encabezado o si se establece return-contenten , una operación correcta devuelve el código de estado 201 (Created). Para obtener más información, consulte Establecimiento del encabezado para administrar el Prefer eco de respuesta en las operaciones de inserción.

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 de esta operación incluye los encabezados que se describen en la tabla siguiente. La respuesta también puede incluir encabezados HTTP estándar adicionales. 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 Identifica de forma única la solicitud que se realizó y puede usarla 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 que se usó para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y posteriores.
Date Valor de fecha y hora UTC generado por el servicio, que indica la hora a la que se inició la respuesta.
Preference-Applied Indica si el encabezado de solicitud Prefer se ha respetado. Si la respuesta no incluye este encabezado, no se respeta el Prefer encabezado. Si se devuelve el encabezado, su valor será return-content o return-no-content.

Para obtener más información, consulte Establecimiento del encabezado para administrar el Prefer eco de respuesta en las operaciones de inserción.
Content-Type Indica el tipo de contenido de la carga. El valor depende del valor especificado para el encabezado de Accept solicitud. Los valores posibles son:

- application/atom+xml
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Para obtener más información sobre los tipos de contenido, consulte Formato de carga para las operaciones de Table Storage.
x-ms-client-request-id Se puede usar 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 y el valor no contiene más de 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente, no está presente en la respuesta.

Response body

Si la solicitud incluye el encabezado Prefer con el valor return-no-content, no se devuelve ningún cuerpo de respuesta. De lo contrario, el cuerpo de respuesta es un conjunto de entidades OData.

Nota:

Se recomienda JSON como formato de carga. Es el único formato compatible con la versión 2015-12-11 y versiones posteriores.

JSON (versión 2013-08-15 y posteriores)

Estas son las cargas de respuesta en JSON para varios niveles de control.

Metadatos completos

{  
  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables/@Element",  
  
    "odata.type":" myaccount.Tables",  
  
    "odata.id":"https://myaccount.table.core.windows.net/Tables('mytable')",  
  
    "odata.editLink":"Tables('mytable')",  
  
    "TableName":"mytable"  
  
}

Metadatos mínimos

{  
  
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables/@Element",  
  
    "TableName":"mytable"  
  
}

Sin metadatos

{  
  
    "TableName":"mytable"  
  
}

Fuente atom (versiones anteriores a 2015-12-11)

Esta es una respuesta atom de ejemplo para la Create Table operación.

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<entry xml:base="https://myaccount.table.core.windows.net/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="https://www.w3.org/2005/Atom"> <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>  
  <title type="text"></title>  
  <updated>2013-10-24T17:18:54.7062347Z</updated>  
  <author>  
    <name />  
  </author>  
  <link rel="edit" title="Tables" href="Tables('mytable')" />  
  <category term="myaccount.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />  
  <content type="application/xml">  
    <m:properties>  
      <d:TableName>mytable</d:TableName>  
    </m:properties>  
  </content>  
</entry>

Authorization

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

Observaciones

Ninguno.

Consulte también

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