Scope Access Review History Definition Instances - List
Abrufen von Zugriffsüberprüfungsverlaufsdefinitionsinstanzen nach Definitions-ID
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/accessReviewHistoryDefinitions/{historyDefinitionId}/instances?api-version=2021-12-01-preview
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
history
|
path | True |
string |
Die ID der Definition des Zugriffsüberprüfungsverlaufs. |
scope
|
path | True |
string |
Der Bereich der Ressource. |
api-version
|
query | True |
string |
Die API-Version, die mit der HTTP-Anforderung verwendet werden soll. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Beschreiben sie das Ergebnis eines erfolgreichen Vorgangs. |
|
Other Status Codes |
Unerwarteter Fehler |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
GetAccessReviewHistoryDefinitionInstances
Beispielanforderung
GET https://management.azure.com/subscriptions/129a304b-4aea-4b86-a9f7-ba7e2b23737a/providers/Microsoft.Authorization/accessReviewHistoryDefinitions/44724910-d7a5-4c29-b28f-db73e717165a/instances?api-version=2021-12-01-preview
Beispiel für eine Antwort
{
"value": [
{
"id": "44724910-d7a5-4c29-b28f-db73e717165a",
"name": "44724910-d7a5-4c29-b28f-db73e717165a",
"type": "Microsoft.Authorization/accessReviewHistoryInstance",
"properties": {
"reviewHistoryPeriodStartDateTime": "2021-10-01T00:00:00-07:00",
"reviewHistoryPeriodEndDateTime": "2021-12-01T00:00:00-08:00",
"displayName": "Hello world name",
"status": "Requested",
"runDateTime": "2021-12-23T00:27:33.6905189+00:00",
"fulfilledDateTime": "2021-12-23T00:28:33.6905189+00:00",
"expiration": "2022-01-22T00:28:33.6905189+00:00"
}
}
],
"nextLink": null
}
Definitionen
Name | Beschreibung |
---|---|
Access |
Liste der Zugriffsüberprüfungsverlaufsinstanzen. |
Access |
Dieses schreibgeschützte Feld gibt die der angeforderten Überprüfungsverlaufsdaten an. Dies ist entweder angefordert, in Bearbeitung, fertig oder fehler. |
Access |
Zugriffsüberprüfungsverlaufsdefinitionsinstanz. |
Error |
Fehler |
Error |
Fehler |
AccessReviewHistoryDefinitionInstanceListResult
Liste der Zugriffsüberprüfungsverlaufsinstanzen.
Name | Typ | Beschreibung |
---|---|---|
nextLink |
string |
Die URL, die zum Abrufen des nächsten Resultsets verwendet werden soll. |
value |
Instanzliste der Zugriffsüberprüfungsverlaufsdefinition. |
AccessReviewHistoryDefinitionStatus
Dieses schreibgeschützte Feld gibt die der angeforderten Überprüfungsverlaufsdaten an. Dies ist entweder angefordert, in Bearbeitung, fertig oder fehler.
Name | Typ | Beschreibung |
---|---|---|
Done |
string |
|
Error |
string |
|
InProgress |
string |
|
Requested |
string |
AccessReviewHistoryInstance
Zugriffsüberprüfungsverlaufsdefinitionsinstanz.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Die Definition des Zugriffsüberprüfungsverlaufs instance ID. |
name |
string |
Die Definition des Zugriffsüberprüfungsverlaufs instance eindeutige ID. |
properties.displayName |
string |
Der Anzeigename für die definition des übergeordneten Verlaufs. |
properties.downloadUri |
string |
URI, der zum Abrufen von Überprüfungsverlaufsdaten verwendet werden kann. Um diesen URI zu generieren, muss generateDownloadUri() für eine bestimmte accessReviewHistoryDefinitionInstance aufgerufen werden. Der Link läuft nach einem Zeitraum von 24 Stunden ab. Aufrufer können die Ablaufdatumszeit anzeigen, indem sie den Parameter "se" im generierten URI betrachten. |
properties.expiration |
string |
Datum der Uhrzeit, zu der der Verlaufsdatenbericht abläuft und die zugeordneten Daten gelöscht werden. |
properties.fulfilledDateTime |
string |
Datum, zu der der Verlaufsdatenbericht generiert werden soll. |
properties.reviewHistoryPeriodEndDateTime |
string |
Datumszeit, die beim Auswählen von Überprüfungsdaten verwendet wird. Alle in den Daten enthaltenen Überprüfungen enden an oder vor diesem Datum. Nur für einmalige/nicht wiederkehrende Berichte. |
properties.reviewHistoryPeriodStartDateTime |
string |
Datumszeit, die beim Auswählen von Überprüfungsdaten verwendet wird. Alle überprüfungen, die in daten enthalten sind, beginnen am oder nach diesem Datum. Nur für einmalige/nicht wiederkehrende Berichte. |
properties.runDateTime |
string |
Datum, zu der der Verlaufsdatenbericht generiert werden soll. |
properties.status |
Status des angeforderten Überprüfungsverlaufs instance Daten. Dies ist entweder angefordert, in Bearbeitung, fertig oder fehler. Die Zustandsübergänge sind wie folgt: Angefordert –> InProgress –> Done –> Expired |
|
type |
string |
Der Ressourcentyp. |
ErrorDefinition
Fehler
Name | Typ | Beschreibung |
---|---|---|
error |
Fehler |
ErrorDefinitionProperties
Fehler
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Fehlercode des Listengateways. |
message |
string |
Beschreibung des Fehlers |