テーブルの作成

この操作により Create Table 、ストレージ アカウントに新しいテーブルが作成されます。

要求

次に示すように、要求を Create Table 作成できます。 HTTPS を使用することをお勧めします。 myaccount をストレージ アカウントの名前に置き換えます。

Method	要求 URI	HTTP バージョン
POST	https://myaccount.table.core.windows.net/Tables	HTTP/1.1

エミュレートされたストレージ サービス要求

エミュレートされたストレージ サービスに対して要求を行う場合は、エミュレーターのホスト名と Azure Table Storage ポートを として 127.0.0.1:10002指定し、その後にエミュレートされたストレージ アカウント名を指定します。

Method	要求 URI	HTTP バージョン
POST	http://127.0.0.1:10002/devstoreaccount1/Tables	HTTP/1.1

ストレージ エミュレーターの Table サービスは、いくつかの点で Table Storage サービスと異なります。 詳細については、「 ストレージ エミュレーターと Azure Storage サービスの違い」を参照してください。

URI パラメーター

なし。

要求ヘッダー

必須の要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー	説明
Authorization	必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
Date または x-ms-date	必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
x-ms-version	省略可能。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
Content-Type	必須。 ペイロードのコンテンツ タイプを指定します。 次のいずれかの値になります。 - application/atom+xml (2015-12-11 より前のバージョンのみ) - application/json 詳細については、「 Table Storage 操作のペイロード形式」を参照してください。
Accept	省略可能。 応答ペイロードの受け入れられたコンテンツの種類を指定します。 次のいずれかの値になります。 - application/atom+xml (2015-12-11 より前のバージョンのみ) - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata 詳細については、「 Table Service 操作のペイロード形式」を参照してください。
Prefer	省略可能。 応答で挿入されたエンティティをペイロードに含める必要があるかどうかを指定します。 設定可能な値は return-no-content および return-content です。 このヘッダーの詳細については、「 挿入操作で応答エコーを Prefer 管理するようにヘッダーを設定する」を参照してください。
Content-Length	必須。 要求本文の長さです。
x-ms-client-request-id	省略可能。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。 詳細については、「 Azure Table Storage の監視」を参照してください。

要求本文

要求本文では、作成するテーブルの名前を指定します。 テーブル名は、「 Table Storage データ モデルについて」で説明されている名前付け制限に準拠している必要があります。

要求本文は OData エンティティ セットであり、JSON または Atom フィードとして表すことができます。

注意

JSON は推奨されるペイロード形式であり、バージョン 2015-12-11 以降でサポートされている唯一の形式です。

有効なテーブル名のガイダンスについては、「 Table Storage データ モデルについて」の「テーブル名」セクションを参照してください。

JSON (バージョン 2013-08-15 以降)

JSON フィードとしての要求本文は、次の一般的な形式です。

{   
    "TableName":"mytable"  
}  

Atom フィード (2015-12-11 より前のバージョン)

Atom フィードとしての要求本文は、次の一般的な形式です。

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

[応答]

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

状態コード

ステータス コードは、Prefer ヘッダーの値によって異なります。 ヘッダーが Prefer に return-no-content設定されている場合、成功した操作は状態コード 204 (No Content) を返します。 ヘッダーが Prefer 指定されていない場合、または に return-content設定されている場合、成功した操作は状態コード 201 (Created) を返します。 詳細については、「 挿入操作で応答エコーを Prefer 管理するようにヘッダーを設定する」を参照してください。

状態コードの詳細については、「 状態とエラー コード 」および 「Table Storage のエラー コード」を参照してください。

応答ヘッダー

この操作の応答には、次の表に示すヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーも含まれる場合があります。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。

応答ヘッダー	説明
x-ms-request-id	行われた要求を一意に識別し、それを使用して要求のトラブルシューティングを行うことができます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。
x-ms-version	要求の実行に使用された Table Storage のバージョンを示します。 このヘッダーは、バージョン 2009-09-19 以降に対して行われた要求に対して返されます。
Date	サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。
Preference-Applied	Prefer 要求ヘッダーが受け入れられたかどうかを示します。 応答にこのヘッダーが含まれていない場合、 Prefer ヘッダーは受け入れられませんでした。 ヘッダーが返された場合、その値は または return-no-contentになりますreturn-content。 詳細については、「 挿入操作で応答エコーを Prefer 管理するようにヘッダーを設定する」を参照してください。
Content-Type	ペイロードのコンテンツの種類を示します。 値は、要求ヘッダーに指定された Accept 値によって異なります。 次のいずれかの値になります。 - application/atom+xml - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata コンテンツ タイプの詳細については、「 Table Storage 操作のペイロード形式」を参照してください。
x-ms-client-request-id	要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、その値に 1,024 文字以下の ASCII 文字が含まれている場合、ヘッダーの値 x-ms-client-request-id と等しくなります。 ヘッダーが x-ms-client-request-id 存在しない場合は、応答に存在しません。

応答本文

要求に値が return-no-content の Prefer ヘッダーが含まれる場合、応答本文は返されません。 それ以外の場合、応答本文は OData エンティティ セットです。

注意

ペイロード形式として JSON をお勧めします。 バージョン 2015-12-11 以降でサポートされている唯一の形式です。

JSON (バージョン 2013-08-15 以降)

さまざまな制御レベルの JSON の応答ペイロードを次に示します。

完全なメタデータ

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

最小限のメタデータ

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

メタデータなし

{  
  
    "TableName":"mytable"  
  
}  
  

Atom フィード (2015-12-11 より前のバージョン)

操作の Atom 応答のサンプルを次に示します 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>  

承認

この操作を呼び出すことができるのはアカウント所有者のみです。

解説

[なし] :

関連項目

Azure Storage への要求を承認する
OData データ サービスのバージョン ヘッダーを設定する
状態コードとエラー コード
Table Storage のエラー コード