Share via

Tablo Oluşturma

  • Makale

İşlem, Create Table depolama hesabında yeni bir tablo oluşturur.

İstek

İsteği burada gösterildiği gibi oluşturabilirsiniz Create Table . HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin:

Yöntem İstek URI'si HTTP sürümü
POST https://myaccount.table.core.windows.net/Tables HTTP/1.1

Öykünülmüş depolama hizmeti isteği

Öykünülen depolama hizmetine karşı istekte bulunulduğunda öykünücü ana bilgisayar adını ve Azure Tablo Depolama bağlantı noktasını olarak 127.0.0.1:10002ve ardından öykünülen depolama hesabı adını belirtin:

Yöntem İstek URI'si HTTP sürümü
POST http://127.0.0.1:10002/devstoreaccount1/Tables HTTP/1.1

Depolama öykünücüsü içindeki Tablo hizmeti, Tablo Depolama hizmetinden çeşitli şekillerde farklıdır. Daha fazla bilgi için bkz. Depolama öykünücüsü ile Azure Depolama hizmetleri arasındaki farklar.

URI parametreleri

Yok.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

İstek üst bilgisi Açıklama
Authorization Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
Date veya x-ms-date Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
x-ms-version İsteğe bağlı. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
Content-Type Gereklidir. Yükün içerik türünü belirtir. Olası değerler şunlardır:

- application/atom+xml (yalnızca 2015-12-11 öncesi sürümler)
- application/json

Daha fazla bilgi için bkz. Tablo Depolama işlemleri için Yük biçimi.
Accept İsteğe bağlı. Yanıt yükünün kabul edilen içerik türünü belirtir. Olası değerler şunlardır:

- application/atom+xml (yalnızca 2015-12-11 öncesi sürümler)
- application/json;odata=nometadata
- application/json;odata=minimalmetadata
- application/json;odata=fullmetadata

Daha fazla bilgi için bkz. Tablo Hizmeti İşlemleri için Yük Biçimi.
Prefer İsteğe bağlı. Yanıtın yüke eklenen varlığı ekleyip eklemeyeceğini belirtir. Olası değerler ve return-contentdeğerleridirreturn-no-content.

Bu üst bilgi hakkında daha fazla bilgi için bkz. Ekleme işlemlerinde yanıt yankısını yönetmek için üst bilgiyi ayarlamaPrefer.
Content-Length Gereklidir. İstek gövdesinin uzunluğu.
x-ms-client-request-id İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. Azure Tablo Depolama'yı izleme.

İstek gövdesi

İstek gövdesi, oluşturulacak tablonun adını belirtir. Tablo adları, Tablo Depolama veri modelini anlama bölümünde açıklanan adlandırma kısıtlamalarına uymalıdır.

İstek gövdesi, JSON veya Atom akışı olarak ifade edilebilen bir OData varlık kümesidir.

Not

JSON önerilen yük biçimidir ve sürüm 2015-12-11 ve üzeri için desteklenen tek biçimdir.

Geçerli tablo adları hakkında yönergeler için Tablo Depolama veri modelini anlama bölümündeki "Tablo Adları" bölümüne bakın.

JSON (sürüm 2013-08-15 ve üzeri)

JSON akışı olarak istek gövdesi aşağıdaki genel biçimdedir:

{   
    "TableName":"mytable"  
}

Atom akışı (2015-12-11'den önceki sürümler)

Atom akışı olarak istek gövdesi aşağıdaki genel biçimdedir:

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

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve yanıt gövdesi içerir.

Durum kodu

Durum kodu, üst bilginin değerine Prefer bağlıdır. Prefer Üst bilgi olarak ayarlanırsa return-no-contentbaşarılı bir işlem 204 (No Content durum kodu) döndürür. Prefer Üst bilgi belirtilmezse veya olarak ayarlanırsareturn-content, başarılı bir işlem 201 ( durum kodunu döndürürCreated). Daha fazla bilgi için bkz. Ekleme işlemlerinde Prefer yanıt yankısını yönetmek için üst bilgiyi ayarlama.

Durum kodları hakkında bilgi için bkz. Durum ve hata kodları ile Tablo Depolama hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı, aşağıdaki tabloda açıklanan üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Description
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme.
x-ms-version İsteği yürütmek için kullanılan Tablo Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürülür.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
Preference-Applied İstek üst bilgisinin Prefer kabul edilip edilmediğini gösterir. Yanıt bu üst bilgiyi içermiyorsa üst Prefer bilgi kabul edilmez. Üst bilgi döndürülürse, değeri veya return-no-contentolurreturn-content.

Daha fazla bilgi için bkz. Ekleme işlemlerinde Prefer yanıt yankısını yönetmek için üst bilgiyi ayarlama.
Content-Type Yükün içerik türünü gösterir. Değer, istek üst bilgisi için belirtilen değere Accept bağlıdır. Olası değerler şunlardır:

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

İçerik türleri hakkında daha fazla bilgi için bkz. Tablo Depolama işlemleri için Yük biçimi.
x-ms-client-request-id İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir. x-ms-client-request-id Üst bilgi yoksa yanıtta yoktur.

Yanıt gövdesi

İstek üst bilgisini değeriyle return-no-contentiçeriyorsaPrefer, yanıt gövdesi döndürülmedi. Aksi takdirde, yanıt gövdesi bir OData varlık kümesidir.

Not

Yük biçimi olarak JSON önerilir. Sürüm 2015-12-11 ve üzeri için desteklenen tek biçimdir.

JSON (sürüm 2013-08-15 ve üzeri)

Çeşitli denetim düzeyleri için JSON'daki yanıt yükleri aşağıdadır.

Tam meta veriler

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

En az meta veri

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

Meta veri yok

{  
  
    "TableName":"mytable"  
  
}

Atom akışı (2015-12-11 öncesi sürümler)

İşlem için örnek bir Atom yanıtı aşağıda verilmiştır 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>

Yetkilendirme

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

Yok.

Ayrıca bkz.

Azure Depolama'ya yönelik istekleri yetkilendirme
OData veri hizmeti sürüm üst bilgilerini ayarlama
Durum ve hata kodları
Tablo Depolama hata kodları