Met à jour la configuration de la campagne pour une configuration de campagne spécifiée du locataire spécifique.

L'API est utilisée pour mettre à jour la configuration de campagne d'un locataire spécifique.
L'administrateur qui gère un locataire spécifique peut mettre à jour une configuration de campagne créée pour ce locataire.
Les propriétaires de l'application peuvent mettre à jour une configuration de campagne qu'ils ont créée ou qui comprend au moins une application dont ils sont propriétaires.
Entitlements requis : tenantadmin [Administrateur du locataire].

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

ID de configuration de la campagne

Body Params

Détails de la charge utile de la demande de mise à jour de la configuration de la campagne:

- owner : informations sur le propriétaire de la campagne.
- type : type de campagne (par exemple, attribution d'utilisateur, attribution de groupe, compte, appartenance à un groupe).
- priority : Priorité de la campagne (par exemple, élevée, moyenne, faible).
- name : Nom de la campagne.
- description : Description de la campagne.
- reviewer : Informations sur le réviseur de la campagne.
- applications : Remarque : ce champ est obligatoire pour les campagnes relatives aux droits des groupes et aux comptes; toutefois, dans le cas des campagnes relatives aux droits des utilisateurs, il convient d'indiquer soit "Applications", soit "Droits", soit les deux. Ceci n'est pas nécessaire pour l'appartenance à un groupe.
- userFilter: Il sert à filtrer la liste des utilisateurs ou des groupes inclus ou exclus pour la certification.


Dans le cas d'une campagne sur les droits des utilisateurs, vous pouvez spécifier userConditionSet ou userInclusionList ou userExclusionList dans userFilter.

- entitlementFilter: Il sert à filtrer la liste des droits inclus ou exclus pour la certification.


Vous pouvez spécifier entitlementInclusionList ou entitlementExclusionList dans entitlementFilter.
- launchDate: Date à laquelle la première instance de la campagne démarre.
- creationDate: Date de création de la configuration de la campagne.
- duration : La durée (en millisecondes) pendant laquelle chaque instance de campagne reste ouverte.
- fréquence : Fréquence de l'instance de campagne.
- runNow: Indicateur pour démarrer la campagne immédiatement.
- nextRunDate: Date d'exécution prévue pour la prochaine instance de campagne.
- overdueAction: Action pour les enregistrements ouverts lorsqu'une campagne se termine.
- mitigationAction: Action après la clôture d'une campagne pour éviter les enregistrements ouverts.
- defaultReviewer: Réviseur par défaut pour les affectations sans réviseur approprié.
- < string >preview : Un drapeau indiquant que la campagne est en mode aperçu et qu'elle n'est pas ouverte aux réviseurs.
- continuous : Un drapeau indiquant que la campagne est continue. La valeur par défaut pour continuous est false.
- continuousCampaignMetaData: Détails sur continuous campaign.
  generateInitialDataSet: Indicateur permettant de spécifier s’il faut charger l’ensemble de données initial lors de la création d’une campagne continue.
  La valeur par défaut est 'false'
  reminderAction: Action permettant d’envoyer des rappels périodiques aux réviseurs concernant les missions non révisées.
  La valeur par défaut est { type = none, reminderInterval=0 }.
  Les valeurs autorisées pour type dans reminderAction sont : none, reminder.
  'reminderInterval' correspond au nombre de jours après l’envoi de rappels périodiques aux relecteurs.
  La valeur par défaut de reminderInterval est 10 (en jours) lorsque type est reminder
  overdueThreshold: Nombre de jours après lesquels l’action par défaut est déclenchée sur les droits non examinés.
  La valeur par défaut est '30'
  overdueAction: Action par défaut sur les droits non examinés après l’expiration d’une période spécifique.
  Les valeurs autorisées sont rejectAll, approveAll ou doNothing.
  La valeur par défaut overdueAction est 'doNothing'
  automaticRefresh: Un indicateur précisant que la campagne doit actualiser le filtre existant pour la création du jeu de données.
  Ce champ s’applique uniquement à la campagne de compte continu.
  La valeur par défaut est true
  événements : Liste des événements devant être surveillés via campaign.
  example:
    "continuousCampaignMetaData": {
       "generateInitialDataSet": false,
       "reminderAction": "reminderAction": { "type": "reminder", "reminderInterval": 10 } ,
       "overdueThreshold": 30,
        "overdueAction": "rejectAll",
       "events": [
           {
                  "type":"CHANGE_USER_PROFILE",
                  "monitoredAttributes": [
                          {"id":"12","name":"departmentNumber"},
                           {"id":"30","name":"gtwayManager"}
                  ]
          }
       ]
    }
  continuousCampaignMetaData doit être ajouté lorsque continuous est vrai.
- signOff: La politique de validation des campagnes fait référence à l’approche prédéfinie qui régit quand et comment les actions de campagne sont officiellement approuvées ou refusées (auto, manual, eoc, no_signoff).

Les valeurs autorisées pour signOff sont auto, manual, eoc ou no_signoff.
auto : ce paramètre implique une validation immédiate. Les actions prises par l'approbateur en termes d'approbation ou de rejet sont appliquées immédiatement à l'affectation).
manuel : Le paramètre signifie une approbation manuelle. Le certificateur peut décider lui-même s'il veut appliquer son action immédiatement OU à la fin de la campagne).
eoc : La configuration signifierait une signature vers la fin de la campagne. Les actions effectuées par le responsable de validation (approbation ou rejet) sont conservées jusqu'à la date d'échéance de la campagne, puis mises en œuvre simultanément.
no_signoff : les actions ne sont pas exécutées et servent uniquement à des fins de reporting.


- supervisors : liste des superviseurs désignés pour la campagne.
- allowSupervisorEscalation: Autorise la remontée vers les superviseurs.
- reviewerOverwritten: Indicateur précisant si le réviseur a été remplacé manuellement.

Objet représentant une configuration de campagne.

owner
object
string
required

Type de campagne. Valeurs autorisées : userassignment, groupassignment, account, groupmembership, all.

string
required

Priorité de la campagne. Valeurs autorisées : high, medium, low, all.

string
required

Nom de campagne

string

Description de la campagne

reviewer
object
applications
array of objects
required

La liste des applications certifiées par la campagne.

applications*
userFilter
object

Liste des utilisateurs ou des groupes à inclure ou à exclure ou filtre pour les utilisateurs autorisés à la certification

entitlementFilter
object

Représentation du repos pour un filtre d'ensemble de conditions de droits ou de droits.

date-time

La date de début de la première instance de la campagne. Formats acceptés : date-heure au format ISO 8601, par exemple '2025-08-04T12:30:00', ou heure de l'époque sous la forme d'un nombre entier de type string, par exemple 1754290800000.

int64

Durée (en millisecondes) pendant laquelle chaque instance de campagne reste ouverte.

frequency
object

Une adresse string compatible avec UNIX ou Linux Cron qui définit le début des instances suivantes

boolean

Le drapeau indiquant que la campagne est ponctuelle et qu'elle doit être lancée immédiatement.

date-time

Date prévue pour la prochaine instance de campagne. Formats acceptés : date-heure au format ISO 8601, par exemple '2025-08-04T12:30:00', ou heure de l'époque sous la forme d'un nombre entier de type string, par exemple 1754290800000

string

Les mesures à prendre pour les dossiers ouverts lors de la clôture d'une campagne. Valeurs autorisées : 'rejectAll', 'approveAll', 'doNothing'

mitigationAction
object

L'action à entreprendre après un certain temps pour éviter les dossiers ouverts lors de la clôture d'une campagne. Valeurs autorisées : none, reminder.

defaultReviewer
object
boolean

Drapeau indiquant que la campagne est en mode aperçu et qu'elle n'est pas ouverte aux évaluateurs.

boolean

Un drapeau indiquant que la campagne est continue.

continuousCampaignMetaData
object

Détails de la campagne continue.

string

La politique d'approbation de la campagne. Valeurs autorisées : auto, manual, eoc, no_signoff.

supervisors
array of objects

La liste des superviseurs identifiés pour la campagne.

supervisors
boolean

Permettre l'escalade vers les superviseurs.

string

L'identificateur du réviseur pour la campagne.

boolean
Headers
boolean
enum
required

Si la valeur est fixée à true, l'appel à l'API est traité comme un appel à l'API d'administration.

Allowed:
Responses
200

L'opération a abouti.

400

Une erreur d'état côté client s'est produite. Le code d'erreur et la description sont disponibles dans les données utiles de la réponse.

401

Une erreur d'état côté client s'est produite. Le code d'erreur et la description sont disponibles dans les données utiles de la réponse.

409

Un conflit s'est produit lors de l'opération de remplacement.

500

Votre opération ne peut être traitée car une erreur interne du serveur s'est produite.

Language
URL
LoadingLoading…