accessReviewHistoryDefinition-Ressourcentyp

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.

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
List	accessReviewHistoryDefinition-Auflistung	Rufen Sie eine Liste der accessReviewHistoryDefinition-Objekte und deren Eigenschaften ab.
Create	accessReviewHistoryDefinition	Create ein neues accessReviewHistoryDefinition-Objekt.
Get	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	Zeichenfolgensammlung	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, notReviewedund notNotified.
displayName	Zeichenfolge	Name für die Datensammlung des Zugriffsüberprüfungsverlaufs. Erforderlich.
id	Zeichenfolge	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",
  "id": "String (identifier)",
  "displayName": "String",
  "reviewHistoryPeriodStartDateTime": "String (timestamp)",
  "reviewHistoryPeriodEndDateTime": "String (timestamp)",
  "status": "String",
  "decisions": [
    "String"
  ],
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.userIdentity"
  },
  "scopes": [
    {
      "@odata.type": "microsoft.graph.accessReviewScope"
    }
  ],
  "scheduleSettings": {
    "@odata.type": "microsoft.graph.accessReviewHistoryScheduleSettings"
  }
}