- 参考文献
バッチファイルのアップロード状況を取得
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
::::タブ:::tab{title="inspect"}
Inspect endpoint
GET /v2/batches/inspect/
元の終点
GET /v2/batches/
アップロード を開始したバッチファイルの現在のアップロード状況を取得します。検査エンドポイントと元のものの唯一の違いは、検査エンドポイントが追加のステータスであるstatus.code.file_uploadedをサポートしています。
次のファイルをアップロードする前に、ファイルのアップロード状況が成功したか確認することをお勧めします。これにより、フォーマットの問題やその他のエラーで失敗したと気づかずに再度アップロードする必要がなくなります。
属性
種類
概要
例
batchRef
ストリング
バッチアップロードのUUID。
バッチ アップロード場所を割り当てたときに生成したのと同じUUIDを使いましょう。
12af3453-62da-4b31-b646-631b7b5f3009
応答において、ステータスがerrorの場合、statusオブジェクトにはlogキーが含まれています。 logキーにはエラーログのURIが含まれています。エラーログのURIを使って、エラーログを取得してアップロードプロセスのトラブルシューティングを行います。
!注ステータスが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化されたファイルを受信し、そのファイルは処理キューに入っています。この状態は インスペクト エンドポイントでのみ確認可能です。
- processing - Sitecore CDPがgzip化されたファイルを処理しています。
- success - Sitecore CDPはgzipファイル内のすべてのJSONレコードを正常に処理しました。これで CDPがアップロードされたデータを取り込んだことを確認できます。
- corrupted - MD5のチェックサムやgzipファイルのサイズが開発者が提供する 値 と一致しない。
- 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 '
元の終点
curl -X GET '
状況: uploading:
{
"href": "
ステータス: file_uploaded - インスペクトエンドポイントでのみ利用可能:
{
"href": "
状況: error:
{
"href":"