DocumentaciónExperience PlatformGuía del servicio de segmentación

Extremo de programaciones

Última actualización: 23 de septiembre de 2026

Creado para:

  • Desarrollador

Los programas son una herramienta que se puede utilizar para ejecutar automáticamente trabajos de segmentación por lotes una vez al día. Puede usar el extremo /config/schedules para recuperar una lista de programaciones, crear una nueva programación, recuperar detalles de una programación específica, actualizar una programación específica o eliminar una programación específica.

Introducción

Los extremos utilizados en esta guía forman parte de la API Adobe Experience Platform Segmentation Service. Antes de continuar, revisa la guía de introducción para obtener información importante que necesitas conocer para poder realizar llamadas a la API correctamente, incluidos los encabezados requeridos y cómo leer llamadas de API de ejemplo.

Recuperación de una lista de programaciones retrieve-list

Puede recuperar una lista de todas las programaciones de su organización realizando una petición GET al extremo /config/schedules.

Formato de API

El extremo /config/schedules admite varios parámetros de consulta para filtrar los resultados. Aunque estos parámetros son opcionales, se recomienda encarecidamente su uso para ayudar a reducir los costes generales. Si realiza una llamada a este extremo sin parámetros, se recuperarán todas las programaciones disponibles para su organización. Se pueden incluir varios parámetros, separados por el símbolo et (&).

GET /config/schedules
GET /config/schedules?{QUERY_PARAMETERS}

Parámetros de consulta

Una lista de parámetros de consulta disponibles.
table 0-row-3 1-row-3 2-row-3
Parámetro Descripción Ejemplo
start Especifica desde qué página comenzará el desplazamiento. De forma predeterminada, este valor es 0. start=5
limit Especifica el número de programaciones devueltas. De forma predeterminada, este valor es 100. limit=20

Solicitud

La siguiente solicitud recupera las diez últimas programaciones publicadas en su organización.

Una solicitud de ejemplo para recuperar una lista de programaciones.
code language-shell 
curl -X GET https://platform.adobe.io/data/core/ups/config/schedules?limit=10 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con una lista de programaciones para la organización especificada como JSON.

