セールス: 1-800-867-1380

レコードの挿入操作

更新日: 2013年6月

新しいアイテムをテーブルに挿入します。

要求は、次のように指定できます。<service_name> with your mobile service name and <table_name> with the name of the table to access.

 

HTTP 動詞 要求の URI HTTP のバージョン

POST

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

HTTP/1.1

URI パラメーター

 

URI パラメーター 必須項目 説明

noscript

×

true is supplied, the execution of registered scripts is suppressed.スクリプトの実行を中止するには、X-ZUMO-MASTER ヘッダーのサービス マスター キーも指定する必要があります。

要求ヘッダー

要求ヘッダーの説明を次の表に示します。

 

要求ヘッダー 必須項目  

Accept

×

このヘッダーには、application/json を設定します。

Content-Length

要求本文の長さ。

Content-Type

×

このヘッダーには、application/json を設定します。

X-ZUMO-APPLICATION

条件

モバイル サービスのアプリケーション キー。テーブル操作へのアクセスに必要な場合は、有効なアプリケーション キーを指定する必要があります。これは既定のテーブル操作のアクセス権です。

X-ZUMO-AUTH

条件

認証されたユーザーのためのサービス生成された認証トークン。テーブル操作へのアクセスが必要な場合は、認証されたユーザーのためのトークンを指定する必要があります。

X-ZUMO-MASTER

条件

サービス マスター キー。テーブル操作へのアクセスに管理者アクセスが必要な場合は、このキーのみを含める必要があります。

securitySecurity 注
サービス マスター キーは、データ サービスへの管理者アクセスを提供する重要なセキュリティ資格情報です。この情報を他のユーザーと共有したり、アプリと共に配布したりしないでください。このキーは常に、暗号化チャネルに安全に配布する必要があります。

要求本文

挿入されるアイテムは、JavaScript Object Notation (JSON) 形式でエンコードされたオブジェクトにしてください。

応答には HTTP ステータス コード、一連の応答ヘッダー、および応答本文が含まれます。

ステータス コード

操作が正常に終了すると、ステータス コード 201 (Created) が返されます。

応答ヘッダー

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

 

応答ヘッダー 説明

Content-Length

応答本文の長さです。

Content-Type

application/json.

Location

挿入されたオブジェクトを表す URI です。この URI は、挿入されたデータ行を返す GET 要求で使用されます。

x-zumo-version

どのランタイム バージョンで要求が実行されたかを示します。

応答本文

挿入されたアイテムの JSON 表現です。これには、モバイル サービスによって作成されたアイテムの ID が含まれます。

承認はテーブル操作のアクセス許可要求によって異なり、まとめると次のようになります。

 

テーブル操作のアクセス権限 必須の承認ヘッダー

すべてのユーザー

None

アプリケーション キーを持つユーザー

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}

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2014 Microsoft