--- title: "バッチアップロードの詳細を取得する" slug: "retrieve-details-of-batch-uploads" abstract: "過去30日間にSitecore CDPのインスタンスにアップロードされたバッチの詳細を取得する方法を説明しています。" --- # バッチアップロードの詳細を取得する GET /v2/batches/inspect 過去30日間にSitecore CDPのインスタンスにアップロードされたバッチの詳細を取得します。アップロードを取得可能にするには、まず [バッチアップロード場所を割り当てるPUTリクエストを行う](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file.html#UUID-8ed431f9-8f85-ad6c-b8d9-b2927930b33a_para-idm1903351910136568)必要があります。 サイドバー。クエリパラメータ 名称 種類 概要 例 status ストリング バッチアップロードの処理状況。可能な値: - uploading - バッチ参照が保存され、gzip化されたファイルをアップロード可能にします。バッチはファイルが完全にアップロードされるまでこの状態のままです。ファイルを受信した後、Sitecore CDPはそれを検証し、状態を file\_uploadedに変更します。 - file\_uploaded - Sitecore CDPがgzip化されたファイルを受信し、そのファイルは処理キューに入っています。この状態は [インスペクト](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/retrieve-batch-file-upload-status.html) エンドポイントでのみ確認可能です。 - processing - Sitecore CDPがgzip化されたファイルを処理しています。 - success - Sitecore CDPはgzipファイル内のすべてのJSONレコードを正常に処理しました。これで [CDPがアップロードされたデータを取り込んだことを確認](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file.html#UUID-8ed431f9-8f85-ad6c-b8d9-b2927930b33a_section-idm1903352048250758)できます。 - corrupted - MD5のチェックサムやgzipファイルのサイズが開発者が提供する [値](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file.html#UUID-8ed431f9-8f85-ad6c-b8d9-b2927930b33a_section-idm1903351892563384) と一致しない。 - error - Sitecore CDP gzip化されたファイル内の少なくとも1つのJSONレコードを処理しませんでした。問題のトラブルシューティングのためにエラーログをダウンロードできます。ログファイルの位置は status.log パラメータの数値です。 未設定の場合、リクエスト内でステータスフィルターは使用されません。 - status=uploading - status=success,error createdBefore ストリング 好きな日時を選んでください。 この日時以前に作成されたバッチアップロードのみが返送されます。 フォーマット: YYYY-MM-DDTHH:mm:ss.SSSZ createdBefore=2026-05-29T07:41:51.244Z createdAfter ストリング 好きな日時を選んでください。 この日時以降に作成されたバッチアップロードのみが返送されます。 フォーマット: YYYY-MM-DDTHH:mm:ss.SSSZ createdAfter=2026-05-29T07:41:51.244Z 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:51.244Z modifiedAt ストリング バッチアップロードが最後に修正された日付と時刻。例えば、ステータスが最後に変わった日時などです。 2026-05-29T07:41:51.244Z クエリパラメータなしのリクエスト: 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:51\`.244Z", "modifiedAt": "2026-05-29T07:\`47:59\`.961Z" }, {<...>} }