Aktualisieren von accessReviewScheduleDefinition

Namespace: microsoft.graph

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.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. 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.

HTTP-Anforderung

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

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die 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.
Bewertungen 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.
settings accessReviewScheduleSettings Die Einstellungen für eine Zugriffsüberprüfungsreihe. Weitere Informationen finden Sie unter accessReviewScheduleSettings.

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/v1.0/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