NOTE
La siguiente respuesta se ha truncado para el espacio y muestra solo la primera programación devuelta.
Una respuesta de ejemplo al recuperar una lista de programaciones.
code language-json 
{
    "_page": {
        "totalCount": 10,
        "pageSize": 1
    },
    "children": [
        {
            "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "name": "Batch Segmentation",
            "state": "active",
            "type": "batch_segmentation",
            "schedule": "0 0 1 * * ?",
            "frequency": "daily",
            "properties": {
                "segments": ["sampleSegmentDefinitionId"]
            },
            "owner": "user",
            "createEpoch": 1573158851,
            "updateEpoch": 1574365202
        }
    ],
    "_links": {
        "next": {}
    }
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2
Propiedad Descripción
_page.totalCount Número total de programaciones devueltas.
_page.pageSize El tamaño de la página de programaciones.
children.id El ID de la programación.
children.imsOrgId El ID de organización de la programación.
children.sandbox Objeto que contiene información de zona protegida para la programación.
children.name Nombre de la programación en forma de cadena.
children.state Cadena que contiene el estado de programación. Los dos estados admitidos son “activo” e “inactivo”. De forma predeterminada, el estado se establece en “inactivo”.
children.type El tipo de trabajo como cadena. Los dos tipos compatibles son batch_segmentation y export.
children.schedule Cadena que contiene la programación del trabajo. Los trabajos solo se pueden programar para que se ejecuten una vez al día, lo que significa que no puede programar un trabajo para que se ejecute más de una vez durante un período de 24 horas. Para obtener más información acerca de las programaciones de cron, lea el apéndice del formato de expresión cron. En este ejemplo, “0 0 1 * *” significa que esta programación se ejecutará a la 1 a. m. todos los días.
children.frequency La frecuencia con la que se ejecuta la programación. Los valores posibles incluyen daily, weekly, monthly y yearly.
children.properties Objeto que contiene propiedades adicionales relacionadas con la programación.
children.properties.segments Los ID de las definiciones de segmento que pertenecen a la programación.
children.owner El propietario de la programación. Los valores posibles incluyen user si la programación es creada por el usuario y system si la programación es creada por el sistema.
children.createEpoch Hora de creación de la época de la programación en segundos.
children.updateEpoch Hora de la época en la que se actualizó la programación por última vez en segundos.

Crear una nueva programación create

Puede crear una nueva programación realizando una petición POST al extremo /config/schedules.

Formato de API

POST /config/schedules

Solicitud

Una solicitud de ejemplo para crear una programación.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
{
    "name": "profile-default",
    "type": "batch_segmentation",
    "properties": {
        "segments": [
            "sampleSegmentDefinitionId"
        ]
    },
    "schedule": "0 0 1 * * ?",
    "state": "inactive"
}'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Propiedad Descripción
name Requerido. Nombre de la programación en forma de cadena.
type Requerido. El tipo de trabajo como cadena. Los dos tipos compatibles son batch_segmentation y export.
properties Requerido. Objeto que contiene propiedades adicionales relacionadas con la programación.
properties.segments Requerido cuando type es igual a “batch_segmentation”. Los ID de las definiciones de segmento que desea incluir como parte de la programación.
schedule Requerido. Cadena que contiene la programación del trabajo. Los trabajos solo se pueden programar para que se ejecuten una vez al día, lo que significa que no puede programar un trabajo para que se ejecute más de una vez durante un período de 24 horas. La programación del trabajo determinará la frecuencia de la programación. Para obtener más información acerca de las programaciones de cron, lea el apéndice del formato de expresión cron. En este ejemplo, “0 0 1 * *” significa que esta programación se ejecutará a la 1 a. m. todos los días.
state Opcional. Cadena que contiene el estado de programación. Los dos estados admitidos son active y inactive. De manera predeterminada, el estado se establece en inactive.

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con detalles de la programación recién creada.

Una respuesta de ejemplo al crear una programación.
code language-json 
{
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "e7e17720-c5bb-11e9-aafb-87c71c35cac8",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "{SCHEDULE_NAME}",
    "state": "inactive",
    "type": "batch_segmentation",
    "schedule": "0 0 1 * * ?",
    "frequency": "daily",
    "properties": {
        "segments": [
            "sampleSegmentDefinitionId"
        ]
    },
    "owner": "user",
    "createEpoch": 1568267948,
    "updateEpoch": 1568267948
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2
Propiedad Descripción
id El ID de la programación recién creada.
imsOrgId El ID de organización del usuario que creó la programación.
sandbox Un objeto que contiene la información de la zona protegida para la programación. Para obtener más información sobre las zonas protegidas, lea la descripción general de las zonas protegidas.
sandbox.sandboxId ID de la zona protegida que contiene la programación.
sandbox.sandboxName Nombre de la zona protegida que contiene la programación.
sandbox.type El tipo de zona protegida. Los valores posibles incluyen production y development.
sandbox.default Un booleano que muestra si la zona protegida es o no la predeterminada.
name El nombre que dio a la programación.
state El estado de la programación. Los valores posibles incluyen active y inactive. Si no estableció esto como parte del cuerpo de la solicitud, el estado se establecerá en inactive.
type Tipo de trabajo de la programación. Los valores posibles incluyen batch_segmentation y export.
schedule La expresión cron que representa cuándo se ejecuta la programación. Para obtener más información sobre la creación de expresiones cron, lea la sección sobre el formato de las expresiones cron.
frequency Frecuencia con la que se ejecuta la programación. Esto depende directamente de la expresión cron de la programación. Los valores posibles incluyen daily, weekly, monthly y yearly.
properties Un objeto que contenga los ID de definición del segmento para la programación, si esta es del tipo batch_segmentation.
owner El tipo de entidad que posee la programación. Desde que creó la programación, este valor es user.
createEpoch Hora de creación de la época de la programación en segundos.
updateEpoch Hora de la época en la que se actualizó la programación por última vez en segundos.

Recuperar una programación específica get

Puede recuperar información detallada sobre una programación específica realizando una petición GET al extremo /config/schedules y proporcionando el ID de la programación que desea recuperar en la ruta de solicitud.

Formato de API

GET /config/schedules/{SCHEDULE_ID}
Parámetro
Descripción
{SCHEDULE_ID}
El valor id de la programación que desea recuperar.

Solicitud

Una solicitud de ejemplo para recuperar una programación.
code language-shell 
curl -X GET https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con información detallada sobre la programación especificada.

Una respuesta de ejemplo al recuperar una programación.
code language-json 
{
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "e7e17720-c5bb-11e9-aafb-87c71c35cac8",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "{SCHEDULE_NAME}",
    "state": "inactive",
    "type": "batch_segmentation",
    "schedule": "0 0 1 * * ?",
    "frequency": "daily",
    "properties": {
        "segments": [
            "sampleSegmentDefinitionId"
        ]
    },
    "owner": "user",
    "createEpoch": 1568267948,
    "updateEpoch": 1568267948
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2
Propiedad Descripción
id El ID de la programación.
imsOrgId El ID de la organización a la que pertenece la programación.
sandbox Un objeto que contiene la información de la zona protegida para la programación. Para obtener más información sobre las zonas protegidas, lea la descripción general de las zonas protegidas.
sandbox.sandboxId ID de la zona protegida que contiene la programación.
sandbox.sandboxName Nombre de la zona protegida que contiene la programación.
sandbox.type El tipo de zona protegida. Los valores posibles incluyen production y development.
sandbox.default Un booleano que muestra si la zona protegida es o no la predeterminada.
name Nombre de la programación en forma de cadena.
state Cadena que contiene el estado de programación. Los dos estados admitidos son active y inactive. De manera predeterminada, el estado se establece en inactive.
type El tipo de trabajo como cadena. Los dos tipos compatibles son batch_segmentation y export.
schedule Cadena que contiene la programación del trabajo. Los trabajos solo se pueden programar para que se ejecuten una vez al día, lo que significa que no puede programar un trabajo para que se ejecute más de una vez durante un período de 24 horas. Para obtener más información acerca de las programaciones de cron, lea el apéndice del formato de expresión cron. En este ejemplo, “0 0 1 * *” significa que esta programación se ejecutará a la 1 a. m. todos los días.
frequency La frecuencia con la que se ejecuta la programación. Este valor depende directamente de la expresión cron de la programación. Los valores posibles incluyen daily, weekly, monthly y yearly.
properties Objeto que contiene propiedades adicionales relacionadas con la programación.
properties.segments La lista de ID de definición de segmento que forman parte de la programación.
owner El tipo de entidad que posee la programación. Si un usuario creó la programación, este valor es user. Si la programación fue creada por el sistema, este valor es system.
createEpoch Hora de creación de la época de la programación en segundos.
updateEpoch Hora de la época en la que se actualizó la programación por última vez en segundos.

Actualizar los detalles de una programación específica update

Puede actualizar una programación específica realizando una petición PATCH al extremo /config/schedules y proporcionando el ID de la programación que está intentando actualizar en la ruta de solicitud.

La solicitud de PATCH le permite actualizar el estado o la programación cron para una programación individual.

Formato de API

PATCH /config/schedules/{SCHEDULE_ID}
Parámetro
Descripción
{SCHEDULE_ID}
El valor id de la programación que desea actualizar.
Actualizar estado de programación

Puede utilizar una operación de parche JSON para actualizar el estado de la programación. Para actualizar el estado, declare la propiedad path como /state y establezca value como active o inactive. Para obtener más información sobre el parche JSON, lea la documentación de JSON Patch.

Solicitud

accordion
Una solicitud de ejemplo para actualizar el estado de la programación.
code language-shell 
curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
[
    {
        "op": "add",
        "path": "/state",
        "value": "active"
    }
]'
table 0-row-2 1-row-2 2-row-2
Propiedad Descripción
path La ruta del valor al que desea aplicar el parche. En este caso, ya que está actualizando el estado de la programación, debe establecer el valor de path en “/state”.
value El valor actualizado del estado de la programación. Este valor puede establecerse como “activo” o “inactivo” para activar o desactivar la programación. Tenga en cuenta que no puede deshabilitar una programación si la organización se ha habilitado para la transmisión por secuencias.

Respuesta

Una respuesta correcta devuelve el estado HTTP 204 (sin contenido).

Actualizar programación de cron
Puede utilizar una operación de parche de JSON para actualizar la programación de cron. Para actualizar la programación, declare la propiedad path como /schedule y establezca value como una programación cron válida. Para obtener más información sobre el parche JSON, lea la documentación de JSON Patch. Para obtener más información acerca de las programaciones de cron, lea el apéndice del formato de expresión cron.

Solicitud

Una solicitud de ejemplo para actualizar la programación.
code language-shell 
curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
[
    {
        "op":"add",
        "path":"/schedule",
        "value":"0 0 2 * * ?"
    }
]'
table 0-row-2 1-row-2 2-row-2
Propiedad Descripción
path La ruta del valor que desea actualizar. En este caso, ya que está actualizando la programación de cron, debe establecer el valor de path en /schedule.
value El valor actualizado de la programación de cron. Este valor debe estar en forma de programación cron. En este ejemplo, la programación se ejecutará el segundo de cada mes.

Respuesta

Una respuesta correcta devuelve el estado HTTP 204 (sin contenido).

Eliminar una programación específica

Puede solicitar eliminar una programación específica realizando una petición DELETE al extremo /config/schedules y proporcionando el ID de la programación que desea eliminar en la ruta de solicitud.

Formato de API

DELETE /config/schedules/{SCHEDULE_ID}
Parámetro
Descripción
{SCHEDULE_ID}
El valor id de la programación que desea eliminar.

Solicitud

Una solicitud de ejemplo para eliminar una programación.
code language-shell 
curl -X DELETE https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Respuesta

Una respuesta correcta devuelve el estado HTTP 204 (sin contenido).

Añadir audiencias a la programación add-audiences

Puede agregar audiencias a una programación específica realizando una petición POST al extremo /config/schedules/add-audiences.

Formato de API

POST /config/schedules/add-audiences

Solicitud

Una solicitud de ejemplo para añadir audiencias a la programación.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/add-audiences/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "segments": [
        "sampleSegmentDefinitionId"
    ]
 }
 '
Propiedad
Descripción
id
El ID de la programación a la que desea agregar las audiencias.
segments
Matriz de ID de definición de segmento que desea añadir a la programación designada.

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con información detallada de la operación.

Una respuesta de ejemplo al añadir audiencias a la programación.
code language-json 
{
    "added:" [
        "sampleSegmentDefinitionId"
    ],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous": 0,
        "current": 1,
        "diff": 1
    }
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Propiedad Descripción
added Matriz que contiene los ID de las definiciones de segmento agregadas a la programación.
existing Matriz que contiene los ID de las definiciones de segmento que ya estaban en la programación.
invalid Matriz que contiene ID de definición de segmento no válidos que formaban parte del cuerpo de la solicitud.
segmentCount Un objeto que contiene el número de definiciones de segmento que anteriormente formaban parte de la programación (previous), el número de definiciones de segmento que ahora forman parte de la programación (current) y la diferencia entre esos dos valores (diff).

Eliminar audiencias de la programación remove-audiences

Puede quitar audiencias de una programación específica realizando una petición POST al extremo /config/schedules/remove-audiences.

Formato de API

POST /config/schedules/remove-audiences

Solicitud

Una solicitud de ejemplo para eliminar audiencias de la programación.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/remove-audiences/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "segments": [
        "sampleSegmentDefinitionId"
    ]
 }
 '
Propiedad
Descripción
id
El ID de la programación de la que deben eliminarse las audiencias.
segments
Matriz de ID de definición de segmento que desea eliminar de la programación designada.

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con información detallada de la operación.

Una respuesta de ejemplo al eliminar audiencias de la programación.
code language-json 
{
    "removed": [
        "sampleSegmentDefinitionId"
    ],
    "notFound": [],
    "segmentCount": {
        "previous": 2,
        "current": 1,
        "diff": -1
    }
}
table 0-row-2 1-row-2 2-row-2 3-row-2
Propiedad Descripción
removed Matriz que contiene los ID de las definiciones de segmento eliminadas de la programación.
notFound Matriz que contiene los ID de definiciones de segmento que no se han encontrado en la programación.
segmentCount Un objeto que contiene el número de definiciones de segmento que anteriormente formaban parte de la programación (previous), el número de definiciones de segmento que ahora forman parte de la programación (current) y la diferencia entre esos dos valores (diff).

Obtener mapa de audiencia get-audience-map

Puede obtener el mapa de audiencia de sus audiencias realizando una petición POST al extremo /config/schedules/audience-map. El mapa de audiencia representa una asignación entre los ID de definición del segmento y las programaciones a las que pertenecen dichos ID.

Formato de API

POST /config/schedules/audience-map

Solicitud

Una solicitud de ejemplo para obtener el mapa de audiencia de los ID de definición de segmento correspondientes.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/audience-map/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "segments": [
        "sampleSegmentDefinitionId",
        "sampleSegmentDefinition2",
        "sampleSegmentDefinition3"
    ]
 }
 '
