--- title: "バッチファイルのアップロード状況を取得" slug: "retrieve-batch-file-upload-status" abstract: "バッチファイルをSitecore CDPにアップロードする際のバッチファイルのアップロード状況を取得する方法を説明しています。" --- # バッチファイルのアップロード状況を取得 ::::タブ:::tab{title="inspect"} ## Inspect endpoint GET /v2/batches/inspect/ ::::::tab{title="original"} ## 元の終点 GET /v2/batches/ ::::::: アップロード [を開始したバッチファイルの](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/upload-batch-file.html "Upload batch file")現在のアップロード状況を取得します。検査エンドポイントと元のものの唯一の違いは、検査エンドポイントが追加のステータスであるstatus.code.file\_uploadedをサポートしています。 次のファイルをアップロードする前に、ファイルのアップロード状況が成功したか確認することをお勧めします。これにより、フォーマットの問題やその他のエラーで失敗したと気づかずに再度アップロードする必要がなくなります。 属性 種類 概要 例 batchRef ストリング バッチアップロードのUUID。 バッチ [アップロード場所を割り当て](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/allocate-batch-upload-location.html)たときに生成したのと同じUUIDを使いましょう。 12af3453-62da-4b31-b646-631b7b5f3009 応答において、ステータスがerrorの場合、statusオブジェクトにはlogキーが含まれています。 logキーにはエラーログのURIが含まれています。エラーログのURIを使って、[エラーログ](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/retrieve-batch-upload-error-log.html "Retrieve batch upload error log")を取得してアップロードプロセスのトラブルシューティングを行います。 > !注ステータスがerrorであってもレスポンスにエラーログURIが含まれていない場合、アップロードされたファイルがサポートされていない圧縮フォーマットを使用している可能性があります。ファイルがgzipp(.gz)でないこと(.zip)でないことを確認してください。 応答体には以下のフィールドを含めることができます: 属性 概要 種類 href このリクエストで使われたURLのエコーバック。 ストリング ref バッチのUUIDはhrefの一部を形成します。 ストリング checksum アップロードファイルのチェックサムをエコーバックしてください。 ストリング size アップロードファイルのサイズをエコーバックしてください。 整数 location ファイルのアップロード場所の詳細。 目的 location.href バッチファイルをアップロードする割り当てられたURLです。このURLは1時間有効です。 ストリング location.expiry アップロード場所のhrefが期限切れになる日時。 デートの時間 status ファイルのアップロード状況。 目的 status.code バッチファイルの処理状況。可能な値: - 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/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/upload-a-batch-file.html#UUID-8ed431f9-8f85-ad6c-b8d9-b2927930b33a_section-idm1903351892563384) と一致しない。 - error - Sitecore CDP gzip化されたファイル内の少なくとも1つのJSONレコードを処理しませんでした。問題のトラブルシューティングのためにエラーログをダウンロードできます。ログファイルの位置は status.log パラメータの数値です。 ストリング status.log バッチアップロードリクエストにエラーが含まれている場合、エラーの詳細を含むログファイルの場所を示します。 ストリング summaryStats ファイルアップロード時の統計概要を含みます。 目的 summaryStats.timeToProcessMillis バッチインポートジョブが実行されるのにかかる時間(ミリ秒単位)です。 整数 summaryStats.totalCount バッチインポートジョブによってインポートファイルから読み取られたレコードの総数。 整数 summaryStats.succeededCount バッチインポートジョブが正常に処理したレコードの数。 整数 summaryStats.failedCount バッチインポートジョブが処理できなかったレコードの数。 整数 createdAt リクエストが作成された日付と時間。 デートの時間 modifiedAt リクエストが最後に更新された日時。 デートの時間 ::::タブ:::tab{title="inspect"} ## Inspect endpoint curl -X GET '/v2/batches/inspect/12af3453-62da-4b31-a646-631b7b5f3009' \\ -u ':' \\ -H 'Accept: application/json' ::::::tab{title="original"} ## 元の終点 curl -X GET '/v2/batches/12af3453-62da-4b31-a646-631b7b5f3009' \\ -u ':' \\ -H 'Accept: application/json' ::::::: 状況: uploading: { "href": "/v2/batches/12af3453-62da-4b31-b646-631b7b5f3009", "ref": "12af3453-62da-4b31-b646-631b7b5f3009", "checksum": "b1d600dbf7463924e24647e626cd7c1e", "size": 227, "location": { "href": "https://sitecore-batch-service-production-eu-west-1.s3.eu-west-1.amazonaws.com/pqsTELpfrXBzxKozB0IoL4xuAT0s7WrH/12af3453-62da-4b31-b646-631b7b5f3009/import.gz?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEDAaCWV1LXdlc3QtMSJIMEYCIQCvLllsVnScVKunabp2ecWZ35wWC2qazGUOH38uZ4ebNwIhAPhKsvrNikvkBSJwFo4Heat72zODcLQCPzh87PRThE8qKtUECIn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQABoMNDkzNDAzOTY5MDY2IgzaKR3yFcEnGvR0NjEqqQQiccx7113xYh5boBVgjPQrzpcCLKgXi563nzp0YRIM52WE1LFEezlLQBEcRl9wo0i5ko5%2F8ne%2BPSFGxkc576fPqkdQzQyX9Ub1PA44pwuFzK%2FZSf9mHS7FRqPvvuxlm7srdkceEJK2VAmoUehfKHzDYhtCkPnZyElYwyeZAK7i6QY8u3WqGVIeGiObjZbhB2Ppq9wwSgfbaz5bUpKPwi6%2F3HRzV60gTURhO%2BOJOrxiuTjF6SKm586HQQizeGKWHlOiJghgO22gaqDlowHDMWuCjkPyk%2Fac1LTXNPFnUlQnbMwnvt7iXSRq6BrpZ7hlxxKZrjLT%2Bb35k4BExmE4XnXS%2BeWiSwNmz74xYtGwBzBjDYJL5KQPJBf%2FmmUqRgCV4xex7f8qtp34F4nLcXC0pRxggkSBBSxm214ubh9j7JZYz5QY8KuGDC9pn%2FeNeqFHaS4B%2FKtkNKzU6YyFmQdiXgFMpK22TpKvDQbeX5%2Bazx2lCqBuIR2MSg8xaVxfVOm14tu0WrqIY8luKV9Vpl23LWs713xhg80XwjkUb1nCOu57Lu0hOODrq1lr21CmJWnU7pttLa6fgT2Sineu%2BwkXeTQuVVBfYOw%2BQgyu6yX7hSkskKFMJPSSvSDgcx%2B0z7ze%2F6wwDfc2j94FtriCv77t7RIN1UQYi4%2FWT%2BH1UtqoHEjwf%2B4WUV4sGnzYnWVVNS9D%2FDuhfIcxMtX%2FeC6GY2xl3DaoInj4Dpn%2F%2B%2B%2BDMJy29J0GOqgBLYwZ%2BS6LeU8LGjYX9awM1lZICDgrQ0hlOV350Z6dYGfgRriIVxT3a1tcWbIoa3i2xkJhWKoJlEjgplRBSMEKhYaLbb9OQjKayNjAfDHGNDGr3%2FeGWuhg7SXAXHa1fs1%2BDqeErCylLFgS3TzFH2D7uTNCiSa6z2QS47PQ5lCYhjWqx9odsrCOmAKTrg23disfNZOaHKnlZaug2Yn7zDgbNneWs%2FKjX5GX&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230110T083848Z&X-Amz-SignedHeaders=content-md5%3Bhost%3Bx-amz-server-side-encryption&X-Amz-Expires=3600&X-Amz-Credential=ASIAXFYJLCYVPNLGNNGA%2F20230110%2Feu-west-1%2Fs3%2Faws4\_request&X-Amz-Signature=00adb6369887346dafc2fdce630f1527ab9482fb2307c921d2850b0d09c0aace", "expiry": "2026-01-10T09:\`38:48\`.910Z" }, "status": { "code": "uploading" }, "createdAt": "2026-01-10T08:\`38:48\`.910Z", "modifiedAt": "2026-01-10T08:\`38:49\`.000Z" } ステータス: file\_uploaded - インスペクトエンドポイントでのみ利用可能: { "href": "/v2/batches/inspect/12af3453-62da-4b31-b646-631b7b5f3009", "ref": "12af3453-62da-4b31-b646-631b7b5f3009", "checksum": "b1d600dbf7463924e24647e626cd7c1e", "size": 227, "location": { "href": "https://sitecore-batch-service-production-eu-west-1.s3.eu-west-1.amazonaws.com/pqsTELpfrXBzxKozB0IoL4xuAT0s7WrH/12af3453-62da-4b31-b646-631b7b5f3009/import.gz?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEDAaCWV1LXdlc3QtMSJIMEYCIQCvLllsVnScVKunabp2ecWZ35wWC2qazGUOH38uZ4ebNwIhAPhKsvrNikvkBSJwFo4Heat72zODcLQCPzh87PRThE8qKtUECIn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQABoMNDkzNDAzOTY5MDY2IgzaKR3yFcEnGvR0NjEqqQQiccx7113xYh5boBVgjPQrzpcCLKgXi563nzp0YRIM52WE1LFEezlLQBEcRl9wo0i5ko5%2F8ne%2BPSFGxkc576fPqkdQzQyX9Ub1PA44pwuFzK%2FZSf9mHS7FRqPvvuxlm7srdkceEJK2VAmoUehfKHzDYhtCkPnZyElYwyeZAK7i6QY8u3WqGVIeGiObjZbhB2Ppq9wwSgfbaz5bUpKPwi6%2F3HRzV60gTURhO%2BOJOrxiuTjF6SKm586HQQizeGKWHlOiJghgO22gaqDlowHDMWuCjkPyk%2Fac1LTXNPFnUlQnbMwnvt7iXSRq6BrpZ7hlxxKZrjLT%2Bb35k4BExmE4XnXS%2BeWiSwNmz74xYtGwBzBjDYJL5KQPJBf%2FmmUqRgCV4xex7f8qtp34F4nLcXC0pRxggkSBBSxm214ubh9j7JZYz5QY8KuGDC9pn%2FeNeqFHaS4B%2FKtkNKzU6YyFmQdiXgFMpK22TpKvDQbeX5%2Bazx2lCqBuIR2MSg8xaVxfVOm14tu0WrqIY8luKV9Vpl23LWs713xhg80XwjkUb1nCOu57Lu0hOODrq1lr21CmJWnU7pttLa6fgT2Sineu%2BwkXeTQuVVBfYOw%2BQgyu6yX7hSkskKFMJPSSvSDgcx%2B0z7ze%2F6wwDfc2j94FtriCv77t7RIN1UQYi4%2FWT%2BH1UtqoHEjwf%2B4WUV4sGnzYnWVVNS9D%2FDuhfIcxMtX%2FeC6GY2xl3DaoInj4Dpn%2F%2B%2B%2BDMJy29J0GOqgBLYwZ%2BS6LeU8LGjYX9awM1lZICDgrQ0hlOV350Z6dYGfgRriIVxT3a1tcWbIoa3i2xkJhWKoJlEjgplRBSMEKhYaLbb9OQjKayNjAfDHGNDGr3%2FeGWuhg7SXAXHa1fs1%2BDqeErCylLFgS3TzFH2D7uTNCiSa6z2QS47PQ5lCYhjWqx9odsrCOmAKTrg23disfNZOaHKnlZaug2Yn7zDgbNneWs%2FKjX5GX&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230110T083848Z&X-Amz-SignedHeaders=content-md5%3Bhost%3Bx-amz-server-side-encryption&X-Amz-Expires=3600&X-Amz-Credential=ASIAXFYJLCYVPNLGNNGA%2F20230110%2Feu-west-1%2Fs3%2Faws4\_request&X-Amz-Signature=00adb6369887346dafc2fdce630f1527ab9482fb2307c921d2850b0d09c0aace", "expiry": "2026-01-10T09:\`38:48\`.910Z" }, "status": { "code": "file\_uploaded" }, "createdAt": "2026-01-10T08:\`38:48\`.910Z", "modifiedAt": "2026-01-10T08:\`38:49\`.000Z" } 状況: error: { "href":"/v2/batches/3ee694e5-0b77-2d1e-af19-1aa78f500785", "ref":"3ee694e5-0b77-2d1e-af19-1aa78f500785", "checksum":"40d9a12f0a3c93c8ed66a3b6f3735790", "size":3456, "location":{ "href":"https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/xyzsla2xze5vxn02kf283wo020jg/3ee694e5-0b77-2d1e-af19-1aa78f500785/import.gz?AWSAccessKeyId=AKIAI2JLVI7OT2L6QDRQ&Expires=1459953714&Signature=yIG7nFv5w%2B2N%2Fkz11Eh7BjqSt2U%3D", "expiry":"2026-04-24T09:\`33:00\`.770Z" }, "status":{ "code":"error", "log":"https://sitecore-batch-service-dev-eu-west-1.s3.amazonaws.com/xyzsla2xze5vxn02kf283wo020jg/3ee694e5-0b77-2d1e-af19-1aa78f500785/import.gz?AWSAccessKeyId=AKIAI2JLVI7OT2L6QDRQ&Expires=1459953714&Signature=yIG7nFv5w%2B2N%2Fkz11Eh7BjqSt2U%3D" }, "summaryStats":{ "timeToProcessMillis":614867, "totalCount":121776, "succeededCount":121460, "failedCount":316 }, "createdAt":"2026-04-24T08:\`33:00\`.770Z", "modifiedAt":"2026-04-24T08:\`46:04\`.000Z" }