你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

创建表

该 Create Table 操作在存储帐户中创建新表。

请求

可以构造请求， Create Table 如下所示。 建议使用 HTTPS。 将 myaccount 替换为存储帐户的名称：

方法	请求 URI	HTTP 版本
POST	https://myaccount.table.core.windows.net/Tables	HTTP/1.1

模拟存储服务请求

对模拟存储服务发出请求时，将模拟器主机名和 Azure 表存储端口指定为 127.0.0.1:10002，后跟模拟的存储帐户名称：

方法	请求 URI	HTTP 版本
POST	http://127.0.0.1:10002/devstoreaccount1/Tables	HTTP/1.1

存储模拟器中的表服务在多个方面与表存储服务不同。 有关详细信息，请参阅 存储模拟器与 Azure 存储服务之间的差异。

URI 参数

无。

请求标头

下表描述了必需的和可选的请求标头：

请求标头	说明
Authorization	必需。 指定授权方案、帐户名称和签名。 有关详细信息，请参阅授权对 Azure 存储的请求。
Date 或 x-ms-date	必需。 指定请求的协调世界时 (UTC)。 有关详细信息，请参阅授权对 Azure 存储的请求。
x-ms-version	可选。 指定用于此请求的操作的版本。 有关详细信息，请参阅 Azure 存储服务的版本控制。
Content-Type	必需。 指定有效负载的内容类型。 可能的值包括： - application/atom+xml (低于 2015-12-11 的版本仅) - application/json 有关详细信息，请参阅 表存储操作的有效负载格式。
Accept	可选。 指定响应负载已接受的内容类型。 可能的值包括： - application/atom+xml (低于 2015-12-11 的版本仅) - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata 有关详细信息，请参阅 表服务操作的有效负载格式。
Prefer	可选。 指定响应是否应包含负载中插入的实体。 可能值为 return-no-content 和 return-content。 有关此标头的详细信息，请参阅 设置 Prefer 标头以管理插入操作上的响应回显。
Content-Length	必需。 请求正文的长度。
x-ms-client-request-id	可选。 提供客户端生成的不透明值，其中包含 1-kiB (KiB) 配置日志记录时记录在日志中的字符限制。 强烈建议使用此标头将客户端活动与服务器接收的请求相关联。 有关详细信息，请参阅 监视 Azure 表存储。

请求正文

请求正文指定要创建的表的名称。 表名称必须符合 了解表存储数据模型中所述的命名限制。

请求正文是 OData 实体集，可以表示为 JSON 或 Atom 源。

注意

JSON 是建议的有效负载格式，它是版本 2015-12-11 及更高版本支持的唯一格式。

有关有效表名称的指导，请参阅 了解表存储数据模型中的“表名称”部分。

JSON (版本 2013-08-15 及更高版本)

作为 JSON 源的请求正文采用以下常规格式：

{   
    "TableName":"mytable"  
}  

原子源 (早于 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 标头以管理插入操作的响应回显。

有关状态代码的信息，请参阅 状态和错误代码 和 表存储错误代码。

响应头

此操作的响应包括下表中所述的标头。 响应可能还包括其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范。

响应标头	说明
x-ms-request-id	唯一标识发出的请求，你可以使用它对请求进行故障排除。 有关详细信息，请参阅 API 操作疑难解答。
x-ms-version	指示用于执行请求的表存储版本。 对于针对版本 2009-09-19 及更高版本发出的请求，返回此标头。
Date	由服务生成的 UTC 日期/时间值，指示启动响应的时间。
Preference-Applied	指示是否接受 Prefer 请求标头。 如果响应不包含此标头，则 Prefer 不遵循标头。 如果返回标头，则其值为 return-content 或 return-no-content。 有关详细信息，请参阅 设置 Prefer 标头以管理插入操作的响应回显。
Content-Type	指示负载的内容类型。 该值取决于为 Accept 请求标头指定的值。 可能的值包括： - application/atom+xml - application/json;odata=nometadata - application/json;odata=minimalmetadata - application/json;odata=fullmetadata 有关内容类型的详细信息，请参阅 表存储操作的有效负载格式。
x-ms-client-request-id	可用于对请求和相应响应进行故障排除。 如果请求中存在此标头的值，并且该值包含不超过 1，024 个可见 ASCII 字符，则此标头的值等于该标头的值 x-ms-client-request-id 。 x-ms-client-request-id如果标头不存在，则响应中不存在该标头。

响应正文

如果请求包含的 Prefer 标头具有值 return-no-content，则不返回响应正文。 否则，响应正文将是一个 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 存储的请求
设置 OData 数据服务版本标头
状态和错误代码
表存储错误代码