Propiedad
Descripción
segments
Matriz de ID de definición de segmento para los que desea recuperar la información de programación.

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 con información detallada sobre la asignación de audiencia y programación.

Una respuesta de ejemplo al obtener el mapa de audiencia.
code language-json 
{
    "audienceMap": {
        "sampleSegmentDefinitionId": [
            "4e538382-dbd8-449e-988a-4ac639ebe72b"
        ],
        "sampleSegmentDefinition2": [],
        "sampleSegmentDefinition3": []
    },
    "schedules": {
        "4e538382-dbd8-449e-988a-4ac639ebe72b": {
            "name": "Sample schedule",
            "schedule": "0 0 18 * * ?",
            "frequency": "daily"
        }
    }
}
table 0-row-2 1-row-2 2-row-2
Propiedad Descripción
audienceMap Asignación de ID de definición de segmento con las programaciones a las que pertenecen.
schedules Un objeto que contiene información sobre las programaciones que se enumeran en el mapa de audiencia.

trabajo de programación de déclencheur trigger

Puede almacenar en déclencheur manualmente una programación para activarla realizando una petición POST al extremo /config/schedules/trigger.

Formato de API

POST /config/schedules/trigger

Solicitud

Una solicitud de ejemplo para almacenar en déclencheur una programación para su activación.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/trigger/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b"
 }
 '
