Demandes de travail

Cette rubrique décrit la fonctionnalité de demandes de travail documentée dans l'API des demandes de travail. Les services Oracle Cloud Infrastructure suivants sont intégrés à cette API :

Remarque

Certains services Oracle Cloud Infrastructure proposent des demandes de travail prises en charge par l'API de service plutôt que par l'API des demandes de travail abordée dans cette rubrique. Pour plus d'informations sur les demandes de travail dans ces services, reportez-vous aux rubriques suivantes :

Les demandes de travail permettent de surveiller les opérations à longue durée d'exécution, comme les sauvegardes Database ou le provisionnement des instances Compute. Lorsque vous lancez une opération de ce type, le service génère une demande de travail de façon dynamique. Une demande de travail est un journal d'activités qui permet de suivre chaque étape de la progression de l'opération. Chaque demande de travail dispose d'un OCID qui vous permet d'interagir avec elle par programmation et de l'utiliser à des fins d'automatisation.

En cas d'échec d'une opération, une demande de travail peut vous aider à déterminer l'étape du processus qui comportait une erreur.

Certaines opérations ont une incidence sur plusieurs ressources. Par exemple, la création d'un pool d'instances a également un impact sur les instances et les configurations d'instance. Une demande de travail fournit la liste des ressources impactées par une opération.

Pour les workflows qui nécessitent des opérations séquentielles, vous pouvez surveiller la demande de travail de chaque opération et vérifier que l'opération est terminée avant de passer à la suivante. Par exemple, supposons que vous voulez créer un pool d'instances avec le redimensionnement automatique activé. Pour ce faire, vous devez d'abord créer le pool d'instances, puis configurer le redimensionnement automatique. Vous pouvez surveiller la demande de travail de la création du pool d'instances afin de déterminer le moment où ce workflow est terminé, puis configurer le redimensionnement automatique une fois cette opération terminée.

Les demandes de travail sont conservées pendant 12 heures.

Stratégie IAM requise

Pour utiliser Oracle Cloud Infrastructure, un administrateur doit vous accorder un accès sécurisé dans une stratégie. Cet accès est obligatoire que vous utilisiez la console ou l'API REST avec un kit SDK, une CLI ou un autre outil. Si vous recevez un message indiquant que vous n'avez pas d'autorisation ou que vous n'êtes pas autorisé, vérifiez auprès de l'administrateur quel type d'accès vous disposez et dans quel compartiment vous devriez travailler.

Pour les administrateurs : les demandes de travail héritent des droits d'accès de l'opération qui génère la demande de travail de façon dynamique. Afin de permettre aux utilisateurs de visualiser les demandes de travail, les journaux et les messages d'erreur d'une opération, écrivez une stratégie qui les autorise à effectuer cette opération. Par exemple, pour que les utilisateurs puissent consulter les demandes de travail associées au lancement d'instances, écrivez une stratégie qui leur permet de lancer des instances.

Pour permettre aux utilisateurs de répertorier toutes les demandes de travail dans une location, utilisez la stratégie suivante :

Allow group SupportTeam to inspect work-requests in tenancy

Si vous ne connaissez pas les stratégies, reportez-vous à Introduction aux stratégies et à Stratégies courantes.

Etats des demandes de travail

Remarque : les demandes de travail de certains services ou de certaines opérations peuvent ne prendre en charge qu'un sous-ensemble des statuts suivants.

ACCEPTED
La demande se trouve dans la file d'attente des demandes de travail à traiter.
IN_PROGRESS
Il existe un enregistrement de demande de travail pour la demande spécifiée, mais aucun enregistrement WORK_COMPLETED n'est associé.
SUCCEEDED
Il existe un enregistrement de demande de travail pour cette demande et un enregistrement WORK_COMPLETED associé présente l'état SUCCEEDED.
FAILED
Il existe un enregistrement de demande de travail pour cette demande et un enregistrement WORK_COMPLETED associé présente l'état FAILED.
CANCELING
La demande de travail est en cours d'annulation.
CANCELED
La demande de travail a été annulée.

Utilisation de la console pour visualiser les demandes de travail

Les étapes permettant de consulter une demande de travail sont similaires pour les services Oracle Cloud Infrastructure qui prennent en charge les demandes de travail.

  1. Accédez à la ressource dont vous souhaitez visualiser les demandes de travail.

    Par exemple, pour afficher les demandes de travail d'une instance Compute, ouvrez le menu de navigation. Sous Infrastructure de base, accédez à Compute et cliquez sur Instances.

  2. Si la ressource est affichée dans une vue de liste, cliquez sur son nom pour afficher ses détails.
  3. Sous Ressources, cliquez sur Demandes de travail. Le statut de toutes les demandes de travail apparaît sur la page.
  4. Pour consulter les messages de journal, les messages d'erreur et les ressources associés à une demande de travail spécifique, cliquez sur le nom de l'opération. Ensuite, sélectionnez une option dans la section Plus d'informations.

    Pour les ressources associées, vous pouvez cliquer sur l'icône Actions (trois points) en regard d'une ressource afin de copier son OCID.