IDによるFunctionジョブの送信

説明

このAPIを使用すると、Job Functionエンドポイントをトリガーするジョブをジョブプールに送信できます。

リクエスト詳細

リクエストURL

POST

{api-domain}/baas/v1/project/{project_id}/job_scheduling/job

copy

project_id

Numerical

プロジェクトの一意のID

リクエストヘッダー

Authorization: Zoho-oauthtoken {oauth_token}
Content-Type: application/json

オプションヘッダー

CATALYST-ORG: {org_id}

Environment: Development

スコープ

ZohoCatalyst.job.CREATE

リクエストJSON

以下に示す対応する値を含むJSONを送信する必要があります。

サンプルペイロード
copy
{
"source_type": "API",
"job_config": {
    "number_of_retries": "2",
    "retry_interval": 10800
},
"job_name": "functionJob",
"jobpool_id": "10108000003823563",
"target_type": "Function",
"target_id": "10108000003823893",
"params": {
    "param1": "value1"
}
}

View more

このリクエストJSONをリクエストボディに設定し、以下の値を指定する必要があります：

request_method

mandatory

webhookがトリガーされるリクエストメソッドを示します。値はget、post、put、delete、head、またはpatchを指定できます。

source_type

mandatory

ジョブ送信APIの場合、常にAPIを値として含みます。

job_config JSON

mandatory

number_of_retriesとretry_intervalのキーバリューペアが含まれます。失敗時のリトライアクションを決定します。

target_type String

mandatory

ジョブがトリガーするターゲットタイプを示します。

jobpool_id Numerical

mandatory

ジョブを実行するジョブプールのJob Pool IDが含まれます。

job_name String

mandatory

トリガーするジョブの名前が含まれます。

target_id Number

mandatory

ジョブがトリガーするJob Functionの一意のIDが含まれます。

params JSON

optional

ジョブ送信時に渡すパラメータの値が含まれます。

レスポンス詳細

JSONレスポンスは、送信されたジョブのメタデータを返します。レスポンスには、ジョブを送信したユーザーの詳細も含まれます。

リクエスト例
copy

curl -X POST \ ‘https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/job_scheduling/job
-H “Authorization: Zoho-oauthtoken 1000.91016.2f57”
-H “Content-Type:application/json”
--data-raw ‘{“source_type”:“API”,“job_config”:{“number_of_retries”:“2”,“retry_interval”:10800},“job_name”:“functionJob”,“jobpool_id”:“10108000003823563”,“target_type”:“Function”,“target_id”:“10108000003823893”,“params”:{“param1”:“value1”}}’

レスポンス例
copy
{
"status": "success",
"data": {
    "job_id": "10108000004194195",
    "created_time": "Jun 05, 2024 04:51 PM",
    "response_code": null,
    "start_time": {},
    "end_time": {},
    "submitted_on": {
    "startTimeToRedirectLogsPage": "05/06/2024 16:46",
    "timeWithGivenTimezone": "Jun 05, 2024 04:51 PM IST",
    "timeWithJobTimezone": "Jun 05, 2024 04:51 PM IST"
    },
    "job_status": "PENDING",
    "capacity": {
    "memory": "512"
    },
    "job_meta_details": {
    "id": "10108000004194196",
    "url": "",
    "job_name": "functionJob",
    "job_config": {
        "number_of_retries": 2,
        "retry_interval": 10800
    },
    "target_type": "Function",
    "target_details": {
        "id": "10108000003823893",
        "target_name": "target_function_fetch"
    },
    "source_type": "API",
    "source_details": {
        "source_name": "API"
    },
    "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",
        "project_details": {
        "project_name": "ZylkerShipments",
        "id": "10108000003823392",
        "project_type": "Live"
        },
        "id": "10108000003823563"
    },
    "headers": {},
    "params": {
        "param1": "value1"
    }
    },
    "retried_count": null,
    "parent_job_id": "10108000004194195",
    "execution_time": null
}
}

View more

Create Job- Java SDK

Create Job- Node.js SDK

Create Job- Python SDK

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit