--- title: "Cron式を使用したCronの作成" url: https://docs.catalyst.zoho.com/ja/api/code-reference/job-scheduling/cron/create-cron/create-cron-cron-exp/ description: "このAPIを使用すると、Job Functionエンドポイントをトリガーするために、ジョブプールにジョブを送信するcron式を使用したcronを作成できます。" last_updated: 2026-02-23T12:39:41Z service: Job Scheduling type: api --- # Cron式を使用したCronの作成 ### 説明 このAPIを使用すると、スケジュールされた時間に[ジョブ](https://docs.catalyst.zoho.com/ja/job-scheduling/help/job/introduction/)を[ジョブプール](https://docs.catalyst.zoho.com/ja/job-scheduling/help/jobpool/introduction/)に送信し、[Job Function](https://docs.catalyst.zoho.com/ja/serverless/help/functions/job-functions/)エンドポイントをトリガーする[**Cron式**](https://docs.catalyst.zoho.com/ja/job-scheduling/help/cron/key-concepts/#cron-expressions)を使用して定義された繰り返しタイプのcronを作成できます。 > **注意:** * このAPIでは、[Job Function](https://docs.catalyst.zoho.com/ja/serverless/help/functions/job-functions/)を使用したリクエスト例とレスポンス例を示しています。APIの機能はwebhook、[Circuits](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/introduction/)、および[AppSail](https://docs.catalyst.zoho.com/ja/serverless/help/appsail/introduction/)ジョブでも同じです。 * このAPIは[事前定義Cron](https://docs.catalyst.zoho.com/ja/job-scheduling/help/implementation/submit-job-predefined-cron/)および[動的Cron](https://docs.catalyst.zoho.com/ja/job-scheduling/help/implementation/submit-job-dynamic-cron/)に適用されます。 ### リクエスト詳細 #### リクエストURL `POST` {api-domain/}baas/v1/project/{project_id}/job_scheduling/cron - **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/) #### リクエストヘッダー **Authorization:** Zoho-oauthtoken {oauth_token} **Content-Type:** application/json **オプションヘッダー** **CATALYST-ORG:** {org_id} **Environment:** Development #### スコープ ZohoCatalyst.cron.CREATE #### リクエストJSON 以下に示す対応する値を含むJSONを送信する必要があります。 **サンプルペイロード** ```json { "cron_type": "CronExpression", "cron_status": true, "cron_expression": "* * * * *", "job_detail": { "timezone": "PST" }, "job_meta": { "source_type": "Cron", "job_config": { "number_of_retries": "1", "retry_interval": "500" }, "job_name": "jobName", "jobpool_id": "10108000003823563", "target_type": "Function", "target_id": "10108000003823893", "params": { "param1": "value1" } }, "cron_name": "cronExp", "description": "cronexpression", "end_time": 1717916399, "cron_execution_type": "pre-defined" } ``` この**リクエストJSON**を**リクエストボディ**に設定し、以下の値を指定する必要があります： - **cron_type** (String, mandatory): cronのスケジュールタイプを示します - **cron_status** (Boolean, mandatory): cronが有効か無効かを示します。 - **job_detail** (JSON, mandatory): cronによって送信されるジョブの詳細が含まれます。 - **job_meta** (JSON, mandatory): cronによって送信されるジョブのメタ情報が含まれます。 - **jobpool_id** (Numerical, mandatory): ジョブを実行するジョブプールの[Job Pool ID](https://docs.catalyst.zoho.com/ja/job-scheduling/help/jobpool/key-concepts/#job-pool-id)が含まれます。 - **job_name** (String, mandatory): トリガーするジョブの名前が含まれます。 - **target_type** (String, mandatory): トリガーされるターゲットタイプのエンドポイントを示します。`Function`、`Webhook`、`Circuit`、または`AppSail`のいずれかです。 - **target_id** (Numerical, mandatory): ターゲットタイプを参照するための一意のIDが含まれます。 - **params** (JSON, mandatory): ジョブ送信時に渡すヘッダーとパラメータの値が含まれます。 - **cron_name** (String, mandatory): 作成するcronの名前が含まれます。 - **cron_execution_type** (String, mandatory): `pre-defined` cronか`dynamic` cronかを示します。 ### レスポンス詳細 JSONレスポンスは作成されたcronのメタデータを返します。レスポンスにはcronを作成したユーザーの詳細も含まれます。 **リクエスト例** ```bash curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/job_scheduling/cron -H "Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57" -H "Content-Type:application/json" -\-data-raw '{"cron_type":"CronExpression","cron_status":true,"cron_expression":"* * * * *","job_detail":{"timezone":"PST"},"job_meta":{"source_type":"Cron","job_config":{"number_of_retries":"1","retry_interval":"500"},"job_name":"jobName","jobpool_id":"10108000003823563","target_type":"Function","target_id":"10108000003823893","params":{"param1":"value1"}},"cron_name":"cronExp","description":"cronexpression","end_time":1717916399,"cron_execution_type":"pre-defined"}' ``` **レスポンス例** ```json { "status": "success", "data": { "cron_name": "cronExp", "description": "cronexpression", "cron_type": "CronExpression", "cron_execution_type": "pre-defined", "cron_expression": "* * * * *", "job_meta": { "id": "10108000004280709", "url": "", "job_name": "jobName", "job_config": { "number_of_retries": 1, "retry_interval": 500 }, "target_type": "Function", "target_details": { "id": "10108000003823893", "target_name": "target_function_fetch" }, "source_type": "Cron", "source_details": { "id": "10108000004280707", "source_name": "cronExp", "details": { "cron_execution_type": "pre-defined" } }, "jobpool_id": "10108000003823563", "jobpool_details": { "type": "Function", "name": "VendorReminder", "created_by": { "zuid": "77941453", "is_confirmed": false, "email_id": "emmy@zylker.com", "first_name": "Amelia Burrows", "last_name": "", "user_type": "Admin", "user_id": "10108000000009004" }, "created_time": "May 28, 2024 04:44 PM", "modified_by": { "zuid": "77941453", "is_confirmed": false, "email_id": "emmy@zylker.com", "first_name": "Amelia Burrows", "last_name": "", "user_type": "Admin", "user_id": "10108000000009004" }, "modified_time": "May 28, 2024 04:44 PM", "capacity": { "memory": "2048" }, "project_details": { "project_name": "ZylkerShipments", "id": "10108000003823392", "project_type": "Live" }, "id": "10108000003823563" }, "headers": {}, "params": { "param1": "value1" } }, "cron_status": true, "created_time": "Jun 07, 2024 12:51 PM", "created_by": { "zuid": "77941453", "is_confirmed": false, "email_id": "emmy@zylker.com", "first_name": "Amelia Burrows", "last_name": "", "user_type": "Admin", "user_id": "10108000000009004" }, "modified_time": "Jun 07, 2024 12:51 PM", "modified_by": { "zuid": "77941453", "is_confirmed": false, "email_id": "emmy@zylker.com", "first_name": "Amelia Burrows", "last_name": "", "user_type": "Admin", "user_id": "10108000000009004" }, "project_details": { "project_name": "ZylkerShipments", "id": "10108000003823392", "project_type": "Live" }, "end_time": "1717916399", "cron_detail": { "jobId": "10108000004280707", "transactionTimeout": -1, "hour": 0, "minute": 0, "second": 0, "timezone": "PST" }, "id": "10108000004280707" } } ``` ### SDK Documentation [Create a Cron Using Cron Expressions- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/job-scheduling/cron/create-cron-cron-expressions/) [Create a Cron Using Cron Expressions- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/job-scheduling/cron/create-cron-cron-expressions/) [Create a Cron Using Cron Expressions- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/job-scheduling/cron/create-cron-cron-expressions/)