Extremo de programaciones

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 complemento /config/schedules punto final 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.

Primeros pasos

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

Recuperación de una lista de programaciones

Puede recuperar una lista de todas las programaciones de su organización realizando una solicitud de GET a la /config/schedules punto final.

Formato de API

El /config/schedules el punto de conexión 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?start={START}
GET /config/schedules?limit={LIMIT}
Parámetro Descripción
{START} Especifica desde qué página comenzará el desplazamiento. De forma predeterminada, este valor es 0.
{LIMIT} Especifica el número de programaciones devueltas. De forma predeterminada, este valor es 100.

Solicitud

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

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 IMS especificada como JSON.

NOTA

La siguiente respuesta se ha truncado para el espacio y muestra solo la primera programación devuelta.

{
    "_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 * * ?",
            "properties": {
                "segments": []
            },
            "createEpoch": 1573158851,
            "updateEpoch": 1574365202
        }
    ],
    "_links": {
        "next": {}
    }
}
Propiedad Descripción
_page.totalCount Número total de programaciones devueltas.
_page.pageSize El tamaño de la página de programaciones.
children.name Nombre de la programación en forma de cadena.
children.type El tipo de trabajo como cadena. Los dos tipos admitidos son "batch_segmentation" y "export".
children.properties Objeto que contiene propiedades adicionales relacionadas con la programación.
children.properties.segments Uso de ["*"] garantiza que todos los segmentos estén incluidos.
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 sobre los horarios de cron, lea el apéndice en la 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.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".

Crear una nueva programación

Puede crear una nueva programación realizando una solicitud de POST a /config/schedules punto final.

Formato de API

POST /config/schedules

Solicitud

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":[
            "*"
        ]
    },
    "schedule":"0 0 1 * * ?",
    "state":"inactive"
}'
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 admitidos son "batch_segmentation" y "export".
properties Requerido. Objeto que contiene propiedades adicionales relacionadas con la programación.
properties.segments Necesario cuando type es igual a “batch_segmentation”. Uso de ["*"] garantiza que todos los segmentos estén incluidos.
schedule Opcional. 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 sobre los horarios de cron, lea el apéndice en la 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.

Si no se proporciona esta cadena, se generará automáticamente una programación generada por el sistema.
state Opcional. 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".

Respuesta

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

{
    "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 * * ?",
    "properties": {
        "segments": [
            "*"
        ]
    },
    "createEpoch": 1568267948,
    "updateEpoch": 1568267948
}

Recuperar una programación específica

Puede recuperar información detallada sobre una programación específica realizando una solicitud de GET al /config/schedules y proporciona 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 id valor de la programación que desea recuperar.

Solicitud

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.

{
    "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 * * ?",
    "properties": {
        "segments": [
            "*"
        ]
    },
    "createEpoch": 1568267948,
    "updateEpoch": 1568267948
}
Propiedad Descripción
name Nombre de la programación en forma de cadena.
type El tipo de trabajo como cadena. Los dos tipos admitidos son batch_segmentation y export.
properties Objeto que contiene propiedades adicionales relacionadas con la programación.
properties.segments Uso de ["*"] garantiza que todos los segmentos estén incluidos.
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 sobre los horarios de cron, lea el apéndice en la 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 Cadena que contiene el estado de programación. Los dos estados admitidos son active y inactive. De forma predeterminada, el estado se establece en inactive.

Actualizar los detalles de una programación específica

Puede actualizar una programación específica realizando una solicitud de PATCH a /config/schedules y proporciona el ID de la programación que intenta actualizar en la ruta de solicitud.

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

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 el path propiedad como /state y configure el value a active o inactive. Para obtener más información sobre el parche JSON, lea la Parche de JSON documentación.

Formato de API

PATCH /config/schedules/{SCHEDULE_ID}
Parámetro Descripción
{SCHEDULE_ID} El id del horario que desea actualizar.

Solicitud

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"
    }
]'
Propiedad Descripción
path La ruta del valor al que desea aplicar el parche. En este caso, dado que está actualizando el estado de la programación, debe establecer el valor de path a "/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 deshabilite una programación si la organización de IMS 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 el path propiedad como /schedule y configure el value a una programación cron válida. Para obtener más información sobre el parche JSON, lea la Parche de JSON documentación. Para obtener más información sobre los horarios de cron, lea el apéndice en la formato de expresión cron.

Formato de API

PATCH /config/schedules/{SCHEDULE_ID}
Parámetro Descripción
{SCHEDULE_ID} El id del horario que desea actualizar.

Solicitud

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 * * ?"
    }
]'
Propiedad Descripción
path La ruta del valor que desea actualizar. En este caso, dado que está actualizando la programación de cron, debe establecer el valor de path hasta /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 que se elimine una programación específica realizando una solicitud de DELETE a /config/schedules y proporciona 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 id valor de la programación que desea eliminar.

Solicitud

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).

Pasos siguientes

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

Apéndice

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
Mes Sí 1 A 12 DE ENERO A DICIEMBRE , - * /
Día de la semana Sí 1-7, SUN-SAT , - * ? / L #
Año No Vacío, 1970-2099 , - * /
NOTA

Los nombres de los meses y los nombres de los días de la semana son no distingue mayúsculas de minúsculas. Por lo tanto, SUN es equivalente a usar sun.

Los caracteres especiales permitidos representan los siguientes significados:

Carácter especial Descripción
* Este valor se utiliza para seleccionar todo valores en 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 poner 3 en el campo día del mes y ? en el campo día de la semana.
- Este valor se utiliza para especificar inclusivo intervalos para el campo. Por ejemplo, si pone 9-15 en el campo horas, esto 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 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 aumenta, mientras que el valor colocado después de / determina en qué medida se incrementa. Por ejemplo, si pone 1/7 en el campo minutos, esto significaría que los minutos incluirían 1, 8, 15, 22, 29, 36, 43, 50 y 57.
L Este valor se utiliza para especificar Lasty tiene un significado diferente según el campo por el que se utilice. 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 por sí solo, 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 día de la semana, sería solamente 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 18 de ese mes era sábado, 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 pone 1W en el campo de día del mes, y el día de semana más cercano sería el mes anterior, el evento seguirá déclencheur el día de semana más cercano del mes corriente mes.

Además, puede combinar lo siguiente L y W para realizar LW, 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 la incidencia en el mes que es. Por ejemplo, si pone 1#3, el evento tendría déclencheur el tercer domingo del mes. Tenga en cuenta que si pone 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.

En esta página