Skapa tabell

Åtgärden Create Table skapar en ny tabell i ett lagringskonto.

Förfrågan

Du kan skapa Create Table begäran enligt nedan. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto:

Metod	URI för förfrågan	HTTP-version
POST	https://myaccount.table.core.windows.net/Tables	HTTP/1.1

Emulerad lagringstjänstbegäran

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Azure Table Storage-porten som 127.0.0.1:10002, följt av namnet på det emulerade lagringskontot:

Metod	URI för förfrågan	HTTP-version
POST	http://127.0.0.1:10002/devstoreaccount1/Tables	HTTP/1.1

Tabelltjänsten i lagringsemulatorn skiljer sig från Table Storage-tjänsten på flera sätt. Mer information finns i Skillnader mellan lagringsemulatorn och Azure Storage-tjänster.

URI-parametrar

Inga.

Begärandehuvuden

De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabell:

Begärandehuvud	Beskrivning
Authorization	Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
Date eller x-ms-date	Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
x-ms-version	Valfritt. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
Content-Type	Krävs. Anger nyttolastens innehållstyp. Möjliga värden: - application/atom+xml (versioner tidigare än 2015-12-11 endast) - application/json Mer information finns i Nyttolastformat för Table Storage-åtgärder.
Accept	Valfritt. Anger den godkända innehållstypen för svarsnyttolasten. Möjliga värden: - application/atom+xml (versioner tidigare än 2015-12-11 endast) - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata Mer information finns i Nyttolastformat för Table Service-åtgärder.
Prefer	Valfritt. Anger om svaret ska innehålla den infogade entiteten i nyttolasten. Möjliga värden är return-no-content och return-content. Mer information om det här huvudet finns i Prefer Ange rubriken för att hantera svarseko vid infogningsåtgärder.
Content-Length	Krävs. Längden på begärandetexten.
x-ms-client-request-id	Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Table Storage.

Begärandetext

Begärandetexten anger namnet på tabellen som ska skapas. Tabellnamn måste överensstämma med namngivningsbegränsningarna som beskrivs i Förstå datamodellen för Table Storage.

Begärandetexten är en OData-entitetsuppsättning som kan uttryckas som JSON eller som en Atom-feed.

Anteckning

JSON är det rekommenderade nyttolastformatet och det är det enda format som stöds för version 2015-12-11 och senare.

Vägledning om giltiga tabellnamn finns i avsnittet "Tabellnamn" i Förstå datamodellen för Table Storage.

JSON (version 2013-08-15 och senare)

Begärandetexten som en JSON-feed har följande allmänna format:

{   
    "TableName":"mytable"  
}  

Atomfeed (tidigare versioner än 2015-12-11)

Begärandetexten som atomfeed har följande allmänna format:

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

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Statuskod

Statuskoden beror på värdet för Prefer huvudet. Prefer Om rubriken är inställd på return-no-contentreturnerar en lyckad åtgärd statuskod 204 (No Content). Prefer Om rubriken inte har angetts eller om den är inställd på return-contentreturnerar en lyckad åtgärd statuskod 201 (Created). Mer information finns i Prefer Ange rubriken för att hantera svarseko vid infogningsåtgärder.

Information om statuskoder finns i Status- och felkoder och Tabelllagringsfelkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller rubrikerna som beskrivs i följande tabell. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarsrubrik	Description
x-ms-request-id	Identifierar begäran som gjordes unikt och du kan använda den för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version	Anger den Table Storage-version som användes för att köra begäran. Det här huvudet returneras för begäranden som görs mot version 2009-09-19 och senare.
Date	Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades.
Preference-Applied	Anger om Prefer begärandehuvudet har respekterats. Om svaret inte innehåller det här huvudet Prefer har rubriken inte respekterats. Om rubriken returneras är dess värde antingen return-content eller return-no-content. Mer information finns i Prefer Ange rubriken för att hantera svarseko vid infogningsåtgärder.
Content-Type	Anger nyttolastens innehållstyp. Värdet beror på det angivna värdet för begärandehuvudet Accept . Möjliga värden: - application/atom+xml - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata Mer information om innehållstyper finns i Nyttolastformat för Table Storage-åtgärder.
x-ms-client-request-id	Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. x-ms-client-request-id Om rubriken inte finns finns den inte i svaret.

Själva svaret

Om begäran innehåller Prefer huvudet med värdet return-no-contentreturneras ingen svarstext. Annars är svarstexten en OData-entitetsuppsättning.

Anteckning

Vi rekommenderar JSON som nyttolastformat. Det är det enda format som stöds för version 2015-12-11 och senare.

JSON (version 2013-08-15 och senare)

Här är svarsnyttolaster i JSON för olika kontrollnivåer.

Fullständiga metadata

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

Minimala metadata

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

Inga metadata

{  
  
    "TableName":"mytable"  
  
}  
  

Atomfeed (tidigare versioner än 2015-12-11)

Här är ett Atom-exempelsvar för åtgärden 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>  

Auktorisering

Endast kontoägaren kan anropa den här åtgärden.

Kommentarer

Inga.

Se även

Auktorisera begäranden till Azure Storage
Ange versionshuvuden för OData-datatjänsten
Status- och felkoder
Felkoder för Table Storage