Lire un planning

Lire une planification dans votre instance PagerDuty.

Entrée

Champ Définition Type Obligatoire

Planifier

ID du planning

Identificateur unique de la planification qui sera lue.

Texte TRUE

Depuis

Début de la plage de dates pour la recherche dans la planification.

Par exemple, 2015-11-10T08:00:00-05:00.

Date et heure FALSE

Fuseau horaire

Fuseau horaire du planning. La valeur par défaut est UTC.

Texte FALSE

Jusqu'à

Fin de la plage de dates pour la recherche dans la planification.

Par exemple, 2015-11-10T17:00:00-05:00.

Date et heure FALSE

Sortie

Champ Définition Type

ID du planning

Identificateur unique de la planification qui sera mise à jour.

Texte

Nom

Nom de la couche de planification.

Texte

Résumé

Un bref résumé de la planification. Peut être identique à Nom, mais n'est pas destiné à être un identifiant.

Texte

Description

Une description de l'objectif de la planification.

Texte

Type

Type de données renvoyées. Texte

Fuseau horaire

Fuseau horaire de la planification.

Texte

URL HTML

URL à laquelle l'entité est affichée de manière unique dans l'application Web PagerDuty.

Texte

Couches de planification

Liste des couches de planification. Un planning doit inclure au moins une couche de planning.

Objet

Nom

Nom d'une couche de planification.

Texte

Commencer

Heure de début de cette couche.

Date et heure

Terminer

Heure de fin de cette couche. Si la valeur est nulle, la couche ne se termine pas.

Date et heure

Utilisateurs

Liste d'objets utilisateur.

Liste d'objets

ID utilisateur

Identificateur unique de l'utilisateur. Texte

Résumé

Un bref résumé de l'objet utilisateur. Peut être identique à Nom, mais n'est pas destiné à être un identifiant.

Texte

Type

Une chaîne qui détermine le schéma de l'objet. Il doit s'agir du nom standard de l'entité, suivi du suffixe _reference si l'objet est une référence.

Texte

URL HTML

URL à laquelle l'entité est affichée de manière unique dans l'application Web PagerDuty.

Texte

Restrictions

Liste de restrictions pour une couche de planification. Une restriction désigne une limite concernant les moments de la journée ou de la semaine au cours desquels la couche de planning peut accepter des affectations..

Liste d'objets

Type

Type de restriction défini.

Texte

Durée en secondes

Durée de la restriction en secondes.

Nombre

Heure de début du jour

Heure de début au format HH:mm:ss.

Texte

Jour de début de la semaine

Obligatoire uniquement en cas d'utilisation avec un type de restriction weekly_restriction. Le premier jour de l'horaire de rotation hebdomadaire au format ISO 8601 (le 1 correspond au lundi, et ainsi de suite).

Nombre

Début virtuel de la rotation

Heure de démarrage effectif de la couche. Cette option peut être antérieure à l'heure de début de la planification.

Date et heure

Durée du tour de rotation en secondes

Durée de chaque astreinte, en secondes.

Nombre

Entrées de planification générées

Liste des entrées sur la couche calculée pour la plage horaire actuelle. Pour que ce champ soit rempli, les champs Depuis ou Jusqu'à doivent être renseignés.

Liste d'objets

Utilisateur (objet)

ID utilisateur

Identificateur d'utilisateur unique d'un objet utilisateur.

Texte

Résumé

Un bref résumé de l'objet utilisateur. Peut être identique à Nom, mais n'est pas destiné à être un identifiant.

Texte

Type

Une chaîne qui détermine le schéma de l'objet. Il doit s'agir du nom standard de l'entité, suivi du suffixe _reference si l'objet est une référence.

Texte

URL HTML

URL à laquelle l'entité est affichée de manière unique dans l'application Web PagerDuty.

Texte

Début

Heure de début de cette entrée.

Date et heure

Fin

Heure de fin de cette entrée. Si la valeur est nulle, l'entrée ne se termine pas.

Date et heure

Pourcentage de couverture rendu

Pourcentage de la plage horaire couverte par cette couche. Renvoie la valeur nulle sauf si Depuis ou Jusqu'à sont définis.

