VENDITE: 1-800-867-1389

Create Table

Aggiornamento: novembre 2013

Tramite l'operazione Create Table viene creata una nuova tabella nell'account di archiviazione.

La richiesta Create Table può essere costruita nel modo seguente. Si consiglia di utilizzare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione:

 

Metodo URI della richiesta Versione HTTP

POST

https://myaccount.table.core.windows.net/Tables

HTTP/1.1

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

 

Metodo URI della richiesta Versione HTTP

POST

http://127.0.0.1:10002/devstoreaccount1/Tables

HTTP/1.1

Il servizio tabelle nell'emulatore di archiviazione differisce dal servizio tabelle di Microsoft® Azure™ sotto diversi aspetti. Per altre informazioni, vedere About Development Storage e Differenze tra l'emulatore di archiviazione e i Servizi di archiviazione Azure.

Nessuno.

Nella tabella seguente vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

 

Intestazione della richiesta Descrizione

Authorization

Obbligatorio. Specifica lo schema di autenticazione, il nome dell'account e la firma. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date o x-ms-date

Obbligatorio. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

x-ms-version

Facoltativo. Specifica la versione dell'operazione da utilizzare 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

  • application/json

Per altre informazioni, vedere Formato di payload per le operazioni del servizio tabelle.

Accept

Facoltativo. Specifica il tipo di contenuto accettato del payload di risposta. I valori possibili sono:

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

Per altre informazioni, vedere Formato di payload per le operazioni del servizio tabelle.

Prefer

Facoltativo. 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 Impostazione dell'intestazione Prefer per gestire la restituzione di risposte nelle operazioni di inserimento.

Content-Length

Obbligatorio. Lunghezza del corpo della richiesta.

x-ms-client-request-id

Facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 KB che viene registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. L'utilizzo di questa intestazione è consigliato per la correlazione tra le attività sul lato client e le richieste ricevute dal server. Per altre informazioni vedere Informazioni sulla registrazione di Analisi archiviazione e l'articolo relativo all'utilizzo di log per tenere traccia delle richiesta di archiviazione nella registrazione di Azure.

Il corpo della richiesta specifica il nome della tabella da creare. Si noti che i nomi delle tabelle devono essere conformi alle restrizioni di denominazione descritte in Informazioni sul modello di dati del servizio tabelle.

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

Atom

Il corpo della richiesta come feed Atom ha il seguente formato generale.

<?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="http://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>

JSON

Il corpo della richiesta come feed JSON ha il seguente formato generale.

{ 
    "TableName":"mytable"
}

Per istruzioni sui nomi di tabella validi, vedere la sezione Nomi di tabelle in Informazioni sul modello di dati del servizio tabelle.

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

Il codice di stato dipende dal valore dell'intestazione Prefer. Se l'intestazione Prefer è impostata su return-no-content, un'operazione completata restituisce il codice di stato 204 (No Content). Se l'intestazione Prefer non è specificata o è impostata su return-content, un'operazione completata restituisce il codice di stato 201 (Created). Per altre informazioni, vedere Impostazione dell'intestazione Prefer per gestire la restituzione di risposte nelle operazioni di inserimento.

Per informazioni sui codici di stato, vedere Codici ed errori di stato e Codici di errore del servizio tabelle.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Intestazione della risposta Descrizione

x-ms-request-id

Questa intestazione identifica in modo univoco la richiesta effettuata e può essere utilizzata per risolvere i problemi relativi alla richiesta. Per altre informazioni, vedere Risoluzione dei problemi relativi alle operazioni dell'API.

x-ms-version

Indica la versione del servizio tabelle utilizzata per eseguire la richiesta. Questa intestazione viene restituita per le richieste effettuate nella versione 2009-09-19 e successive.

Date

Valore 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 significa che l'intestazione Prefer non è stata rispettata. Se questa intestazione viene restituita, il valore sarà return-content o return-no-content.

Per altre informazioni, vedere Impostazione dell'intestazione Prefer per gestire la restituzione di risposte nelle operazioni di inserimento.

Content-Type

Indica il tipo di contenuto del payload. Il valore dipende dal valore specificato per l'intestazione della richiesta Accept. 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 di payload per le operazioni del servizio tabelle.

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.

Atom

Di seguito è riportato un esempio di risposta Atom 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="http://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>

JSON

Di seguito sono riportati i payload di risposta JSON per i differenti 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"

}

Senza metadati

{

    "TableName":"mytable"

}

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

Nessuno.

Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.
Mostra:
© 2014 Microsoft