Access Review History Definitions - List

Servizio:

Authorization

Versione API:

2021-12-01-preview

Elenca gli oggetti accessReviewHistoryDefinitions disponibili da questo provider, le istanze di definizione sono disponibili solo per 30 giorni dopo la creazione.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/accessReviewHistoryDefinitions?api-version=2021-12-01-preview

Con parametri facoltativi:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/accessReviewHistoryDefinitions?api-version=2021-12-01-preview&$filter={$filter}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
$filter	query		string	Filtro da applicare all'operazione. Sono supportati solo i filtri standard per il nome della definizione e la data di creazione

Risposte

Nome	Tipo	Descrizione
200 OK	AccessReviewHistoryDefinitionListResult	Operazione Azure completata con successo.
Other Status Codes	ErrorDefinition	Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Definizioni

Nome	Descrizione
AccessReviewActorIdentityType	Tipo di identità : user/servicePrincipal
AccessReviewHistoryDefinition	Definizione della cronologia delle verifiche di accesso.
AccessReviewHistoryDefinitionListResult	La risposta di un'operazione di lista AccessReviewHistoryDefinition.
AccessReviewHistoryDefinitionStatus	Questo campo di sola lettura specifica i dati della cronologia delle revisioni richiesti. Questa operazione è richiesta, in corso, eseguita o di errore.
AccessReviewHistoryInstance	Istanza della definizione della cronologia delle verifiche di accesso.
AccessReviewRecurrencePatternType	Tipo di ricorrenza: settimanale, mensile e così via.
AccessReviewRecurrenceRangeType	Tipo di intervallo di ricorrenza. I valori possibili sono: endDate, noEnd, numerato.
AccessReviewResult	Rappresenta la decisione del revisore per una determinata recensione
AccessReviewScope	Descrittore per ciò che deve essere esaminato
AccessReviewScopeAssignmentState	Stato idoneo/attivo dell'assegnazione di ruolo da esaminare
AccessReviewScopePrincipalType	Tipo di identità utente/servicePrincipal da esaminare
createdByType	Tipo di identità che ha creato la risorsa.
ErrorDefinition	Errore
ErrorDefinitionProperties	Errore
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

AccessReviewActorIdentityType

Enumerazione

Tipo di identità : user/servicePrincipal

Valore	Descrizione
user	utente
servicePrincipal	servicePrincipal

AccessReviewHistoryDefinition

Oggetto

Definizione della cronologia delle verifiche di accesso.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties.createdBy.principalId	string	ID identità
properties.createdBy.principalName	string	Nome visualizzato dell'identità
properties.createdBy.principalType	AccessReviewActorIdentityType	Tipo di identità : user/servicePrincipal
properties.createdBy.userPrincipalName	string	Nome dell'entità utente(se valido)
properties.createdDateTime	string (date-time)	Data di creazione della definizione della cronologia
properties.decisions	AccessReviewResult[]	Raccolta di decisioni di revisione su cui devono essere filtrati i dati della cronologia. Ad esempio, se vengono forniti approva e negati, i dati conterranno solo i risultati della revisione in cui il decisore ha approvato o negato una richiesta di revisione.
properties.displayName	string	Nome visualizzato per la definizione della cronologia.
properties.instances	AccessReviewHistoryInstance[]	Set di istanze della cronologia delle verifiche di accesso per questa definizione di cronologia.
properties.reviewHistoryPeriodEndDateTime	string (date-time)	Data usata quando si selezionano i dati di revisione, tutte le revisioni incluse nei dati terminano in data o prima di questa data. Per l'uso solo con report occasionali/non ricorrenti.
properties.reviewHistoryPeriodStartDateTime	string (date-time)	Data e ora utilizzata per la selezione dei dati di revisione, tutte le revisioni incluse nei dati iniziano in data o dopo questa data. Per l'uso solo con report occasionali/non ricorrenti.
properties.scopes	AccessReviewScope[]	Raccolta di ambiti usati quando si selezionano i dati della cronologia di revisione
properties.settings.pattern.interval	integer (int32)	Intervallo per la ricorrenza. Per una revisione trimestrale, l'intervallo è 3 per il tipo : absoluteMonthly.
properties.settings.pattern.type	AccessReviewRecurrencePatternType	Tipo di ricorrenza: settimanale, mensile e così via.
properties.settings.range.endDate	string (date-time)	DateTime quando la revisione è pianificata per la fine. Obbligatorio se il tipo è endDate
properties.settings.range.numberOfOccurrences	integer (int32)	Numero di volte in cui ripetere la verifica di accesso. Obbligatorio e deve essere positivo se il tipo è numerato.
properties.settings.range.startDate	string (date-time)	DateTime quando la revisione è pianificata per l'avvio. Potrebbe trattarsi di una data futura. Obbligatorio per la creazione.
properties.settings.range.type	AccessReviewRecurrenceRangeType	Tipo di intervallo di ricorrenza. I valori possibili sono: endDate, noEnd, numerato.
properties.status	AccessReviewHistoryDefinitionStatus	Questo campo di sola lettura specifica i dati della cronologia delle revisioni richiesti. Questa operazione è richiesta, in corso, eseguita o di errore.
systemData	systemData	Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts"

AccessReviewHistoryDefinitionListResult

Oggetto

