Programa trabajos de monetización

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X. información

Descripción general de los trabajos programados

La monetización ofrece un programador de trabajos y un conjunto de trabajos programados previamente para ejecutarse horarios designados.

En la siguiente tabla, se enumeran los trabajos programados previamente que proporciona la monetización y el momento en que se cumplen programada para ejecutarse (todas las horas indicadas están en UTC). También se enumera el activador para cada trabajo.

Además de los trabajos mencionados anteriormente, hay trabajos que puedes habilitar a través de eventos notificaciones, tal como se muestra en la siguiente tabla. Para obtener más información, consulta Cómo configurar las notificaciones.

Administra la programación del trabajo de monetización mediante la API

En las siguientes secciones, se describe cómo administrar la programación del trabajo de monetización mediante la API:

• Configura activadores
• Cómo compilar expresiones cron
• Visualiza trabajos programados con la API
• Actualiza trabajos programados con la API
• Inhabilitar y volver a habilitar un trabajo programado API

Para obtener más información sobre las APIs que se describen en esta sección, consulta Trabajos programados en la API referencia.

Configura activadores

El programador se basa en activadores para ejecutar trabajos. Una tarea programada se ejecuta cuando se se ejecuta un activador. Las propiedades de un activador configuran la ejecución del trabajo y establecen la de estas propiedades, puedes controlar las características de la ejecución del trabajo, como cuándo se y con qué frecuencia.

Los dos tipos de activadores más comunes son los activadores cron y los activadores simples. activadores. Un activador cron tiene una propiedad cronExpression que especifica un el cronograma de ejecución. Un activador simple no tiene una propiedad cronExpression. tú especificar el startTime para indicar cuándo entra en vigor el activador Opcionalmente, endTime.

Las propiedades del activador son las siguientes (todas las horas indicadas están en UTC):

Cómo compilar expresiones cron

Una expresión cron es una cadena que consta de seis o siete campos separados por espacios en blanco. El representa un conjunto de horas, normalmente como un programa para ejecutar una rutina. Cron se usan expresiones que se especifican en la propiedad cronExpression de un activador para programar la ejecución de ese activador.

Aquí:

Los caracteres especiales se definen de la siguiente manera:

Estos son algunos ejemplos de expresiones cron (todas las horas indicadas están en UTC):

Visualiza los trabajos programados con la API

Puedes ver todos los trabajos programados actualmente si envías una solicitud GET a /triggers?orgid={org_name}

Por ejemplo:

$ curl -H "Accept:application/json" -X GET \ "http://localhost:8080/v1/mint/triggers?orgid={org_name}" \ -u email:password

A continuación, se proporciona un ejemplo de la respuesta.

[ {
  "createdDate" : 1457924378176,
  "cronExpression" : "3 0 0 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server",
  "name" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.resetdeveloperrateplancounter@@@management"
  },
  "updatedDate" : 1457924378176
}, {
  "createdDate" : 1457924378014,
  "cronExpression" : "",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.ADHOC_NOTIFY@@@management-server",
  "name" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT",
  "priority" : "4",
  "startTime" : "1372916749000",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.adhocnotify@@@management"
  },
  "updatedDate" : 1457924378014
}, {
  "createdDate" : 1457924377877,
  "cronExpression" : "0 20 1 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.CHARGE_DAILY@@@management-server",
  "name" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.chargedaily@@@management"
  },
  "updatedDate" : 1457924377877
},
...
]

También puedes ver un trabajo programado específico si envías una solicitud GET a /triggers/{trig_id}, en la que {trig_id} es la identificación del trabajo activador, como se describe en Descripción general de los trabajos programados. Por ejemplo:

$ curl -X GET \ "http://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT" \ -u email:password

A continuación, se proporciona un ejemplo de la respuesta.

{
    "createdDate" : 1457924377925,
    "cronExpression" : "0 20 2 * * ?",
    "enabled" : true,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
    "updatedDate" : 1457924377925
}

Actualiza trabajos programados con la API

Puedes actualizar un trabajo programado si cambias las propiedades de su activador. Por ejemplo, deba cambiar el programa de ejecución del activador.

Para los trabajos de activador cron (es decir, trabajos que incluyen un valor de expresión cron), solo puedes cambia los valores de cronExpression y las propiedades habilitadas. Otros cambios son ignorados. Para trabajos que no especifican un valor de expresión cron, puedes cambiar otras propiedades como startTime o priority.

Para actualizar un trabajo programado, envía una solicitud PUT a /triggers/{trig_id}, en la que {trig_id} es la identificación del activador de trabajo, como se describe en Descripción general de los trabajos programados. Cuando realices la actualización, deberás especificar cuerpo de la solicitud, la configuración actualizada y el ID del activador.

Por ejemplo, la siguiente solicitud actualiza la expresión cron para el nuevo plan de tarifas de desarrolladores. Trabajo de renovación para ejecutar todos los días a las 5 a.m. UTC:

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : true,
    "group" : "management-server", 
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

Inhabilita y vuelve a habilitar un trabajo programado con la API

Para inhabilitar un trabajo programado, establece el valor de propiedad enabled de su activador en false. Por ejemplo:

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : false,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

Para volver a habilitar un trabajo inhabilitado, establece el valor de propiedad enabled de su activador en true.

Próximos pasos

Te recomendamos volver a sincronizar periódicamente con la monetización de tu organización y cualquier desarrolladores, aplicaciones y productos que creaste con los servicios de las APIs de Edge. Descubre cómo hacerlo en Sincronizar Datos de Apigee Edge con monetización.