Creación de programas

Puede usar el programador de recursos para crear programas y agregar recursos, fechas, horas de inicio y finalización a los programas, y revisar y editar el programa antes de guardarlo.

Visión general de tareas

Complete los requisitos y cree las políticas necesarias.
Agregue información básica de programa (etiquetas de nombre de programa, descripción, acción y (opcionalmente).
Seleccionar un compartimento y recursos
Aplicar parámetros (opcional)
Agregar fechas y horas a la programación
Revisar y guardar el programa
Supervisión y gestión de programas (edite, desactive, active, suprima, según sea necesario)

Requisitos

Antes de crear un programa, compruebe los requisitos enumerados aquí y cree las políticas necesarias para permitir a los usuarios crear programas y programas para gestionar recursos.

Administradores, cree las políticas necesarias que se describen en la siguiente sección de esta página.
Usuarios, compruebe sus derechos de acceso y obtenga los permisos necesarios del administrador para crear programas.
Antes de crear un programa, asegúrese de tener la siguiente información:
- Los nombres de los arrendamientos, compartimentos, regiones y organizaciones donde se encuentran los recursos
- Lista de recursos que se verán afectados por las acciones programadas
- Las fechas y horas de las acciones de inicio y finalización que se incluirán en los programas
Comprobación de Conflictos de Planificación. Busque programas existentes que utilicen los mismos recursos que está programando al mismo tiempo que los está programando.

Políticas necesarias

Importante

Para poder crear o gestionar un programa, debe crear una política para otorgar a los usuarios permiso para gestionar programas (consulte el ejemplo 1) Y debe crear una política para asignar a los programas permiso para gestionar recursos (consulte el ejemplo 2).

Ejemplo1. Esta política otorga a los usuarios permiso para gestionar (enumerar, crear, suprimir, activar y otros) programas de recursos en su arrendamiento.

General example
Allow group <groupname> to manage resource-schedule-family in tenancy

Specific example
Allow group ResourceScheduleAdmins to manage resource-schedule-family in tenancy

Por ejemplo 2. Esta política otorga a un recurso permiso de programación para realizar una acción en un recurso.

Cuando se crea un programa de recursos, por defecto, no tiene permiso para realizar una acción en los recursos de destino, por lo que debe otorgarle permiso.

Esta política proporciona un permiso de programación para gestionar recursos predefinidos como instancias en un compartimento.

General example
Allow any-user to manage <resource_type> 
in compartment id <compartment_ocid> where all
{request.principal.type='resourceschedule',
request.principal.id='<ocid_of_resourceschedule>'}

Specific example
Allow any-user to manage instance in
compartment id ocid.compartment.oc1...q7fa where all
{request.principal.type='resourceschedule',
request.principal.id='ocid.resourceschedule.oc1.iad.axgr...dt8zb'}

Nota

Para obtener más información, consulte Autenticación y autorización, Políticas del programador de recursos y Políticas de ejemplo.

Autenticación y autorización

En esta página se describe el proceso de IAM de Identity and Access Management que se utiliza para garantizar el acceso seguro al programador de recursos.

Cada servicio de Oracle Cloud Infrastructure se integra con IAM con fines de autenticación y autorización para todas las interfaces (la consola, el SDK o la CLI, y la API de REST).

Un administrador de la organización debe configurar grupos, compartimentos ypolíticas que controlen qué usuarios pueden acceder a qué servicios y recursos, así como el tipo de acceso. Por ejemplo, las políticas controlan quién puede crear usuarios, crear y gestionar la red en la nube, iniciar instancias, crear cubos, descargar objetos, etc. Para obtener más información, consulte Gestión de dominios de identidad. Para obtener detalles específicos sobre la escritura de políticas de los distintos servicios, consulte Referencia de políticas.

Política de ejemplo

Permita que el grupo ResourceScheduleAdmins realice operaciones administrativas con programas de recursos, incluidos Crear, Actualizar, Mover y Suprimir.

Allow group ResourceScheduleAdmins to manage resource-schedule in tenancy

Nota

En Políticas de ejemplo se muestran más ejemplos de políticas.

Si es un usuario (pero no un administrador) que debe utilizar los recursos de Oracle Cloud Infrastructure que posee su compañía, póngase en contacto con el administrador para que configure su identificador de usuario. Un administrador puede confirmar qué compartimentos debe utilizar.

Para utilizar cualquiera de las operaciones de API del programador de recursos, debe estar autorizado en una política de IAM. Si no tiene autorización, póngase en contacto con el administrador. Si es un administrador que necesita escribir políticas para otorgar acceso a los usuarios, consulte Gestión de dominios de identidad.

Adición de información de programación básica

En la página Resource Scheduler Schedules, seleccione Create a Schedule. Se abre la página Crear información básica de programa. En la página Información básica:
1. Introduzca un nombre de programa.
2. Opcional: Introduzca una descripción de programa
3. En el campo Acción que se va a ejecutar, seleccione Iniciar o Parar.
4. En el campo Schedule Compartment, utilice el menú para seleccionar el compartimento en el que desea que esté el nuevo programa.
5. Opcional: Seleccione Mostrar Opciones Avanzadas. Puede aplicar etiquetas a los recursos para ayudarle a organizarlos según las necesidades de su negocio. Puede aplicar etiquetas al crear un recurso o actualizar el recurso más tarde con etiquetas. Consulte Adición de etiquetas para obtener información sobre la adición de etiquetas a recursos. Para obtener información general sobre la aplicación de etiquetas, consulte Etiquetas de recursos.

Adición de recursos

Importante

El programador de recursos soporta los siguientes tipos de recursos:

Instancias informáticas
Pools de instancias informáticas
Base de datos autónoma
Recursos funcionales

Puede admitir otros recursos en futuras versiones. Para ver la lista de recursos soportados, utilice la API ListResourceTypes.

Nota

El programador de recursos solo puede procesar 200 recursos por programa. Si selecciona Dinámico, el programador de recursos agrega los primeros 200 recursos que ve en la cola. No puede seleccionar manualmente los recursos ni definir el orden de los recursos que se agregan dinámicamente. Si crea una segunda planificación y selecciona Dynamic, Resource Scheduler agrega el mismo juego de 200 recursos que antes. Para programar más de 200 recursos, cree tantas programaciones como sea necesario, seleccione recursos estáticos y agregue hasta 200 recursos por programa, en el orden que desee. Para obtener más información, consulte Dynamic Resource Management y Static Resource Management.

En el panel izquierdo de la página Crear programaciones, seleccione Recursos. Se muestra la página Resources y la lista de recursos existentes en el compartimento seleccionado.
Según sea necesario, seleccione un compartimento diferente.
Seleccione uno o más recursos de la lista de recursos o cambie los criterios de selección como se describe en los siguientes pasos.
1. En el campo Método de selección de recurso, seleccione el tipo de recurso que desea gestionar con la programación, ya sea Estática o Dinámica. Al buscar recursos, solo se muestra el tipo seleccionado.
2. En el campo Buscar y filtrar, utilice la selección por defecto (compartimento todo) para buscar recursos o seleccione Compartimento y utilice el menú para seleccionar un compartimento diferente para buscar recursos. Los siguientes tipos de recursos están disponibles para buscar.
  - compartimento
  - Tipo de Recurso
  - Estado
  - Etiquetas

En la siguiente tabla, se muestran los tipos de recursos y las descripciones de cada uno.

Tipos de recursos
Nombre del Filtro	Descripción
compartimento	Utilice el valor por defecto seleccionado (Todos) o seleccione Compartimento para mostrar el menú Seleccionar compartimento. En el cuadro de diálogo Seleccionar compartimento, seleccione Buscar compartimentos y utilice el menú para seleccionar el compartimento que contiene los recursos que desea programar. Seleccione Apply Filter (Aplicar filtro) para seleccionar el compartimento o seleccione Clear (Borrar) para cerrar el cuadro de diálogo sin realizar una selección.
Nombre mostrado	Seleccione Nombre mostrado en la lista para abrir el cuadro de diálogo Nombre mostrado. Introduzca el nombre mostrado del recurso que desea buscar y seleccione Aplicar filtro para seleccionarlo. Cuando el recurso se muestre en la tabla, active la casilla de control para seleccionarlo para utilizarlo en la programación. Seleccione Aplicar filtro para seleccionar el nombre mostrado o seleccione Borrar para cerrar el cuadro de diálogo sin realizar ninguna selección.
OCID	Seleccione OCID en Introduzca el OCID del recurso que desea buscar.
Tipo de recurso	Seleccione Tipo de recurso en la lista para abrir el cuadro de diálogo Buscar. Seleccione una instancia de Autonomous Database o (Compute) o ambas. En la lista solo se muestran los recursos del tipo que seleccione. Seleccione Aplicar filtro para seleccionar el tipo de recurso o seleccione Borrar para cerrar el cuadro de diálogo sin realizar ninguna selección. Nota. Debe mostrar al menos un tipo de recurso. Si borra todas las selecciones, no se muestra ningún recurso y la búsqueda está desactivada.
Estado	La selección por defecto es Todo. Para mostrar programas con un estado diferente, seleccione Estado para abrir el menú Buscar. Seleccione uno o varios de los siguientes estados: Disponible, Creando, Actualizando, Suprimiendo, Suprimido, Con fallos, Inactivo, Parado o Finalizado. Nota. Si no selecciona un estado, el cuadro de diálogo se cierra sin guardar una selección.
Fecha de creación	Introduzca la hora UTC a la que se creó el recurso

Seleccione Aplicar filtro para ejecutar la búsqueda y mostrar la lista de recursos que se encuentran.

Aplicar parámetros (opcional)

Puede utilizar la página Aplicar parámetros para agregar de forma opcional parámetros a los recursos seleccionados al crear o editar un programa.

Nota

El programador de recursos actualmente solo soporta el parámetro Cuerpo en el recurso Función. Puede admitir otros parámetros en futuras versiones.

En el panel izquierdo de la página Crear programaciones, seleccione Aplicar parámetros.
Seleccione un nombre de parámetro en el menú.
Opcional: introduzca un valor para el parámetro.
Seleccione uno o más recursos a los que aplicar el parámetro.
Seleccione Siguiente para ir a la página Programas o, si no hay otros cambios en el programa, seleccione Revisar, verifique los cambios y seleccione Guardar programa (si está creando un programa) o Editar programa (si está editando un programa).

Adición de información de programación

Utilice la página Programa para agregar fechas y horas para iniciar y parar el programa. Puede introducir manualmente la información mediante los formularios de la interfaz de usuario o con una expresión Cron, o bien usar la CLI o la API para agregar información de programación.

Uso de formularios de la interfaz de usuario

Puede utilizar los formularios de la interfaz de usuario para agregar información de tiempo al programa, seleccionar un compartimento para el programa y configurar parámetros adicionales para el programa. Uso de una Expresión Cron para obtener información sobre el uso de Cron para definir la planificación.

Nota

El programador de recursos solo utiliza la hora UTC. No cambia automáticamente las horas programadas cuando la hora local cambia de la hora estándar a la hora de verano o de la hora de verano a la hora estándar.

Nota

No puede crear un programa que Se dispare a un intervalo de menos de una hora. Solo se permiten intervalos de una hora o más. Sin embargo, puede crear dos programas de 1 hora para la misma operación en los mismos recursos que se inician con una diferencia de 30 minutos para lograr lo mismo que ejecutar un programa cada 30 minutos. Mientras que cada horario funciona cada hora, se ejecutan cada 30 minutos, tomando turnos.

Por ejemplo: puede crear una programación para que se ejecute cada hora con una hora de inicio como 12:00 p.m. en una lista de instancias y otra programación que se ejecute cada hora con la misma acción y juego de instancias, con una hora de inicio como 12:30 p.m., la acción se realiza de manera efectiva cada 30 minutos, aunque cada programación tenga un intervalo por hora.

Introduzca un intervalo para el programa. En el campo Intervalo, utilice el menú para seleccionar el intervalo de tiempo para el programa. Las opciones son:
- Única
- Por Hora
- Cada Día
- Cada semana
- Mes

Creación de un Programa Único

Seleccione el campo Interval para mostrar el menú.
Seleccione Una sola vez. Se abre el cuadro de diálogo de una sola vez.
En el campo Hora, introduzca la hora UTC en formato de 24 horas. Consulte la nota sobre la hora UTC anterior.
Seleccione el icono de calendario para seleccionar la fecha y la hora en que se iniciará la acción especificada en el programa.
Seleccione Siguiente para revisar el programa, incluida la información básica, los recursos y la información de programa.
Después de revisar el programa, seleccione Crear para guardar el programa. La acción (iniciar/detener) se ejecuta en los recursos seleccionados en la fecha y hora seleccionadas.

Creación de un programa por horas

Seleccione el campo Intervalo para mostrar el menú.
Seleccione Por hora. Se abre el cuadro de diálogo Cada hora.
En el campo Hora, introduzca la hora UTC en formato de 24 horas. Consulte la nota sobre la hora UTC anterior.
En el campo Fecha de inicio, introduzca la fecha de inicio en formato MM/DD/AAAA o utilice el icono de calendario para seleccionar una fecha y hora.
Para definir la fecha de finalización, seleccione el campo Fecha de finalización y utilice el calendario para introducir la fecha y hora de finalización/

Creación de un programa diario

Seleccione el campo Interval para mostrar el menú.
Seleccione Diario. Se abre el cuadro de diálogo Diario.
En el campo Repetir cada, introduzca la frecuencia con la que desea que se ejecute el programa o utilice el menú para seleccionar un intervalo. El valor mínimo es 1. El valor máximo es 99.
En el campo Días de la semana, seleccione Seleccionar... para seleccionar los días de la semana para ejecutar el programa. Puede seleccionar uno o más días de la semana, uno a la vez. Seleccione la X junto a un nombre mostrado para suprimirlo de la lista de días seleccionados.
En el campo Hora de inicio, introduzca la hora UTC en horas y minutos en formato de 24 horas. Consulte la nota sobre la hora UTC anterior.
En el campo Fecha de inicio, introduzca la fecha de inicio en formato MM/DD/AAAA o utilice el icono de calendario para seleccionar una fecha y hora.
Para definir la fecha de finalización, seleccione el campo Fecha de finalización y utilice el calendario para introducir la fecha y hora de finalización/

Creación de un programa semanal

Seleccione el campo Interval para mostrar el menú.
Seleccione Semanal. Se abre el cuadro de diálogo Semanal.
En el campo Repetir cada, introduzca la frecuencia con la que desea que se repita el programa. Por ejemplo, 1 = cada semana, 2 = cada dos semanas, 3 = cada tres semanas. El número mínimo de semanas es 1. El número máximo de semanas es 99.
En el campo Días de la semana, seleccione los días de la semana en los que desea que se ejecute el programa. Puede seleccionar uno o varios días, uno a la vez. Para eliminar un día, seleccione la X junto al día.
En el campo Fecha de inicio, utilice el calendario para seleccionar una fecha y hora en la que se inicia el programa.
Opcional: en el campo Fecha de finalización, utilice el calendario para seleccionar la fecha y la hora en que finaliza el programa.

Creación de un programa mensual

Seleccione el campo Interval para mostrar el menú.
Seleccione Mensual. Se abre el cuadro de diálogo Mensual.
En el campo Repetir cada, introduzca la frecuencia con la que desea que se repita el programa. Por ejemplo, 1 = cada mes, 2 = cada dos meses, 3 = cada tres meses. El número mínimo de meses es 1. El número máximo de meses es 99.
En el campo Días del mes, seleccione el número del día del mes en el que desea que se ejecute el programa. Por ejemplo, 1 es el primer día del mes, 17 es el decimoséptimo día del mes. Puede seleccionar uno o varios días, uno a la vez. Para eliminar un día, seleccione la X junto al día.
En el campo Hora de inicio, utilice el calendario para seleccionar una fecha y hora UTC cuando se inicie el programa. Consulte la nota sobre la hora UTC anterior.
En el campo Fecha de finalización, utilice el calendario para seleccionar la fecha y la hora UTC en que finaliza el programa.

Uso de una expresión Cron

Puede utilizar una expresión Cron para definir el programa. Para utilizar la consola, consulte Uso de los formularios de la interfaz de usuario para obtener información sobre el uso de los formularios de la interfaz de usuario para definir el programa.

Nota

No puede crear un programa que se dispare a un intervalo de menos de una hora. Solo se permiten intervalos de una hora o más. Por ejemplo, puede crear una planificación con la expresión 0 * 15 * * para ejecutar la planificación cada hora el día 15 de cualquier mes. No puede definir un programa con */15 * 15 * * que sería cada 15 minutos el día 15 de cualquier mes.

Sin embargo, puede crear dos programas de 1 hora para la misma operación en los mismos recursos que se inician con una diferencia de 30 minutos para lograr lo mismo que ejecutar un programa cada 30 minutos. Mientras que cada horario funciona cada hora, se ejecutan cada 30 minutos, tomando turnos.

Por ejemplo: puede crear una programación para que se ejecute cada hora con una hora de inicio como 12:00 p.m. en una lista de instancias y otra programación que se ejecute HORARIO con la misma acción y juego de instancias, con una hora de inicio como 12:30 p.m., La acción se realiza de manera efectiva cada 30 minutos, aunque cada programación tenga un intervalo por hora.

En la ventana Programar, seleccione Cron para mostrar la ventana Cron.
Introduzca una expresión Cron válida para definir el intervalo de programación, la fecha y hora de inicio y la fecha y hora de finalización. Por ejemplo: Ejemplos
```
30 13 * * mon-fri 
```
Esta expresión significa que cada semana a las 13:30 UTC todos los lunes, martes, miércoles, jueves y viernes.
```
0 */2 15 * *
```
Esta expresión define el programa para que se ejecute cada 2 horas el día 15 de cualquier mes.
En el campo Fecha de inicio, introduzca la fecha de inicio manualmente o utilice el calendario para seleccionar una fecha.
Opcional: en el campo Fecha de finalización, introduzca la fecha de finalización manualmente o utilice el calendario para seleccionar una fecha

Detalles de expresión cron

Nota

No puede crear un programa que Se dispare a un intervalo de menos de una hora. Solo se permiten intervalos de una hora o más. Por ejemplo, puede crear un programa con la expresión 0 * 15 * * para ejecutar el programa cada hora el día 15 de cualquier mes. No puede definir un programa con */15 * 15 * * que sería cada 15 minutos el día 15 de cualquier mes.

Una expresión cron es una cadena de cinco campos, cada uno separado por un espacio en blanco.

Introduzca la expresión cron con el siguiente formato, utilizando los siguientes valores:

<minuto>: de 0 a 59
<hora>: de 0 a 23
<días del mes>: 1 a 31
<meses>: del 1 al 12 (de enero a diciembre)
<días de la semana>: 1 a 7 (de lunes a domingo)

Por ejemplo, para ejecutar el programa a las 23:00 del día 15 de cualquier mes, introduzca esta expresión: 0 23 15 * *

Un campo también puede tener los siguientes caracteres especiales:

Caracteres Especiales
Caracteres	Descripción
*	Asterisco: representa cualquier valor.
,	Coma: separador para más de un valor. Por ejemplo, para <días de la semana>, 2,3 representa martes y miércoles.
-	Guión: rango de valores. Por ejemplo, para <días de la semana>, de 1 a 3 representa de lunes a miércoles.
/	Barra: valores de paso. Por ejemplo, para <hour>, */3 representa cada 3 horas.

Para obtener más información sobre la creación y el formato de expresiones Cron, consulte Creación de un programa de expresiones Cron.

Importante

El programador de recursos no soporta el intervalo de 30 minutos que se muestra en esa página. El intervalo mínimo del programador de recursos es de una hora.

Revisión de un programa

La revisión y edición de un programa o la creación de uno nuevo a partir de uno existente es el paso final del proceso para crear un programa.

Importante

Para gestionar los programas del programador de recursos, debe tener permisos para acceder a ellos y cambiarlos. Para obtener más información, consulte Autenticación y autorización, Políticas del programador de recursos y Políticas de ejemplo.

Después de completar los pasos principales (Básico, Recursos y Programación) para crear un programa, seleccione Revisar. La ventana Revisar incluye una sección independiente para cada paso principal a fin de crear una programación. Cada sección muestra toda la información que ha introducido o seleccionado en esa parte del proceso para crear un programa.
Revise y edite la información de cada sección según sea necesario.
Cuando haya terminado, la ventana se cerrará y volverá a la lista de programaciones. Mientras el programador de recursos crea el programa, el estado de la solicitud de trabajo del programa es Creando. Cuando se completa la solicitud de trabajo, el estado indica Correcto. Si la información de la programación nueva o actualizada no es válida, el programador de recursos devuelve el error 400 (solicitud incorrecta, entrada no válida). La solicitud de actualización falla y no se aplica ningún cambio al programa.

Utilice el comando Create Schedule CLI del programador de recursos y los parámetros necesarios para crear un programa.
```
oci resource-scheduler schedule create --action, --compartment-id | -c, --recurrence-details,
      --defined-tags, --description, --display-name, --freeform-tags, -? | -h | --help,
      --resource-filters, --resources, --time-starts
```
Para obtener una lista completa de los parámetros y valores de todos los comandos de la CLI del programador de recursos, consulte la CLI del programador de recursos.

Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de CLI.
Utilice la API CreateSchedule del programador de recursos para crear un programa.
Para obtener una lista completa de las API del programador de recursos, consulte API del programador de recursos.

Documentación de Oracle Cloud Infrastructure