Freigeben über


Aktualisieren von accessReviewScheduleDefinition

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Aktualisieren Sie ein vorhandenes accessReviewScheduleDefinition-Objekt , um eine oder mehrere seiner Eigenschaften zu ändern.

Hinweis

Alle An einer accessReviewScheduleDefinition vorgenommenen Updates gelten nur für zukünftige Instanzen. Derzeit ausgeführte Instanzen können nicht aktualisiert werden. Darüber hinaus ist diese API nicht zum Aktualisieren von Eigenschaften, einschließlich Entscheidungen, auf der AccessReviewInstance-Ebene vorgesehen. Weitere Informationen zu -Instanzen finden Sie unter accessReviewInstance .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) AccessReview.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung AccessReview.ReadWrite.All Nicht verfügbar.

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.

  • So schreiben Sie Zugriffsüberprüfungen für eine Gruppe oder App: Benutzeradministrator, Identity Governance-Administrator
  • So schreiben Sie Zugriffsüberprüfungen für eine Microsoft Entra Rolle: Identity Governance-Administrator, Administrator für privilegierte Rollen

HTTP-Anforderung

PUT /identityGovernance/accessReviews/definitions/{review-id}

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung eines accessReviewScheduleDefinition-Objekts an.

Die folgende Tabelle zeigt die Eigenschaften, die zum Aktualisieren einer accessReviewScheduleDefinition akzeptiert werden.

Eigenschaft Typ Beschreibung
descriptionForAdmins String Kontext der Überprüfung, die Administratoren zur Verfügung gestellt wird.
descriptionForReviewers String Kontext der Überprüfung, die den Prüfern zur Verfügung gestellt wird.
displayName String Name der Zugriffsüberprüfungsreihe.
fallbackReviewers accessReviewReviewerScope-Sammlung Eine Sammlung von Prüferbereichen, die verwendet werden, um die Liste der Fallbackprüfer zu definieren, die benachrichtigt werden, maßnahmen zu ergreifen, wenn in der angegebenen Liste der Prüfer keine Benutzer gefunden werden. Dies kann auftreten, wenn entweder der Gruppenbesitzer als Prüfer angegeben wird, der Gruppenbesitzer aber nicht vorhanden ist, oder wenn der Vorgesetzte eines Benutzers als Prüfer angegeben wird, der Vorgesetzte eines Benutzers jedoch nicht vorhanden ist.
rezensenten accessReviewReviewerScope-Sammlung Definiert, wer die Prüfer sind. Wenn keines angegeben ist, handelt es sich bei der Überprüfung um eine Selbstüberprüfung (Benutzer überprüfen ihren eigenen Zugriff). Die Reviewers-Eigenschaft ist nur aktualisierbar, wenn einzelne Benutzer als Prüfer zugewiesen sind. Weitere Informationen finden Sie unter accessReviewReviewerScope.
stageSettings accessReviewStageSettings-Auflistung Definiert, wie viele Phasen jede instance einer Zugriffsüberprüfungsreihe haben wird. Phasen werden sequenziell basierend auf der dependsOn-Eigenschaft erstellt. Jede Phase kann einen anderen Satz von Prüfern, Fallbackprüfern und Einstellungen aufweisen. Nur Prüfer und Fallbackprüfer sind aktualisierbar. Weitere Informationen finden Sie unter accessReviewStageSettings. Optional.
settings accessReviewScheduleSettings Die Einstellungen für eine Zugriffsüberprüfungsreihe. Weitere Informationen finden Sie unter accessReviewScheduleSettings.
backupReviewers (veraltet) accessReviewReviewerScope-Sammlung Diese Eigenschaft wurde durch fallbackReviewers ersetzt. Wenn Sie jedoch entweder backupReviewers oder fallbackReviewers angeben, werden die gleichen Werte automatisch für die andere Eigenschaft aufgefüllt.

Eine PUT-Anforderung erwartet, dass das vollständige Objekt übergeben wird, das alle beschreibbaren Eigenschaften enthält, nicht nur die Eigenschaften, die aktualisiert werden.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 204 No Content Antwortcode und keinen Antworttext zurück.

Beispiele

Dies ist ein Beispiel für die Aktualisierung des displayName einer vorhandenen Zugriffsüberprüfungsreihe.

Anforderung

Geben Sie im Anforderungstext eine JSON-Darstellung der neuen Eigenschaften des accessReviewScheduleDefinition-Objekts an.

PUT https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions/60860cdd-fb4d-4054-91ba-f75e04444aa6
Content-type: application/json

{
  "id": "60860cdd-fb4d-4054-91ba-f75e04444aa6",
  "displayName": "Test world UPDATED NAME!",
  "descriptionForAdmins": "Test world",
  "descriptionForReviewers": "Test world",
  "scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/groups/b7a059cb-038a-4802-8fc9-b9d1ed0cf11f/transitiveMembers",
    "queryType": "MicrosoftGraph"
  },
  "instanceEnumerationScope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/groups/b7a059cb-038a-4802-8fc9-b9d1ed0cf11f",
    "queryType": "MicrosoftGraph"
  },
  "reviewers": [],
  "settings": {
    "mailNotificationsEnabled": true,
    "reminderNotificationsEnabled": true,
    "justificationRequiredOnApproval": true,
    "defaultDecisionEnabled": false,
    "defaultDecision": "None",
    "instanceDurationInDays": 3,
    "autoApplyDecisionsEnabled": false,
    "recommendationsEnabled": true,
    "recurrence": {
      "pattern": {
        "type": "weekly",
        "interval": 1
      },
      "range": {
        "type": "noEnd",
        "startDate": "2020-09-15"
      }
    }
  }
}

Antwort

HTTP/1.1 204 No Content