Obsolète - Modifier la configuration d'une campagne spécifique.

L'api permettant de modifier la configuration d'une campagne spécifique v1.0 ( v1.0/admin/campaigns/{id }) est obsolète. La fin de vie est 31-Dec-2025. Utilisez l'API alternative suivante : PUT /v2.0/campaigns/{id }
La demande d'API n'est valable que pour les ressources créées à l'aide de la version V1. Lorsqu'une ressource V1 est modifiée à l'aide de l'API V2, elle sera alignée comme une ressource V2. Toute tentative d'accès aux ressources V2-exclusive avec l'API V1 se soldera par une erreur 400.
Modifier la configuration d'une campagne spécifique. Si elle est appelée par le propriétaire d'une application, l'API ne peut modifier que les campagnes que le propriétaire a créées ou que les applications associées sont toutes détenues par le propriétaire.
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 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).
- 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 : Liste des applications certifiées par la campagne.
Note : Il s'agit d'un champ obligatoire; toutefois, dans le cas des campagnes sur les droits des utilisateurs, il convient de spécifier soit "Applications", soit "Droits", soit les deux.
- allowlist : Liste des utilisateurs ou des groupes autorisés pour la certification. Vous ne pouvez pas spécifier la liste de blocage avec la liste d'autorisation dans la portée Utilisateur/Groupe.
- blocklist : Liste des utilisateurs ou des groupes exclus de la certification. Vous ne pouvez pas spécifier la liste d'autorisation avec la liste de blocage dans la portée Utilisateur/Groupe.
- entitlementFilter: Elle est définie pour 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.
- runEvery: Unité de fréquence pour l'instance de campagne (jours ou mois).
- 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 dossiers ouverts lors de la clôture d'une campagne.
- mitigationAction: Action après la clôture d'une campagne pour éviter les dossiers 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.
- automaticRefreshContinuousCampaign:A drapeau, valable uniquement pour les campagnes continues, indiquant que la campagne doit rafraîchir le filtre existant pour la construction de l'ensemble de données.
- signOff: La politique d'approbation de la campagne fait référence à l'approche prédéterminée qui régit quand et comment les actions de la campagne sont officiellement approuvées ou refusées (auto, manuel, eoc, no_signoff).


Les valeurs autorisées pour signOff sont auto, manuel, eoc ou no_signoff.
auto : le paramètre signifierait une approbation 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 prises par l'approbateur en termes d'approbation ou de rejet sont conservées jusqu'à la date d'échéance de la campagne et sont ensuite déployées ensemble).
no_signoff : Les actions ne sont pas exécutées et ne sont utilisées que pour les rapports.


- superviseurs : Liste des superviseurs identifiés pour la campagne.
- allowSupervisorEscalation: Autoriser l'escalade vers les superviseurs.
- id : ID de la configuration de la campagne.
- rev : Révision de la configuration de la campagne.
- reviewerOverwritten: Drapeau indiquant si le réviseur est écrasé manuellement.

Objet utilisé pour créer une nouvelle configuration de campagne

owner
object

Représente un groupe d'utilisateurs

string
required

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

string
required

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

string
required

Nom de campagne

string

Description de la campagne

reviewer
object

Représente un groupe d'utilisateurs

applications
array of objects
required

Liste des candidatures certifiées par la campagne

applications*
allowlist
array of objects

Liste des utilisateurs ou groupes autorisés pour la certification

allowlist
blocklist
array of objects

Liste des utilisateurs ou des groupes dont l'accès à la certification est refusé

blocklist
entitlementFilter
object

Liste des droits à inclure/exclure ou filtre des droits autorisés pour la certification

string
required

Date de début de la première édition 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.

string

Date de création de la configuration 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
required

La durée (en millisecondes) pendant laquelle chaque instance de campagne reste ouverte

string

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

runEvery
object

Unité de fréquence : MINUTES, JOURS ou MOIS

boolean

Un drapeau pour démarrer immédiatement la campagne

string

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. Autorisé values:'rejectAll', 'approveAll', 'doNothing'

mitigationAction
object

Mesure à prendre après un certain temps pour éviter que les enregistrements ne soient rouverts à la clôture d'une campagne. Valeurs autorisées : none, reminder.

defaultReviewer
object

Représente un groupe d'utilisateurs

boolean

Un drapeau pour une campagne de prévisualisation, qui n'est pas ouverte aux évaluateurs

boolean

Un drapeau indiquant que la campagne est continue.

boolean

Indicateur, valable uniquement pour les campagnes continues, indiquant que la campagne doit actualiser le filtre existant pour l'ensemble de données de construction

string

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

supervisors
array of objects

La liste des superviseurs identifiés pour la campagne.

supervisors
boolean

Permettre l'escalade vers les superviseurs.

boolean
whitelist
array of objects
whitelist
blacklist
array of objects
blacklist
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 la charge utile.

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…