La risposta di un'operazione di lista AccessReviewHistoryDefinition.

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	AccessReviewHistoryDefinition[]	Gli elementi di AccessReviewHistoryDefinition in questa pagina

AccessReviewHistoryDefinitionStatus

Enumerazione

Questo campo di sola lettura specifica i dati della cronologia delle revisioni richiesti. Questa operazione è richiesta, in corso, eseguita o di errore.

Valore	Descrizione
Requested	Richiesto
InProgress	In corso
Done	Done
Error	Errore

AccessReviewHistoryInstance

Oggetto

Istanza della definizione della cronologia delle verifiche di accesso.

Nome	Tipo	Descrizione
id	string	ID istanza della definizione della cronologia di verifica di accesso.
name	string	ID univoco dell'istanza di definizione della cronologia di verifica di accesso.
properties.displayName	string	Nome visualizzato per la definizione della cronologia padre.
properties.downloadUri	string	URI che può essere usato per recuperare i dati della cronologia di revisione. Per generare questo URI, generateDownloadUri() deve essere chiamato per uno specifico accessReviewHistoryDefinitionInstance. Il collegamento scade dopo un periodo di 24 ore. I chiamanti possono visualizzare la data di scadenza esaminando il parametro 'se' nell'URI generato.
properties.expiration	string (date-time)	Data di scadenza del report dei dati della cronologia e eliminazione dei dati associati.
properties.fulfilledDateTime	string (date-time)	Data di generazione del report dei dati di cronologia.
properties.reviewHistoryPeriodEndDateTime	string (date-time)	Data usata quando si selezionano i dati di revisione, tutte le revisioni incluse nei dati terminano in data o prima di questa data. Per l'uso solo con report occasionali/non ricorrenti.
properties.reviewHistoryPeriodStartDateTime	string (date-time)	Data e ora utilizzata per la selezione dei dati di revisione, tutte le revisioni incluse nei dati iniziano in data o dopo questa data. Per l'uso solo con report occasionali/non ricorrenti.
properties.runDateTime	string (date-time)	Data di generazione del report dei dati di cronologia.
properties.status	AccessReviewHistoryDefinitionStatus	Stato dei dati dell'istanza della cronologia di revisione richiesti. Questa operazione è richiesta, in corso, eseguita o di errore. Le transizioni di stato sono le seguenti: richiesta -> InProgress -> Fine -> Scaduto
type	string	Tipo di risorsa.

AccessReviewRecurrencePatternType

Enumerazione

Tipo di ricorrenza: settimanale, mensile e così via.

Valore	Descrizione
weekly	settimanale
absoluteMonthly	absoluteMonthly

AccessReviewRecurrenceRangeType

Enumerazione

Tipo di intervallo di ricorrenza. I valori possibili sono: endDate, noEnd, numerato.

Valore	Descrizione
endDate	Data di fine
noEnd	noEnd
numbered	numerati

AccessReviewResult

Enumerazione

Rappresenta la decisione del revisore per una determinata recensione

Valore	Descrizione
Approve	Approvazione
Deny	Deny
NotReviewed	NonRecensito
DontKnow	NonLo so
NotNotified	NonNotificato

AccessReviewScope

Oggetto

Descrittore per ciò che deve essere esaminato

Nome	Tipo	Descrizione
assignmentState	AccessReviewScopeAssignmentState	Stato idoneo/attivo dell'assegnazione di ruolo da esaminare
excludeResourceId	string	Viene usato per indicare gli ID risorsa da escludere
excludeRoleDefinitionId	string	Viene usato per indicare gli ID di definizione del ruolo da escludere
expandNestedMemberships	boolean	Flag per indicare se espandere o meno le appartenenze annidate.
inactiveDuration	string (duration)	Durata per cui gli utenti sono inattivi. Il valore deve essere in formato ISO 8601 (http://en.wikipedia.org/wiki/ISO_8601#Durations). Questo codice può essere usato per convertire TimeSpan in una stringa di intervallo valida: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds))
includeAccessBelowResource	boolean	Flag per indicare se espandere o meno le appartenenze annidate.
includeInheritedAccess	boolean	Flag per indicare se espandere o meno le appartenenze annidate.
principalType	AccessReviewScopePrincipalType	Tipo di identità utente/servicePrincipal da esaminare
resourceId	string	ResourceId in cui viene creata questa revisione
roleDefinitionId	string	Viene usato per indicare il ruolo da rivedere

AccessReviewScopeAssignmentState

Enumerazione

Stato idoneo/attivo dell'assegnazione di ruolo da esaminare

Valore	Descrizione
eligible	idoneo
active	attivo

AccessReviewScopePrincipalType

Enumerazione

Tipo di identità utente/servicePrincipal da esaminare

Valore	Descrizione
user	utente
guestUser	GuestUser
servicePrincipal	servicePrincipal
user,group	utente, gruppo
redeemedGuestUser	redeemedGuestUser

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorDefinition

Oggetto

Errore

Nome	Tipo	Descrizione
error	ErrorDefinitionProperties	Errore Errore dello stato del gateway di elenco.

ErrorDefinitionProperties

Oggetto

Errore

Nome	Tipo	Descrizione
code	string	Codice di errore del gateway di elenco.
message	string	Descrizione dell'errore.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Il timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.