- 参考文献
バッチアップロード場所を割り当てる
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
PUT /v2/batches/
バッチ ファイルをアップロードするための場所を作成します。
属性
種類
概要
例
batchRef
ストリング
バッチアップロードのUUID。
これはあなたが生成するUUIDです。すべてのバッチで一意でなければなりません。 オンラインツールを使って UUIDを生成できます。
12af3453-62da-4b31-b646-631b7b5f3009
リクエスト文には以下の必要な属性を記載する必要があります:
属性
種類
概要
例
checksum
ストリング
gzip化されたファイルの16進エンコード MD5チェックサム です。これは、gzip化されたファイルの整合性が保たれていることを保証するためのものです。
"b1d600dbf7463924e24647e626cd7c1e"
size
整数
gzip化されたファイルのバイト単位でのサイズ(import.json.gz)。ファイルのプロパティで確認できます。
227
レスポンス内のlocationオブジェクトのhrefキーにはバッチアップロードパスが含まれています。バッチ ファイルをアップロードする際にはバッチアップロードパスを使用します。
応答体には以下のフィールドが含まれます:
属性
概要
種類
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 パラメータの数値です。
ストリング
createdAt
リクエストが作成された日付と時間。
デートの時間
modifiedAt
リクエストが最後に更新された日時。
デートの時間
curl -X PUT '
location.hrefバッチアップロードパスを含みます:
{
"href": "