accessReviewHistoryDefinition-Ressourcentyp

Artikel
09/22/2023

Namespace: microsoft.graph

Stellt eine Sammlung von Verlaufsdaten zur Zugriffsüberprüfung und den Bereichen dar, die zum Sammeln dieser Daten verwendet werden.

Eine accessReviewHistoryDefinition enthält eine Liste von accessReviewHistoryInstance-Objekten . Jede Wiederholung der Verlaufsdefinition erstellt eine instance. Bei einer einmaligen Verlaufsdefinition wird nur eine instance erstellt.

Methoden

Methode	Rückgabetyp	Beschreibung
accessReviewHistoryDefinitions auflisten	accessReviewHistoryDefinition-Auflistung	Rufen Sie eine Liste der accessReviewHistoryDefinition-Objekte und deren Eigenschaften ab.
Erstellen von accessReviewHistoryDefinition	accessReviewHistoryDefinition	Erstellen Sie ein neues accessReviewHistoryDefinition-Objekt .
Get accessReviewHistoryDefinition	accessReviewHistoryDefinition	Lesen der Eigenschaften und Beziehungen eines accessReviewHistoryDefinition-Objekts .

Eigenschaften

Eigenschaft	Typ	Beschreibung
createdBy	userIdentity	Benutzer, der diese Überprüfungsverlaufsdefinition erstellt hat.
createdDateTime	DateTimeOffset	Zeitstempel beim Erstellen der Zugriffsüberprüfungsdefinition.
Entscheidungen	String collection	Bestimmt, welche Überprüfungsentscheidungen in die abgerufenen Überprüfungsverlaufsdaten einbezogen werden, sofern angegeben. Optional beim Erstellen. Alle Entscheidungen sind standardmäßig enthalten, wenn beim Erstellen keine Entscheidungen angegeben werden. Mögliche Werte sind: `approve`, `deny`, `dontKnow`, `notReviewed`und `notNotified`.
displayName	String	Name für die Datensammlung des Zugriffsüberprüfungsverlaufs. Erforderlich.
id	String	Der zugewiesene eindeutige Bezeichner einer Zugriffsüberprüfungsverlaufsdefinition.
reviewHistoryPeriodEndDateTime	DateTimeOffset	Ein Zeitstempel. Überprüfungen, die am oder vor diesem Datum enden, werden in die abgerufenen Verlaufsdaten aufgenommen. Nur erforderlich, wenn scheduleSettings nicht definiert ist.
reviewHistoryPeriodStartDateTime	DateTimeOffset	Ein Zeitstempel. Überprüfungen, die am oder vor diesem Datum beginnen, werden in die abgerufenen Verlaufsdaten aufgenommen. Nur erforderlich, wenn scheduleSettings nicht definiert ist.
scheduleSettings	accessReviewHistoryScheduleSettings	Die Einstellungen für eine Definitionsreihe mit dem Verlauf der wiederkehrenden Zugriffsüberprüfung. Nur erforderlich, wenn reviewHistoryPeriodStartDateTime oder reviewHistoryPeriodEndDateTime nicht definiert sind. Wird noch nicht unterstützt.
Bereiche	accessReviewScope-Sammlung	Wird verwendet, um einzugrenzen, welche Überprüfungen in den abgerufenen Verlaufsdaten enthalten sind. Ruft Überprüfungen ab, deren Bereich mit diesem bereitgestellten Bereich übereinstimmt. Erforderlich.
status	accessReviewHistoryStatus	Stellt die status der Datensammlung des Überprüfungsverlaufs dar. Mögliche Werte sind: `done`, `inProgress`, `error`, `requested`, `unknownFutureValue`.

Beziehungen

Beziehung	Typ	Beschreibung
instances	accessReviewHistoryInstance-Auflistung	Wenn accessReviewHistoryDefinition eine wiederkehrende Definition ist, stellen Instanzen jede Wiederholung dar. Eine Definition, die nicht wiederholt wird, weist genau eine instance auf.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.accessReviewHistoryDefinition",
  "createdBy": {
    "@odata.type": "microsoft.graph.userIdentity"
  },
  "createdDateTime": "String (timestamp)",
  "decisions": [
    "String"
  ],
  "displayName": "String",
  "id": "String (identifier)",
  "reviewHistoryPeriodEndDateTime": "String (timestamp)",
  "reviewHistoryPeriodStartDateTime": "String (timestamp)",
  "scopes": [
    {
      "@odata.type": "microsoft.graph.accessReviewScope"
    }
  ],
  "scheduleSettings": {
    "@odata.type": "microsoft.graph.accessReviewHistoryScheduleSettings"
  },
  "status": "String",
}