--- title: "バッチアップロード場所を割り当てる" slug: "allocate-batch-upload-location" abstract: "バッチファイルをSitecore CDPにアップロードする際のバッチアップロード場所の割り当て方法を説明しています。" --- # バッチアップロード場所を割り当てる PUT /v2/batches/ バッチ [ファイルをアップロード](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/upload-batch-file.html "Upload batch file")するための場所を作成します。 属性 種類 概要 例 batchRef ストリング バッチアップロードのUUID。 これはあなたが生成するUUIDです。すべてのバッチで一意でなければなりません。 [オンラインツールを使って](https://guidgenerator.com/online-guid-generator.aspx) UUIDを生成できます。 12af3453-62da-4b31-b646-631b7b5f3009 リクエスト文には以下の必要な属性を記載する必要があります: 属性 種類 概要 例 checksum ストリング gzip化されたファイルの16進エンコード [MD5チェックサム](https://emn178.github.io/online-tools/md5_checksum.html) です。これは、gzip化されたファイルの整合性が保たれていることを保証するためのものです。 "b1d600dbf7463924e24647e626cd7c1e" size 整数 gzip化されたファイルのバイト単位でのサイズ(import.json.gz)。ファイルのプロパティで確認できます。 227 レスポンス内のlocationオブジェクトのhrefキーにはバッチアップロードパスが含まれています。バッチ [ファイルをアップロード](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/upload-batch-file.html "Upload batch file")する際にはバッチアップロードパスを使用します。 応答体には以下のフィールドが含まれます: 属性 概要 種類 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 パラメータの数値です。 ストリング createdAt リクエストが作成された日付と時間。 デートの時間 modifiedAt リクエストが最後に更新された日時。 デートの時間 curl -X PUT '/v2/batches/12af3453-62da-4b31-a646-631b7b5f3009' \\ -u ':' \\ -H 'Accept: application/json' \\ --data-raw ' { "checksum": "b1d600dbf7463924e24647e626cd7c1e", "size": 227 }' location.hrefバッチアップロードパスを含みます: { "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:48\`.910Z" }