バッチアップロードの詳細を取得する

GET /v2/batches/inspect

過去30日間にSitecore CDPのインスタンスにアップロードされたバッチの詳細を取得します。アップロードを取得可能にするには、まず バッチアップロード場所を割り当てるPUTリクエストを行う必要があります。

サイドバー。クエリパラメータ

名称

種類

概要

例

status

ストリング

バッチアップロードの処理状況。可能な値:

• uploading - バッチ参照が保存され、gzip化されたファイルをアップロード可能にします。バッチはファイルが完全にアップロードされるまでこの状態のままです。ファイルを受信した後、Sitecore CDPはそれを検証し、状態を file_uploadedに変更します。

• file_uploaded - Sitecore CDPがgzip化されたファイルを受信し、そのファイルは処理キューに入っています。この状態は インスペクト エンドポイントでのみ確認可能です。

• processing - Sitecore CDPがgzip化されたファイルを処理しています。

• success - Sitecore CDPはgzipファイル内のすべてのJSONレコードを正常に処理しました。これで CDPがアップロードされたデータを取り込んだことを確認できます。

• corrupted - MD5のチェックサムやgzipファイルのサイズが開発者が提供する 値 と一致しない。

• error - Sitecore CDP gzip化されたファイル内の少なくとも1つのJSONレコードを処理しませんでした。問題のトラブルシューティングのためにエラーログをダウンロードできます。ログファイルの位置は status.log パラメータの数値です。

未設定の場合、リクエスト内でステータスフィルターは使用されません。

• status=uploading
• status=success,error

createdBefore

ストリング

好きな日時を選んでください。

この日時以前に作成されたバッチアップロードのみが返送されます。

フォーマット: YYYY-MM-DDTHH:mm

createdBefore=2026-05-29T07:41

createdAfter

ストリング

好きな日時を選んでください。

この日時以降に作成されたバッチアップロードのみが返送されます。

フォーマット: YYYY-MM-DDTHH:mm

createdAfter=2026-05-29T07:41

offset

整数

最初のバッチアップロードの全コレクションにおけるゼロベースの開始インデックスを返します。

デフォルト: 0。

offset=10

limit

整数

1回のリクエストで返すべき最大バッチアップロード数。

最低条件: 1。

最大: 1000。

デフォルト: 50。

limit=100

応答体には以下のフィールドが含まれます:

属性

種類

概要

例

totalCount

整数

過去30日間にあなたのSitecore CDPインスタンスにアップロードされたバッチの数で、リクエストクエリのパラメータで指定された条件に合致しているもの。

337

offset

整数

申請で使われたオフセットです。

0

limit

整数

リクエストで使われた上限です。

50

items

オブジェクトの配列

バッチアップロードのリストが返ってきました。

該当なし

itemsオブジェクトの配列:

属性

種類

概要

例

href

ストリング

バッチアップロードのURLです。

"http://.../v2/batches/inspect/12af3453-62da-4b31-a646-631b7b5f3009"

ref

ストリング

バッチアップロードのUUID。

"12af3453-62da-4b31-a646-631b7b5f3009"

status

ストリング

バッチアップロードの処理状況。

"error"

status.log

ストリング

errorステータスのバッチアップロードの場合、ダウンロード可能なエラーログファイルの場所です。

"https://sitecore-batch-service..."

createdAt

ストリング

バッチアップロードが作成された日時。

2026-05-29T07:41

modifiedAt

ストリング

バッチアップロードが最後に修正された日付と時刻。例えば、ステータスが最後に変わった日時などです。

2026-05-29T07:41

クエリパラメータなしのリクエスト:

curl -X GET '/v2/batches/inspect' \ -u ':' \ -H 'Accept: application/json'

クエリパラメータ付きリクエスト:

curl -X GET '/v2/batches/inspect?status=success,error&limit=100' \ -u ':' \ -H 'Accept: application/json'

{ "totalCount": 225, "offset": 0, "limit": 100, "items": { "href": "/v2/batches/inspect/12af3453-62da-4b31-a646-631b7b5f3009", "ref": "439332a9-f837-496f-9e4a-87491689bb90", "status": "success", "createdAt": "2026-05-29T07:`41

}