Force.com REST API 開発者ガイド
jBatch
1 回の要求で最大 25 個のサブ要求を実行してアプリケーションのパフォーマンスを向上させます。バッチ内のサブ要求のレスポンスボディと HTTP 状況は、1 つのレスポンスボディで返されます。各サブ要求は、レート制限にカウントされます。このリソースは、クライアントとサーバ間の往復回数を最小限に抑えるために作成します。
バッチ内の各要求はサブ要求と呼ばれます。サブ要求はすべて同じユーザのコンテキスト内で実行されます。各サブ要求は独立しており、相互に情報を渡すことはできません。サブ要求は、リクエストボディ内の順序に従って実行されます。サブ要求が正常に実行されると、データがコミットされます。コミットは、以降のサブ要求の出力に反映されます。サブ要求が失敗した場合、前のサブ要求で行われたコミットはロールバックされません。
Batch リソースでは、次のリソースおよびリソースグループの一括処理がサポートされます。
- Versions
- /
- Resources by Version
- vXX.X
- Limits
- vXX.X/limits
- SObject リソース
- vXX.X/sobjects/
- Query
- vXX.X/query/?q=soql
- QueryAll
- vXX.X/queryAll/?q=soql
- Search
- vXX.X/search/?q=sosl
- Connect リソース
- vXX.X/connect/
- Chatter リソース
- vXX.X/chatter/
バッチ要求が 10 分以内に完了しない場合、バッチはタイムアウトし、残りのサブ要求は実行されません。
- URI
- /vXX.X/composite/batch
- 形式
- JSON、XML
- HTTP メソッド
- POST
- 認証
- Authorization: Bearer token
- パラメータ
- 不要
- リクエストボディ
- Batch リクエストボディ
- レスポンスボディ
- Batch レスポンスボディ
- 例
- Batch リソースの使用例は、「1 回の要求でレコードを更新してその項目値を取得する」を参照してください。