Propiedad
Descripción
id
El ID de la programación que desea activar. Usted debe activar las programaciones de una en una.

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 sin contenido.

Próximos pasos

Después de leer esta guía, ahora tiene una mejor comprensión de cómo funcionan los horarios.

Apéndice appendix

En el siguiente apéndice se explica el formato de las expresiones cron utilizadas en las programaciones.

Formato

Una expresión cron es una cadena que consta de 6 o 7 campos. La expresión tendría un aspecto similar al siguiente:

0 0 12 * * ?

En una cadena de expresión cron, el primer campo representa los segundos, el segundo campo representa los minutos, el tercer campo representa las horas, el cuarto campo representa el día del mes, el quinto campo representa el mes y el sexto campo representa el día de la semana. Si lo desea, también puede incluir un séptimo campo, que representa el año.

Nombre del campo
Requerido
Valores posibles
Caracteres especiales permitidos
Seconds
Sí
0-59
, - * /
Minutes
Sí
0-59
, - * /
Horas
Sí
0-23
, - * /
Día del mes
Sí
1-31
, - * ? / L W
Month
Sí
1 A 12 DE ENERO A DICIEMBRE
, - * /
Día de la semana
Sí
1-7, SUN-SAT
, - * ? / L #
Year
No
Vacío, 1970-2099
, - * /
NOTE
Los nombres de los meses y los nombres de los días de la semana no distinguen entre mayúsculas y minúsculas. Por lo tanto, SUN equivale a usar sun.

