---
title: "一括書き込みステータスの確認"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/data-store/bulk-write-rows/check-bulk-write-status/
description: "このAPIを使用すると、以前に開始した一括書き込みジョブのステータスを手動で確認できます。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: api
---

# 一括書き込みステータスの確認

### 説明

このAPIを実行すると、以前に開始した[一括書き込みジョブ](https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/data-store/bulk-write-rows/create-bulk-write-job/#CreateBulkWriteJob)のステータスを手動で確認できます。

JSONリクエストでコールバックURLを設定していなかった場合は、このAPIを実行してジョブステータスを自分で確認する必要があります。一括書き込み操作を開始した際に自動的に送信される処理中レスポンスに含まれる`job_id`を使用して、その後のジョブステータスを確認する必要があります。

### リクエスト詳細

#### リクエストURL

`GET` {api-domain}/baas/v1/project/{project_id}/bulk/write/{job_id}

- **api-domain** (URL): Catalyst APIにアクセスするためのDC固有のドメイン

- **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

- **job_id** (Numerical): <p>Bulk Write APIの実行後に最初の[処理中ステータスレスポンス](https://docs.catalyst.zoho.com/ja/api/introduction/overview-and-prerequisites/#response-details)で送信されたジョブの一意のID</p>

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**オプションヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.tables.bulk.CREATE

### レスポンス詳細

成功状態のJSONレスポンスには、実行されたジョブの詳細とダウンロードURLが含まれます。このURLから、ジョブ実行の詳細を含む[CSVレポートファイルをダウンロード](https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/data-store/bulk-write-rows/download-bulk-write-result/#DownloadBulkWriteResult)できます。書き込みがスキップされたすべてのレコードとその理由が一覧表示されます。

失敗状態のJSONレスポンスには、実行されたジョブの詳細と、ジョブ処理中に発生したエラーの説明およびその詳細が含まれます。

**リクエスト例**

```bash
curl -X GET \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/bulk/write/2000000110044  \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**レスポンス例：ジョブ処理中**

```json

    {
        "status": "success",
        "data": {
            "job_id": 2000000110044,
            "status": "In-Progress",
            "operation": "insert",
            "project_details": {
                "project_name": "EmployeeDatabase",
                "id": 4000000006007
            }
            "query": [
                {
                    "table_id": 3376000000165511,
                    "details": {
                        "object_url" : "https://zylker-emp-development.zohostratus.com/employees/emp_rec.csv",
                        
                    }
                }
            ],
            "callback": {
                "url": "https://hr.zylker.com/ja/EmpRecords/_callback.php",
                "headers": {
                    "src": "ZCatalyst",
                    "operation": "bulkwriteAPI"
                },
                "params": {
                    "project_name": "EmployeeDatabase"
                }
            },
            "created_by": {
                    "zuid": 3000000006111,
                    "is_confirmed": true,
                    "email_id": "emma@zylker.com",
                    "first_name": "Amelia",
                    "last_name": "Burrows",
                    "user_id": 671930409
            },
            "created_time": "Oct 05, 2020 07:33 PM"
        }
    }
```

**レスポンス例：ジョブ成功**

```json

    {
        "status": "success",
        "data": {
            "job_id": 2000000110044,
            "status": "Completed",
            "operation": "insert",
            "project_details": {
                "project_name": "EmployeeDatabase",
                "id": 4000000006007
            }
            "query": [
                {
                    "table_id": 3376000000165511,
                    "details": {
                        "object_url" : "https://zylker-emp-development.zohostratus.com/employees/emp_rec.csv"
                    }
                }
            ],
            "callback": {
                "url": "https://hr.zylker.com/ja/EmpRecords/_callback.php",
                "headers": {
                    "src": "ZCatalyst",
                    "operation": "bulkwriteAPI"
                },
                "params": {
                    "project_name": "EmployeeDatabase"
                }
            },
            "created_by": {
                "zuid": 3000000006111,
                "is_confirmed": true,
                "email_id": "emma@zylker.com",
                "first_name": "Amelia",
                "last_name": "Burrows",
                "user_id": 671930409
            },
            "created_time": "Oct 05, 2020 07:25 PM",
            "results": {
                "download_url": "https://api.catalyst.zoho.com/baas/v1/bulk/write/2000000110013/download",
                "description": "Bulk WRITE job completed. ",
                "details": [
                    {
                        "table_id": 3376000000165511,
                        "records_processed": 176
                    }
                ]
            }
        }
    }
```

**レスポンス例：ジョブ失敗**

```json

    {
        "status": "success",
        "data": {
            "job_id": 2000000110044,
            "status": "Failed",
            "operation": "insert",
            "project_details": {
                "project_name": "EmployeeDatabase",
                "id": 4000000006007
            }
            "query": [
                {
                    "table_id": 3376000000165511,
                    "details": {
                        "object_url" : "https://zylker-emp-development.zohostratus.com/employees/emp_rec.csv"
                    }
                }
            ],
            "callback": {
                "url": "https://hr.zylker.com/ja/EmpRecords/_callback.php",
                "headers": {
                    "src": "ZCatalyst",
                    "operation": "bulkwriteAPI"
                },
                "params": {
                    "project_name": "EmployeeDatabase"
                }
            },
            "created_by": {
                "zuid": 3000000006111,
                "is_confirmed": true,
                "email_id": "emma@zylker.com",
                "first_name": "Amelia",
                "last_name": "Burrows",
                "user_id": 671930409
            },
            "created_time": "Oct 05, 2020 07:25 PM",
            "results": {
                "description": "The reference_column 'DeptID' in fk_mapping of table 3376000000165511 is not a unique column",
                "details": [ ]
            }
        }
    }
```