Nombre

Planification finale (objet)

Nom

Nom de la planification secondaire.

Texte

Entrées de planification générées

Liste des entrées sur la couche calculée pour la plage horaire actuelle. Pour que ce champ soit rempli, les champs Depuis ou Jusqu'à doivent être renseignés.

Liste d'objets

Utilisateur (objet)

ID utilisateur

Identificateur d'utilisateur unique d'un objet utilisateur.

Texte

Résumé

Un bref résumé de l'objet utilisateur. Peut être identique à Nom, mais n'est pas destiné à être un identifiant.

Texte

Type

Une chaîne qui détermine le schéma de l'objet. Il doit s'agir du nom standard de l'entité, suivi du suffixe _reference si l'objet est une référence.

Texte

URL HTML

URL à laquelle l'entité est affichée de manière unique dans l'application Web PagerDuty.

Texte

Début

Heure de début de cette entrée.

Date et heure

Fin

Heure de fin de cette entrée. Si la valeur est nulle, l'entrée ne se termine pas.

Date et heure

Pourcentage de couverture rendu

Pourcentage de la plage horaire couverte par cette couche. Renvoie la valeur nulle sauf si Depuis ou Jusqu'à sont définis.

Nombre

Remplace la planification secondaire (objet)

Nom

Nom de la planification secondaire

Texte

Entrées de planification générées

Liste des entrées sur la couche calculée pour la plage horaire actuelle. Pour que ce champ soit rempli, les champs Depuis ou Jusqu'à doivent être renseignés.

Liste d'objets

Utilisateur (objet)

ID utilisateur

Identificateur d'utilisateur unique d'un objet utilisateur.

Texte

Résumé

Un bref résumé de l'objet utilisateur. Peut être identique à Nom, mais n'est pas destiné à être un identifiant.

Texte

Type

Une chaîne qui détermine le schéma de l'objet. Il doit s'agir du nom standard de l'entité, suivi du suffixe _reference si l'objet est une référence.

Texte

URL HTML

URL à laquelle l'entité est affichée de manière unique dans l'application Web PagerDuty.

Texte

Début

Heure de début de cette entrée.

Date et heure

Fin

Heure de fin de cette entrée. Si la valeur est nulle, l'entrée ne se termine pas.

Date et heure

Pourcentage de couverture rendu

Pourcentage de la plage horaire couverte par cette couche. Renvoie la valeur nulle sauf si Depuis ou Jusqu'à sont définis.

Nombre

Politiques de remontée (liste d'objets)

ID de politique de remontée

Identifiant utilisateur unique de la politique de réaffectation.

Texte

Résumé

Un bref résumé pour l'objet de la politique de réaffectation. Peut être identique à Nom, mais n'est pas destiné à être un identifiant.

Texte

Type

Une chaîne qui détermine le schéma de l'objet. Il doit s'agir du nom standard de l'entité, suivi du suffixe _reference si l'objet est une référence.

Texte

URL HTML

URL à laquelle l'entité est affichée de manière unique dans l'application Web PagerDuty.

Texte

Utilisateurs (liste d'objets)

ID utilisateur

Identificateur d'utilisateur unique d'un objet utilisateur.

Texte

Résumé

Un bref résumé de l'objet utilisateur. Peut être identique à Nom, mais n'est pas destiné à être un identifiant.

Texte

Type

Une chaîne qui détermine le schéma de l'objet. Il doit s'agir du nom standard de l'entité, suivi du suffixe _reference si l'objet est une référence.

Texte

URL HTML

URL à laquelle l'entité est affichée de manière unique dans l'application Web PagerDuty.

Texte

Équipe (liste d'objets)

ID d'équipe

Identifiant utilisateur unique d'un objet d'équipe.

Texte

Résumé

Un bref résumé pour l'objet de l'équipe. Peut être identique à Nom, mais n'est pas destiné à être un identifiant.

Texte

Type

Une chaîne qui détermine le schéma de l'objet. Il doit s'agir du nom standard de l'entité, suivi du suffixe _reference si l'objet est une référence.

Texte

URL HTML

URL à laquelle l'entité est affichée de manière unique dans l'application Web PagerDuty.

Texte