Los caracteres especiales permitidos representan los siguientes significados:

Carácter especial
Descripción
*
Este valor se usa para seleccionar todos los valores de un campo. Por ejemplo, poner * en el campo de horas significaría cada hora.
?
Este valor significa que no se requiere ningún valor específico. Esto se utiliza generalmente para especificar algo en un campo donde el carácter está permitido, pero no para especificarlo en el otro. Por ejemplo, si desea que un evento se active cada tres días del mes, pero no le importa qué día de la semana sea, debe colocar 3 en el campo día del mes y ? en el campo día de la semana.
-
Este valor se usa para especificar inclusivo intervalos para el campo. Por ejemplo, si pone 9-15 en el campo de horas, significaría que las horas incluirían 9, 10, 11, 12, 13, 14 y 15.
,
Este valor se utiliza para especificar valores adicionales. Por ejemplo, si pone MON, FRI, SAT en el campo de día de la semana, significaría que los días de la semana incluirían lunes, viernes y sábado.
/
Este valor se utiliza para especificar incrementos. El valor colocado antes de / determina desde dónde se incrementa, mientras que el valor colocado después de / determina en qué medida se incrementa. Por ejemplo, si pone 1/7 en el campo de minutos, significaría que los minutos incluirían 1, 8, 15, 22, 29, 36, 43, 50 y 57.
L
Este valor se usa para especificar Last y tiene un significado diferente según el campo por el que lo use. Si se utiliza con el campo de día del mes, representa el último día del mes. Si se utiliza con el campo de día de la semana de forma independiente, representa el último día de la semana, que es sábado (SAT). Si se utiliza con el campo de día de la semana, junto con otro valor, representa el último día de ese tipo para el mes. Por ejemplo, si pone 5L en el campo de día de la semana, solo incluirá el último viernes del mes.
W
Este valor se utiliza para especificar el día de semana más cercano al día determinado. Por ejemplo, si pone 18W en el campo de día del mes y el día 18 de ese mes es sábado, entrará en déclencheur el viernes 17, que es el día más cercano entre semana. Si el 18 de ese mes fuera domingo, déclencheur el lunes 19, que es el día más cercano entre semana. Tenga en cuenta que si coloca 1W en el campo de día del mes y el día de la semana más cercano sería el mes anterior, el evento seguirá en déclencheur el día de la semana más cercano del mes actual.

