Actualizar un Cron Mensual (Tipo Fecha)

Descripción

Esta API te permite actualizar un cron Monthly (configurado usando las fechas del calendario) presente en el proyecto. El cron que necesita ser actualizado será referenciado usando su identificador único, como nombre o ID.

Nota:

En esta API, estamos ilustrando la solicitud de ejemplo y la respuesta de ejemplo con una Job Function. La funcionalidad de la API es la misma para webhook, Circuits y AppSail jobs.
La funcionalidad de la API es la misma cuando intentas actualizar un cron Monthly definido usando las semanas de un mes. Consulta Create a Monthly Cron (Week Type) API.
Esta API es aplicable para Pre-Defined Crons y Dynamic Crons.

Detalles de la Solicitud

URL de Solicitud

PUT

{api-domain/}baas/v1/project/{project_id}/job_scheduling/cron/{cron_identifier (name/ID)}

copy

project_id

Numerical

El ID único del proyecto

cron_id

Numerical

El ID único del cron

cron_name

String

El nombre del cron

Encabezados de Solicitud

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

Encabezados Opcionales

CATALYST-ORG: {org_id}

Environment: Development

Alcance

ZohoCatalyst.cron.UPDATE

JSON de Solicitud

Debes enviar un JSON con sus valores correspondientes como se muestra a continuación.

Sample Payload
copy
{
"cron_name": "recurCronMonthly",
"description": "monthly",
"cron_type": "Calendar",
"cron_status": true,
"end_time": 1718002799,
"cron_execution_type": "pre-defined",
"job_meta": {
    "id": "10108000004280537",
    "job_name": "jobName",
    "job_config": {
    "number_of_retries": 2,
    "retry_interval": 500
    },
    "target_type": "Function",
    "target_details": {
    "id": "10108000003823893",
    "target_name": "target_function_fetch"
    },
    "source_type": "Cron",
    "source_details": {
    "id": "10108000004280535",
    "source_name": "recurCronMonthly",
    "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"
    },
    "params": {
    "param1": "value1"
    },
    "target_id": "10108000003823893"
},
"job_detail": {
    "hour": 3,
    "minute": 0,
    "second": 0,
    "repetition_type": "monthly",
    "days": [
    1,
    3,
    8,
    "9"
    ],
    "timezone": "PST"
},
"id": "10108000004280535"
}

View more

Alimentarás este JSON de solicitud en tu Request Body, y necesitas proporcionar el valor de:

cron_type String

mandatory

Indicará el tipo de programación del cron

cron_status Boolean

mandatory

Indicará si el cron está habilitado o deshabilitado.

job_detail JSON

mandatory

Contendrá los detalles del job que está siendo enviado por el cron.

job_meta JSON

mandatory

Contendrá la meta información sobre el job que está siendo enviado por el cron.

jobpool_id Numerical

mandatory

Contendrá el Job Pool ID del job pool que ejecutará el job.

job_name String

mandatory

Contendrá el nombre del job que necesitas activar.

target_type String

mandatory

Indicará qué endpoint del tipo de destino se va a activar. Puede ser Function, Webhook, Circuit o AppSail.

target_id Numerical

mandatory

Contendrá el ID único con el que se referenciará el tipo de destino.

params JSON

mandatory

Contendrá el valor de los headers y params que pasas al enviar el job.

cron_name String

mandatory

Contendrá el nombre del cron que vas a crear.

cron_execution_type String

mandatory

Indicará si es un cron pre-defined o dynamic.

Detalles de la Respuesta

La respuesta JSON devuelve los metadatos del cron actualizado. La respuesta también contendrá los detalles del usuario que actualizó el cron.

Sample Request
copy

curl -X PUT \ https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/job_scheduling/cron/10108000004280535
-H “Authorization: Zoho-oauthtoken 1000.91016.2f57”
-H “Content-Type:application/json”
--data-raw ‘{“cron_name”:“recurCronMonthly”,“description”:“monthly”,“cron_type”:“Calendar”,“cron_status”:true,“end_time”:1718002799,“cron_execution_type”:“pre-defined”,“job_meta”:{“id”:“10108000004280537”,“job_name”:“jobName”,“job_config”:{“number_of_retries”:2,“retry_interval”:500},“target_type”:“Function”,“target_details”:{“id”:“10108000003823893”,“target_name”:“target_function_fetch”},“source_type”:“Cron”,“source_details”:{“id”:“10108000004280535”,“source_name”:“recurCronMonthly”,“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”},“params”:{“param1”:“value1”},“target_id”:“10108000003823893”},“job_detail”:{“hour”:3,“minute”:0,“second”:0,“repetition_type”:“monthly”,“days”:[1,3,8,“9”],“timezone”:“PST”},“id”:“10108000004280535”}’

Sample Response
copy
{
"status": "success",
"data": {
    "cron_name": "recurCronMonthly",
    "description": "monthly",
    "cron_type": "Calendar",
    "cron_execution_type": "pre-defined",
    "job_meta": {
    "id": "10108000004280805",
    "url": "",
    "job_name": "jobName",
    "job_config": {
        "number_of_retries": 2,
        "retry_interval": 500
    },
    "target_type": "Function",
    "target_details": {
        "id": "10108000003823893",
        "target_name": "target_function_fetch"
    },
    "source_type": "Cron",
    "source_details": {
        "id": "10108000004280535",
        "source_name": "recurCronMonthly",
        "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,
    "modified_time": "Jun 07, 2024 01:00 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": "1718002799",
    "cron_detail": {
    "jobId": "10108000004280535",
    "transactionTimeout": -1,
    "hour": 3,
    "minute": 0,
    "second": 0,
    "repetition_type": "monthly",
    "days": [
        1,
        3,
        8,
        9
    ],
    "timezone": "PST"
    },
    "id": "10108000004280535"
}
}

View more

Update Cron- Java SDK

Update Cron- Node.js SDK

Update Cron- Python SDK

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit