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 Required Type Description
historyDefinitionId
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 Type Description
200 OK

Beschreiben Sie das Ergebnis eines erfolgreichen Vorgangs.

Other Status Codes

Unerwarteter Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

GetAccessReviewHistoryDefinitionInstances

Sample Request

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

Sample Response

{
  "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

AccessReviewHistoryDefinitionInstanceListResult

Liste der Zugriffsüberprüfungsverlaufsinstanzen.

AccessReviewHistoryDefinitionStatus

Dieses schreibgeschützte Feld gibt die angeforderten Überprüfungsverlaufsdaten an. Dies wird entweder angefordert, ausgeführt oder fehler ausgeführt.

AccessReviewHistoryInstance

Access Review History Definition Instance.

ErrorDefinition

Fehler

ErrorDefinitionProperties

Fehler

AccessReviewHistoryDefinitionInstanceListResult

Liste der Zugriffsüberprüfungsverlaufsinstanzen.

Name Type Description
nextLink
  • string

Die URL, die zum Abrufen der nächsten Gruppe von Ergebnissen verwendet werden soll.

value

Access Review History Definition's Instance List.

AccessReviewHistoryDefinitionStatus

Dieses schreibgeschützte Feld gibt die angeforderten Überprüfungsverlaufsdaten an. Dies wird entweder angefordert, ausgeführt oder fehler ausgeführt.

Name Type Description
Done
  • string
Error
  • string
InProgress
  • string
Requested
  • string

AccessReviewHistoryInstance

Access Review History Definition Instance.

Name Type Description
id
  • string

Die Zugriffsüberprüfungsverlaufsdefinitionsinstanz-ID.

name
  • string

Eindeutige ID der Zugriffsüberprüfungsverlaufsdefinitionsinstanz.

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 einen bestimmten AccessReviewHistoryDefinitionInstance aufgerufen werden. Der Link läuft nach einem Zeitraum von 24 Stunden ab. Aufrufer können die Ablaufdatumszeit sehen, indem Sie den Parameter "se" im generierten URI betrachten.

properties.expiration
  • string

Datumszeit, zu der der Verlaufsdatenbericht abläuft, und die zugehörigen Daten werden gelöscht.

properties.fulfilledDateTime
  • string

Datumszeit, zu der der Verlaufsdatenbericht generiert werden soll.

properties.reviewHistoryPeriodEndDateTime
  • string

Datumszeit, die beim Auswählen von Überprüfungsdaten verwendet wird, alle Rezensionen, die in Daten enthalten sind, enden am 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 Rezensionen, die in Daten enthalten sind, beginnen am oder nach diesem Datum. Nur für einmalige/nicht wiederkehrende Berichte.

properties.runDateTime
  • string

Datumszeit, zu der der Verlaufsdatenbericht generiert werden soll.

properties.status

Status der angeforderten Überprüfungsverlaufsinstanzdaten. Dies wird entweder angefordert, ausgeführt oder fehler ausgeführt. Die Statusübergänge sind wie folgt - Angefordert -> InProgress -> Fertig -> Abgelaufen

type
  • string

Der Ressourcentyp.

ErrorDefinition

Fehler

Name Type Description
error

Fehler
Fehler des Listengatewaystatus.

ErrorDefinitionProperties

Fehler

Name Type Description
code
  • string

Fehlercode des Listengateways.

message
  • string

Beschreibung des Fehlers