Además, puede combinar L y W para hacer LW, lo que especificaría el último día de la semana del mes.
#
Este valor se utiliza para especificar el enésimo día de la semana de un mes. El valor colocado antes de # representa el día de la semana, mientras que el valor colocado después de # representa qué ocurrencia del mes es. Por ejemplo, si pone 1#3, el evento generaría déclencheur el tercer domingo del mes. Tenga en cuenta que si coloca X#5 y no hay quinta incidencia de ese día de la semana en ese mes, el evento no se activará. Por ejemplo, si pone 1#5 y no hay quinto domingo en ese mes, el evento no se activará.

Ejemplos

La siguiente tabla muestra cadenas de expresión cron de muestra y explica qué significan.

Expresión
Explicación
0 0 13 * * ?
El evento se activará a la 1 p. m. todos los días.
0 30 9 * * ? 2022
El evento se activará todos los días a las 9:30 a. m. en el año 2022.
0 * 18 * * ?
El evento se activará cada minuto, empezando a las 6 PM y terminando a las 6:59 PM, todos los días.
0 0/10 17 * * ?
El evento se activará cada 10 minutos, comenzando a las 5 PM y terminando a las 6 PM, todos los días.
0 13,38 5 ? 6 WED
El evento se activará a las 5:13AM y a las 5:38AM todos los miércoles en junio.
0 30 12 ? * 4#3
El evento se activará a las 12:30 p.m. el tercer miércoles de cada mes.
0 30 12 ? * 6L
El evento se activará a las 12:30 p.m. del último viernes de cada mes.
0 45 11 ? * MON-THU
El evento se activará a las 11:45 a.m. todos los lunes, martes, miércoles y jueves.
recommendation-more-help
experience-platform-help-segmentation