导出 (0) 打印
全部展开

插入记录操作

更新时间: 2013年6月

向表中插入新项。

可按如下方式指定请求。请将 <service_name> 替换为您的移动服务名称,将 <table_name> 替换为要访问的表的名称。

 

HTTP 谓词 请求 URI HTTP 版本

POST

https://<service_name>.azure-mobile.net/tables/<table_name>

HTTP/1.1

URI 参数

 

URI 参数 必需 说明

noscript

提供 true 值后,即阻止执行已注册的脚本。若要阻止脚本执行,还必须在 X-ZUMO-MASTER 标头中提供服务主密钥。

请求标头

下表介绍请求标头。

 

请求标头 必需  

Accept

将此标头设置为 application/json

Content-Length

请求正文的长度。

Content-Type

将此标头设置为 application/json

X-ZUMO-APPLICATION

视情况而定

移动服务的应用程序密钥。需要访问表操作时,必须指定有效的应用程序密钥。这是默认的表操作访问权限。

X-ZUMO-AUTH

视情况而定

经过身份验证的用户的由服务生成的身份验证令牌。需要访问表操作时,必须为经过身份验证的用户指定一个令牌。

X-ZUMO-MASTER

视情况而定

服务主密钥。仅应在需要管理员访问权限以访问表操作时加入此密钥。

security安全 注释
服务主密钥是一个重要的安全凭据,它使管理员有权访问您的数据服务。请不要与任何人共享该密钥或与您的应用程序一起分发该密钥。必须始终通过加密通道安全地分发此密钥。

请求正文

插入的项必须是以 JavaScript 对象表示法 (JSON) 格式编码的对象。

响应包括 HTTP 状态代码、一组响应标头和响应正文。

状态代码

成功的操作将返回状态代码 201(已创建)。

响应标头

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

 

响应标头 说明

Content-Length

响应正文的长度。

Content-Type

标头设置为 application/json

Location

表示插入的对象的 URI。在 GET 请求中使用此 URI 返回插入的数据行。

x-zumo-version

指示执行请求的运行时的版本。

响应正文

插入的项的 JSON 表示形式,其中包括移动服务生成的项的 ID。

授权取决于表操作的访问权限要求,这些要求总结如下:

 

表操作访问权限 所需的授权标头

所有人

具有应用程序密钥的任何人

X-ZUMO-APPLICATION

仅经过身份验证的用户

X-ZUMO-AUTH

仅脚本和管理员

X-ZUMO-MASTER

在 Windows Azure 管理门户中设置个别表操作的访问权限。有关更多信息,请参见权限

以下示例 URI 在 TodoItem 表中插入一个新项。

POST https://todolist.azure-mobile.net/tables/TodoItem

该请求与以下标头一起发送。

Accept: application/json
X-ZUMO-APPLICATION: UzMAOXRlJdZyqibeUqCMoZZMrUXIRs92
Content-Type: application/json
Host: todolist.azure-mobile.net
Content-Length: 49

该请求与正文中的以下 JSON 对象一起发送。

{"text":"Complete the tutorial","complete":false}

在发送请求后,将返回以下响应。

HTTP/1.1 201 Created
Content-Type: application/json
x-zumo-version: Zumo.Main.0.1.6.527.Runtime
Date: Thu, 20 Sep 2012 05:59:27 GMT
Content-Length: 57

{"text":"Complete the tutorial","complete":false,"id":18}

显示:
© 2014 Microsoft