テーブルの作成
この操作により 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 のエラー コード