Bulk API 2.0
jジョブ情報の取得
ジョブに関する詳細情報を取得します。
- URI
- /services/data/vXX.X/jobs/ingest/jobID
- 可用性
- このリソースは API バージョン 41.0 以降で使用できます。
- 形式
- JSON
- HTTP メソッド
- GET
- 認証
- Authorization: Bearer token
- パラメータ
- なし。
- リクエストボディ
- 不要。
- レスポンスボディ
-
プロパティ 型 説明 apexProcessingTime Long ジョブデータに関連するトリガおよび他のプロセスの処理時間 (ミリ秒)。非同期およびバッチの Apex 操作の処理時間は含まれません。トリガがない場合、この値は 0 になります。 apiActiveProcessingTime Long 有効なジョブの処理時間 (ミリ秒)。apexProcessingTime の時間を含みますが、ジョブがキューで処理を待機している時間や、逐次化および並列化に要する時間は含まれません。 apiVersion string ジョブが作成された API バージョン。 columnDelimiter ColumnDelimiterEnum CSV ジョブデータに使用される列区切り文字。次のような値があります。 - BACKQUOTE — バッククォート文字 (`)
- CARET — キャレット文字 (^)
- COMMA — カンマ文字 (,) (デフォルトの区切り文字)
- PIPE — パイプ文字 (|)
- SEMICOLON — セミコロン文字 (;)
- TAB — タブ文字
concurrencyMode ConcurrencyModeEnum 将来使用されます。要求がどのように処理されたか。現在、サポートされているのは並列モードのみです。(他のモードが追加される場合、API によって自動的に追加されるモードが決定されます。ユーザが設定することはできません。) contentType ContentType 処理されるデータの形式。サポートされるのは CSV のみです。 contentUrl URL このジョブのジョブデータのアップロード要求で使用する URL。ジョブの状況が Open の場合にのみ有効です。 createdById string ジョブを作成したユーザの ID。 createdDate dateTime ジョブが作成された日時を UTC のタイムゾーンで示します。 externalIdFieldName string 更新/挿入の外部 ID 項目の名前。 id string このジョブの一意の ID。 jobType JobTypeEnum ジョブの種別。次のような値があります。 - BigObjectIngest: BigObjects ジョブ
- Classic: Bulk API 1.0 ジョブ
- V2Ingest: Bulk API 2.0 ジョブ
lineEnding LineEndingEnum CSV ジョブデータに使用される行末。次のような値があります。 - LF — 改行文字
- CRLF — 行頭復帰および改行文字
numberRecordsFailed int このジョブで正常に処理されなかったレコードの数。 numberRecordsProcessed int すでに処理済みのレコード数。 object string 処理中のデータのオブジェクト種別。 operation ジョブの処理操作。次のような値があります。 - insert
- delete
- update
- upsert
retries int Salesforce が処理結果の保存を試行した回数。再試行の繰り返しはロックの競合などの問題によって発生します。 state JobStateEnum ジョブの現在の処理状況。次のような値があります。 - Open: ジョブが作成され、このジョブにジョブデータをアップロードできます。
- UploadComplete: ジョブのすべてのデータがアップロードされ、ジョブはキューに追加して処理できる状態です。このジョブには新しいデータを追加できません。終了したジョブの編集や保存はできません。
- Aborted: ジョブが中止されました。ジョブを中止するには、自分がそのジョブの作成者であるか、「データインテグレーションの管理」権限が有効になっている必要があります。
- JobComplete: ジョブが Salesforce によって処理されました。
- Failed: ジョブの一部のレコードが失敗しました。正常に処理されたジョブデータはロールバックされません。
systemModstamp dateTime ジョブが完了した日時を UTC のタイムゾーンで示します。 totalProcessingTime Long ジョブの処理時間 (ミリ秒)。