Create Table

  • Articolo

L'operazione Create Table crea una nuova tabella in un account di archiviazione.

Richiesta

È possibile costruire la Create Table richiesta come illustrato qui. È consigliabile usare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione:

Metodo URI richiesta Versione HTTP
POST https://myaccount.table.core.windows.net/Tables HTTP/1.1

Richiesta del servizio di archiviazione emulata

Quando si effettua una richiesta con il servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta di archiviazione tabelle di Azure come 127.0.0.1:10002, seguita dal nome dell'account di archiviazione emulato:

Metodo URI richiesta Versione HTTP
POST http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

Il servizio Tabella nell'emulatore di archiviazione differisce dal servizio Archiviazione tabelle in diversi modi. Per altre informazioni, vedere Differenze tra l'emulatore di archiviazione e i servizi di archiviazione di Azure.

Parametri URI

Nessuno.

Intestazioni della richiesta

Le intestazioni di richiesta obbligatorie e facoltative sono descritte nella tabella seguente:

Intestazione della richiesta Descrizione
Authorization Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
Date o x-ms-date Obbligatorio. Specifica la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
x-ms-version Facoltativa. Specifica la versione dell'operazione da usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.
Content-Type Obbligatorio. Specifica il tipo di contenuto del payload. I valori possibili sono:

- application/atom+xml (versioni precedenti al solo 2015-12-11)
- application/json

Per altre informazioni, vedere Formato payload per le operazioni di archiviazione tabelle.
Accept Facoltativa. Specifica il tipo di contenuto accettato del payload di risposta. I valori possibili sono:

- application/atom+xml (versioni precedenti al solo 2015-12-11)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Per altre informazioni, vedere Formato payload per le operazioni del servizio tabelle.
Prefer Facoltativa. Specifica se la risposta deve includere nel payload l'entità inserita. I valori possibili sono return-no-content e return-content.

Per altre informazioni su questa intestazione, vedere Impostare l'intestazione per gestire l'eco Prefer della risposta sulle operazioni di inserimento.
Content-Length Obbligatorio. Lunghezza del corpo della richiesta.
x-ms-client-request-id Facoltativa. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log quando la registrazione è configurata. È consigliabile usare questa intestazione per correlare le attività lato client con le richieste ricevute dal server. Per altre informazioni, vedere Monitorare Archiviazione tabelle di Azure.

Testo della richiesta

Il corpo della richiesta specifica il nome della tabella da creare. I nomi delle tabelle devono essere conformi alle restrizioni di denominazione descritte in Comprendere il modello di dati di archiviazione tabelle.

Il corpo della richiesta è un set di entità OData, che può essere espresso come JSON o come feed Atom.

Nota

JSON è il formato del payload consigliato ed è l'unico formato supportato per la versione 2015-12-11 e versioni successive.

Per indicazioni sui nomi di tabella validi, vedere la sezione "Nomi tabella" in Informazioni sul modello di dati di Archiviazione tabelle.

JSON (versione 2013-08-15 e versioni successive)

Il corpo della richiesta come feed JSON è nel formato generale seguente:

{   
    "TableName":"mytable"  
}

Feed Atom (versioni precedenti al 2015-12-11)

Il corpo della richiesta come feed Atom è nel formato generale seguente:

<?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>

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Codice stato

Il codice di stato dipende dal valore dell'intestazione Prefer. Se l'intestazione è impostata su return-no-content, un'operazione con esito positivo restituisce il Prefer codice di stato 204 (No Content). Se l'intestazione non è specificata o se è impostata su return-content, un'operazione con esito positivo restituisce il Prefer codice di stato 201 (Created). Per altre informazioni, vedere Impostare l'intestazione per gestire l'eco Prefer della risposta sulle operazioni di inserimento.

Per informazioni sui codici di stato, vedere Codici di errore e codici di errore e codici di errore di archiviazione tabelle.

Intestazioni di risposta

La risposta per questa operazione include le intestazioni descritte nella tabella seguente. La risposta potrebbe includere anche intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Intestazione risposta Descrizione
x-ms-request-id Identifica in modo univoco la richiesta effettuata e puoi usarla per risolvere la risoluzione dei problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni api.
x-ms-version Indica la versione di Archiviazione tabelle usata per eseguire la richiesta. Questa intestazione viene restituita per le richieste effettuate rispetto alla versione 2009-09-19 e successive.
Date Valore di data/ora UTC generato dal servizio, che indica l'ora in cui è stata avviata la risposta.
Preference-Applied Indica se l'intestazione della richiesta Prefer è stata rispettata. Se la risposta non include questa intestazione, l'intestazione Prefer non è stata onorata. Se l'intestazione viene restituita, il relativo valore sarà return-content o return-no-content.

Per altre informazioni, vedere Impostare l'intestazione per gestire l'eco Prefer della risposta sulle operazioni di inserimento.
Content-Type Indica il tipo di contenuto del payload. Il valore dipende dal valore specificato per l'intestazione della Accept richiesta. I valori possibili sono:

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

Per altre informazioni sui tipi di contenuto, vedere Formato payload per le operazioni di archiviazione tabelle.
x-ms-client-request-id Può essere usato per risolvere le richieste e le risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id se presente nella richiesta e il valore non contiene più di 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente, non è presente nella risposta.

Corpo della risposta

Se la richiesta include l'intestazione Prefer con il valore return-no-content, non viene restituito alcun corpo di risposta. In caso contrario, il corpo della risposta è un set di entità OData.

Nota

È consigliabile usare JSON come formato di payload. È l'unico formato supportato per la versione 2015-12-11 e successive.

JSON (versione 2013-08-15 e successive)

Ecco i payload di risposta in JSON per vari livelli di controllo.

Metadati completi

{  
  
    "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"  
  
}

Metadati minimi

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

Nessun metadati

{  
  
    "TableName":"mytable"  
  
}

Feed Atom (versioni precedenti al 2015-12-11)

Ecco una risposta Atom di esempio per l'operazione Create Table .

<?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>

Autorizzazione

Solo il proprietario dell'account può chiamare questa operazione.

Commenti

Nessuno.

Vedi anche

Autorizzare le richieste ad Archiviazione di Azure
Impostare le intestazioni della versione del servizio dati OData
Stato e codici errore
Codici di errore di archiviazione tabelle