Création de calendriers

Vous pouvez utiliser le programmateur de ressources pour créer des programmes et ajouter des ressources, des dates, des heures de début et de fin aux programmes, et vérifier et modifier le programme avant de l'enregistrer.

Aperçu des tâches

Terminez les préalables et créez les politiques requises.
Ajoutez des informations de base sur le calendrier (nom, description, action et marqueurs (facultatif).
Sélectionner un compartiment et des ressources
Appliquer les paramètres (facultatif)
Ajouter des dates et des heures au calendrier
Vérifier et enregistrer le programme
Surveiller et gérer les programmes (modifier, désactiver, activer, supprimer, si nécessaire)

Préalables

Avant de créer un programme, vérifiez les exigences énumérées ici et créez les politiques nécessaires pour permettre aux utilisateurs de créer des programmes et des programmes pour gérer les ressources.

Administrateurs, créez les politiques requises décrites dans la section suivante de cette page.
Utilisateurs, vérifiez vos droits d'accès et obtenez les autorisations nécessaires de l'administrateur pour créer des programmes.
Avant de créer une planification, assurez-vous d'avoir les informations suivantes :
- Noms des locations, des compartiments, des régions et des organisations où les ressources sont
- Liste des ressources affectées par les actions programmées
- Dates et heures des actions de début et d'arrêt à inclure dans les programmes
Rechercher les conflits de programmation. Recherchez les programmes existants qui utilisent les mêmes ressources que celles que vous planifiez en même temps que vous les planifiez.

Politiques requises

Important

Avant de pouvoir créer ou gérer un programme, vous devez créer une politique pour accorder aux utilisateurs l'autorisation de gérer les programmes (voir Exemple 1) ET vous devez créer une politique pour donner aux programmes l'autorisation de gérer les ressources (voir Exemple 2).

Exemple 1. Cette politique permet aux utilisateurs de gérer (lister, créer, supprimer, activer et autres) les programmes de ressources dans leur location.

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

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

Exemple 2. Cette politique autorise un programme de ressources à effectuer une action sur une ressource.

Lorsqu'un programme de ressources est créé, il n'est pas autorisé par défaut à effectuer une action sur les ressources cibles. Vous devez donc lui accorder l'autorisation.

Cette politique permet de programmer la gestion de ressources prédéfinies telles que les instances d'un compartiment.

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'}

Note

Pour plus d'informations, voir Authentification et autorisation, Politiques du programmateur de ressources et Exemples de politiques.

L'authentification et l'autorisation

Cette page décrit le processus IAM de gestion des identités et des accès qui est utilisé pour assurer un accès sécurisé au programmateur de ressources.

Chaque service d'Oracle Cloud Infrastructure est intégré avec le service GIA aux fins d'authentification et d'autorisation, pour toutes les interfaces (console, trousse SDK ou interface de ligne de commande et API REST).

Un administrateur de votre organisation doit configurer les groupes , les compartiments et lespolitiques qui déterminent les utilisateurs pouvant accéder aux services et aux ressources, ainsi que le type d'accès. Par exemple, les politiques contrôlent qui peut créer des utilisateurs, créer et gérer le réseau en nuage, lancer des instances, créer des seaux, télécharger des objets, etc. Pour plus d'informations, voir Gestion des domaines d'identité. Pour des détails précis sur l'écriture de politiques pour les différents services, voir Informations de référence sur les politiques.

Exemple de politique

Autorisez le groupe ResourceScheduleAdmins à effectuer des opérations d'administration avec des programmes de ressources, notamment Créer, Mettre à jour, Déplacer et Supprimer.

Allow group ResourceScheduleAdmins to manage resource-schedule in tenancy

Note

D'autres exemples de politique sont présentés dans Exemples de politiques

Si vous êtes un utilisateur (mais pas un administrateur) qui doit utiliser les ressources Oracle Cloud Infrastructure de votre société, demandez à l'administrateur de configurer un ID utilisateur pour vous. Un administrateur vous confirmera les compartiment(s) à utiliser.

Pour utiliser l'une des opérations d'API du programmateur de ressources, vous devez être autorisé dans une politique IAM. Si vous n'êtes pas autorisé, communiquez avec l'administrateur. Si vous êtes un administrateur qui doit écrire des politiques pour accorder l'accès aux utilisateurs, voir Gestion des domaines d'identité.

Ajout d'informations de base sur le calendrier

Dans la page Programmations du programmateur de ressources, sélectionnez Créer un programme. La page Créer un programme - Informations de base s'ouvre. Dans la page Données base :
1. Entrez un nom d'échéancier.
2. Facultatif : Entrez une description de programme
3. Dans le champ Action à exécuter, sélectionnez Démarrer ou Arrêter.
4. Dans le champ Compartiment de programmation, utilisez le menu pour sélectionner le compartiment dans lequel vous voulez que le nouveau programme soit.
5. Facultatif : Sélectionnez Afficher les options avancées. Vous pouvez appliquer des marqueurs à vos ressources afin de les organiser en fonction des besoins de l'entreprise. Vous pouvez appliquer des marqueurs au moment de la création d'une ressource, ou vous pouvez mettre à jour la ressource plus tard avec des marqueurs. Voir Ajout de marqueurs pour plus d'informations sur l'ajout de marqueurs aux ressources. Pour des informations générales sur l'application de marqueurs, voir Marqueurs de ressource.

Ajout de ressources

Important

Le programmateur de ressources prend en charge les types de ressource suivants :

Instances de calcul
Groupes d'instances de calcul
Bases de données autonomes
Ressources fonctionnelles

Il pourrait prendre en charge d'autres ressources dans les versions futures. Pour voir la liste des ressources prises en charge, utilisez l'API ListResourceTypes .

Note

Le programmateur de ressources ne peut traiter que 200 ressources par programme. Si vous sélectionnez Dynamique, le programmateur de ressources ajoute les 200 premières ressources qu'il voit dans la file d'attente. Vous ne pouvez pas sélectionner manuellement les ressources ou définir l'ordre des ressources ajoutées dynamiquement. Si vous créez une seconde planification et sélectionnez Dynamic, Resource Scheduler ajoute le même jeu de 200 ressources qu'auparavant. Pour programmer plus de 200 ressources, créez autant de programmes que nécessaire, sélectionnez des ressources statiques et ajoutez jusqu'à 200 ressources par programme, dans l'ordre souhaité. Pour plus d'informations, voir Gestion dynamique des ressources Resource Management et Gestion statique des ressources Resource Management.

Dans le volet de gauche de la page Créer des programmes, sélectionnez Ressources. La page Ressources et la liste des ressources existantes dans le compartiment sélectionné sont affichées.
Si nécessaire, sélectionnez un autre compartiment.
Sélectionnez une ou plusieurs ressources dans la liste de ressources ou modifiez les critères de sélection comme décrit dans les étapes suivantes.
1. Dans le champ Méthode de sélection des ressources, sélectionnez le type de ressource à gérer avec le programme, Statique ou Dynamique. Lorsque vous recherchez des ressources, seul le type sélectionné s'affiche.
2. Dans le champ Rechercher et filtrer, utilisez la sélection par défaut (compartiment tout) pour rechercher des ressources, ou sélectionnez Compartiment et utilisez le menu pour sélectionner un autre compartiment pour rechercher des ressources. Les types de ressource suivants sont disponibles pour la recherche.
  - Compartiment
  - Type de ressource
  - Statut
  - Balises

Le tableau suivant présente les types de ressource et leur description.

Types de ressource
Nom du filtre	Description
Compartiment	Utilisez le paramètre par défaut sélectionné (Tout) ou sélectionnez Compartiment pour afficher le menu Sélectionner un compartiment. Dans la boîte de dialogue Sélection de compartiment, sélectionnez Rechercher des compartiments et utilisez le menu pour sélectionner le compartiment qui contient les ressources à programmer. Sélectionnez Appliquer le filtre pour sélectionner le compartiment ou sélectionnez Effacer pour fermer la boîte de dialogue sans effectuer de sélection.
Nom d'affichage	Sélectionnez Nom d'affichage dans la liste pour ouvrir la boîte de dialogue Nom d'affichage. Entrez le nom d'affichage de la ressource à rechercher et sélectionnez Appliquer le filtre pour la sélectionner. Lorsque la ressource est affichée dans le tableau, cochez la case pour la sélectionner à utiliser dans le programme. Sélectionnez Appliquer le filtre pour sélectionner le nom d'affichage ou sélectionnez Effacer pour fermer la boîte de dialogue sans effectuer de sélection.
OCID	Sélectionnez OCID dans la zone Entrer l'OCID de la ressource à rechercher.
Type de ressource	Sélectionnez Type de ressource dans la liste pour ouvrir la boîte de dialogue Rechercher. Sélectionnez Autonomous Database ou (Calcul) Instance ou les deux. Seules les ressources du type que vous sélectionnez sont affichées dans la liste. Sélectionnez Appliquer le filtre pour sélectionner le type de ressource ou Effacer pour fermer la boîte de dialogue sans effectuer de sélection. Note . Vous devez répertorier au moins un type de ressource. Si vous effacez toutes les sélections, aucune ressource n'est répertoriée et la recherche est désactivée.
Statut	La sélection par défaut est All. Pour afficher les programmes ayant un statut différent, sélectionnez Statut pour ouvrir le menu Rechercher. Sélectionnez tout ou partie des statuts suivants : Disponible, Création, Mise à jour, Suppression, Supprimé, Échec, Inactif, Arrêté ou Terminé. Note . Si vous ne sélectionnez pas de statut, la boîte de dialogue se ferme sans enregistrer une sélection.
Date de création	Entrer l'heure UTC à laquelle la ressource a été créée

Sélectionnez Appliquer le filtre pour exécuter la recherche et afficher la liste des ressources trouvées.

Appliquer les paramètres (facultatif)

Vous pouvez utiliser la page Appliquer les paramètres pour ajouter des paramètres aux ressources sélectionnées lorsque vous créez ou modifiez un programme.

Note

Le programmateur de ressources ne prend actuellement en charge que le paramètre Corps de la ressource Fonction. Il peut prendre en charge d'autres paramètres dans les versions futures.

Dans le volet gauche de la page Créer des programmes, sélectionnez Appliquer les paramètres.
Sélectionnez un nom de paramètre dans le menu.
Facultatif : Entrez une valeur pour le paramètre.
Sélectionnez une ou plusieurs ressources auxquelles appliquer le paramètre.
Sélectionnez Suivant pour aller à la page Programmes ou, s'il n'y a aucune autre modification au programme, sélectionnez Vérifier, vérifiez les modifications et sélectionnez Enregistrer le programme (si vous créez un programme) ou Modifier le programme (si vous modifiez un programme).

Ajout d'informations de programme

Utilisez la page Horaire pour ajouter des dates et des heures de début et d'arrêt de l'horaire. Vous pouvez entrer manuellement les informations à l'aide des formulaires d'interface utilisateur ou d'une expression Cron, ou utiliser l'interface de ligne de commande ou l'API pour ajouter des informations de programmation.

Utilisation des formulaires de l'interface utilisateur

Vous pouvez utiliser les formulaires d'interface utilisateur pour ajouter des informations de temps au programme, sélectionner un compartiment pour le programme et configurer des paramètres supplémentaires pour le programme. Utilisation d'une expression Cron pour obtenir des informations sur l'utilisation de Cron pour définir la programmation.

Note

Le programmateur de ressources utilise uniquement le temps UTC. Elle ne modifie pas automatiquement les heures programmées lorsque l'heure locale passe de l'heure standard à l'heure d'été ou de l'heure d'été à l'heure standard.

Note

Vous ne pouvez pas créer un programme qui se déclenche à un intervalle de moins d'une heure. Seuls les intervalles d'une heure ou plus sont autorisés. Toutefois, vous pouvez créer deux programmes de 1 heure pour la même opération sur les mêmes ressources qui démarrent à 30 minutes d'intervalle pour accomplir la même chose que l'exécution d'un programme toutes les 30 minutes. Bien que chaque programme fonctionne toutes les heures, il s'exécute toutes les 30 minutes, à tour de rôle.

Par exemple, vous pouvez créer un programme à exécuter toutes les heures avec une heure de début de 12:00 p.m. sur une liste d'instances, et un autre programme qui s'exécute toutes les heures avec la même action et le même jeu d'instances, avec une heure de début de 12:30 p.m., L'action est effectivement effectuée toutes les 30 minutes, même si chaque programme a un intervalle horaire.

Entrez un intervalle pour le programme. Dans le champ Intervalle, utilisez le menu pour sélectionner l'intervalle de temps pour la programmation. Les choix sont :
- Unique
- Horaire
- Chaque jour
- Chaque semaine
- Chaque mois

Création d'un programme ponctuel

Sélectionnez le champ Intervalle pour afficher le menu.
Sélectionnez Unique. La boîte de dialogue ponctuelle apparaît.
Dans le champ Heure, entrez l'heure UTC au format 24 heures. Voir la note sur l'heure UTC ci-dessus.
Sélectionnez l'icône de calendrier pour sélectionner la date et l'heure de début de l'action spécifiée dans le programme.
Sélectionnez Suivant pour réviser le programme, notamment les informations de base, les ressources et le programme.
Après avoir vérifié le programme, sélectionnez Créer pour enregistrer le programme. L'action (début/arrêt) s'exécute sur les ressources sélectionnées à la date et à l'heure sélectionnées.

Création d'un programme horaire

Sélectionnez le champ Intervalle pour afficher le menu.
Sélectionnez Horaire. La boîte de dialogue Horaire apparaît.
Dans le champ Heure, entrez l'heure UTC au format 24 heures. Voir la note sur l'heure UTC ci-dessus.
Dans le champ Date de début, entrez la date de début dans le format MM/DD/YYYY, ou utilisez l'icône de calendrier pour sélectionner une date et une heure.
Pour définir la date de fin, sélectionnez le champ Date de fin et utilisez le calendrier pour entrer la date et l'heure de fin

Création d'un programme quotidien

Sélectionnez le champ Intervalle pour afficher le menu.
Sélectionnez Tous les jours. La boîte de dialogue Quotidien s'ouvre.
Dans le champ Répéter tous les, entrez la fréquence d'exécution du programme ou utilisez le menu pour sélectionner un intervalle. La valeur minimale est 1. La valeur maximale est 99.
Dans le champ Jours de la semaine, sélectionnez Sélectionner... pour sélectionner les jours de la semaine pour exécuter le programme. Vous pouvez sélectionner un ou plusieurs jours de la semaine, un à la fois. Sélectionnez le X à côté d'un nom affiché pour le supprimer de la liste des jours sélectionnés.
Dans le champ Heure de début, entrez l'heure UTC en heures et minutes dans le format 24 heures. Voir la note sur l'heure UTC ci-dessus.
Dans le champ Date de début, entrez la date de début dans le format MM/DD/YYYY, ou utilisez l'icône de calendrier pour sélectionner une date et une heure.
Pour définir la date de fin, sélectionnez le champ Date de fin et utilisez le calendrier pour entrer la date et l'heure de fin

Création d'un programme hebdomadaire

Sélectionnez le champ Intervalle pour afficher le menu.
Sélectionnez Hebdomadaire. La boîte de dialogue Hebdomadaire apparaît.
Dans le champ Répéter tous les, entrez la fréquence de répétition du programme. Par exemple, 1 = chaque semaine, 2 = toutes les deux semaines, 3 = toutes les trois semaines. Le nombre minimum de semaines est de 1. Le nombre maximal de semaines est de 99.
Dans le champ Jours de la semaine, sélectionnez les jours de la semaine auxquels le programme doit être exécuté. Vous pouvez sélectionner un ou plusieurs jours, un à la fois. Pour supprimer un jour, sélectionnez le X à côté du jour.
Dans le champ Date de début, utilisez le calendrier pour sélectionner la date et l'heure de début du programme.
Facultatif : Dans le champ Date de fin, utilisez le calendrier pour sélectionner la date et l'heure de fin du programme.

Création d'un programme mensuel

Sélectionnez le champ Intervalle pour afficher le menu.
Sélectionnez Mensuel. La boîte de dialogue Mensuel apparaît.
Dans le champ Répéter tous les, entrez la fréquence de répétition du programme. Par exemple, 1 = tous les mois, 2 = tous les deux mois, 3 = tous les trois mois. Le nombre minimum de mois est 1. Le nombre maximal de mois est de 99.
Dans le champ Jours du mois, sélectionnez le numéro du jour du mois pour lequel vous voulez que le programme s'exécute. Par exemple, 1 est le premier jour du mois, 17 est le dix-septième jour du mois. Vous pouvez sélectionner un ou plusieurs jours, un à la fois. Pour supprimer un jour, sélectionnez le X à côté du jour.
Dans le champ Heure de début, utilisez le calendrier pour sélectionner une date et une heure UTC au début du programme. Voir la note sur l'heure UTC ci-dessus.
Dans le champ Date de fin, utilisez le calendrier pour sélectionner la date et l'heure UTC auxquelles le programme se termine.

Utiliser une expression Cron

Vous pouvez utiliser une expression Cron pour définir la programmation. Pour utiliser la console, voir Utilisation des formulaires d'interface utilisateur pour plus d'informations sur l'utilisation des formulaires d'interface utilisateur pour définir la programmation.

Note

Vous ne pouvez pas créer un programme qui se déclenche à un intervalle de moins d'une heure. Seuls les intervalles d'une heure ou plus sont autorisés. Par exemple, vous pouvez créer un programme avec l'expression 0 * 15 * * pour exécuter le programme toutes les heures le 15e jour d'un mois. Vous ne pouvez pas définir un programme avec */15 * 15 * * qui serait toutes les 15 minutes le 15e jour d'un mois.

Toutefois, vous pouvez créer deux programmes de 1 heure pour la même opération sur les mêmes ressources qui démarrent à 30 minutes d'intervalle pour accomplir la même chose que l'exécution d'un programme toutes les 30 minutes. Bien que chaque programme fonctionne toutes les heures, il s'exécute toutes les 30 minutes, à tour de rôle.

Par exemple, vous pouvez créer un programme à exécuter toutes les heures avec une heure de début de 12:00 p.m. sur une liste d'instances, et un autre programme qui exécute HOURLY avec la même action et le même jeu d'instances, avec une heure de début de 12:30 p.m., L'action est effectivement effectuée toutes les 30 minutes, même si chaque programme a un intervalle horaire.

Dans la fenêtre Schedule, sélectionnez Cron pour afficher la fenêtre Cron.
Entrez une expression Cron valide pour définir l'intervalle de programmation, la date et l'heure de début, ainsi que la date et l'heure de fin. Par exemple : Exemples
```
30 13 * * mon-fri 
```
Cette expression signifie chaque semaine à 13h30 UTC chaque lundi, mardi, mercredi, jeudi et vendredi.
```
0 */2 15 * *
```
Cette expression définit la programmation pour qu'elle s'exécute toutes les 2 heures le 15e jour d'un mois.
Dans le champ Date de début, entrez manuellement la date de début ou utilisez le calendrier pour sélectionner une date.
Facultatif : Dans le champ Date de fin, entrez manuellement la date de fin ou utilisez le calendrier pour sélectionner une date.

Détails de l'expression Cron

Une expression cron est une chaîne de cinq champs, séparés chacun par un espace.

Entrez l'expression cron dans le format suivant, en utilisant les valeurs suivantes :

<minute> : 0 à 59
<heure> : 0 à 23
<jours du mois> : 1 à 31
<mois> : 1 à 12 (de janvier à décembre)
<jours de la semaine> : 1 à 7 (du lundi au dimanche)

Par exemple, pour exécuter le programme à 23:00 le 15e jour d'un mois, entrez cette expression : 0 23 15 * *

Un champ peut également contenir les caractères spéciaux suivants :

Caractères spéciaux
Personnage	Description
*	Astérisque : Représente n'importe quelle valeur.
,	Virgule : séparateur pour plus d'une valeur. Par exemple, pour <days of week>, 2,3 représente mardi et mercredi.
-	Tableau de bord : Intervalle de valeurs. Par exemple, pour <jours de la semaine>, 1 à 3 représente du lundi au mercredi.
/	Barre oblique : Valeurs d'étape. Par exemple, pour <heure>, */3 représente toutes les 3 heures.

Pour plus d'informations sur la création et le formatage des expressions Cron, voir Création d'un programme d'expressions Cron.

Important

Le programmateur de ressources ne prend pas en charge l'intervalle de 30 minutes affiché sur cette page. L'intervalle minimal du programmateur de ressources est d'une heure.

Consultation d'un échéancier

La révision et la modification d'un échéancier ou la création d'un nouvel échéancier à partir d'un échéancier existant constituent la dernière étape du processus de création d'un échéancier.

Important

Pour gérer les programmes du programmateur de ressources, vous devez être autorisé à y accéder et à les modifier. Pour plus d'informations, voir Authentification et autorisation, Politiques du programmateur de ressources et Exemples de politiques.

Après avoir terminé les principales étapes (De base, Ressources et Programme) pour créer un programme, sélectionnez Vérifier. La fenêtre Réviser comprend une section distincte pour chaque étape majeure afin de créer un programme. Chaque section affiche toutes les données que vous avez entrées ou sélectionnées dans cette partie du traitement pour créer un échéancier.
Vérifiez et modifiez les informations de chaque section, au besoin.
Lorsque vous avez terminé, la fenêtre se ferme et revient à la liste des programmes. Pendant que le programmateur de ressources crée le programme, le statut de la demande de travail indique Création. Lorsque la demande de travail est terminée, le statut indique Réussite. Si les informations du programme nouveau ou mis à jour ne sont pas valides, le planificateur de ressources retourne l'erreur 400 (demande incorrecte, entrée non valide). La demande de mise à jour échoue et aucune modification n'est appliquée à la programmation.

Utilisez la commande Créer une interface de ligne de commande de programmation du programmateur de ressources et les paramètres requis pour créer une programmation.
```
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
```
Pour obtenir la liste complète des paramètres et des valeurs pour toutes les commandes de l'interface de ligne de commande du programmateur de ressources, voir Interface de ligne de commande du programmateur de ressources.

Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface de ligne de commande.
Utilisez l'API du programmateur de ressources CreateSchedule pour créer une programmation.
Pour obtenir la liste complète des API du programmateur de ressources, voir API du programmateur de ressources.

Documentation sur Oracle Cloud Infrastructure