accessReviewInstance tipo de recurso
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Observação
Esta é a API recomendada para revisões de acesso. A versão anterior da API de revisões de acesso foi preterida.
Representa uma periodicidade de revisão de acesso do Microsoft Entra. Se o acesso principalReviewScheduleDefinition for uma revisão de acesso periódica, as instâncias representam cada periodicidade. Uma revisão que não se repita terá exatamente uma instância. As instâncias também representam cada grupo exclusivo que está a ser revisto na definição de agenda. Se uma definição de agenda rever vários grupos, cada grupo tem uma instância exclusiva para cada periodicidade.
Cada accessReviewInstance contém uma lista de decisões nas quais os revisores podem tomar medidas. Há uma decisão por identidade a ser revista.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | accessReviewInstance collection (coleção accessReviewInstance ) | Obtenha uma lista dos objetos accessReviewInstance e respetivas propriedades. |
| Get | accessReviewInstance | Leia as propriedades e relações de um objeto accessReviewInstance . |
| Atualizar | accessReviewInstance | Atualize os revisores de um objeto accessReviewInstance . |
| Filtrar por utilizador atual | accessReviewInstance collection (coleção accessReviewInstance ) | Devolve todas as instâncias num determinado accessReviewScheduleDefinition para o qual o utilizador que chama é o revisor de uma ou mais decisões. |
| Listar revisores contactados | accessReviewReviewer collection | Obtenha os revisores que receberam notificações de uma instância de revisão de acesso. |
| Enviar lembrete | Nenhuma. | Envie um lembrete aos revisores de um accessReviewInstance. |
| Stop | Nenhuma. | Parar manualmente um accessReviewInstance. |
| Aceitar recomendações | Nenhuma. | Permite que o utilizador que chama aceite a recomendação de decisão para cada acesso Não VisualizadoReviewInstanceDecisionItem em que é o revisor para um acesso específicoReviewInstance. |
| Aplicar decisões | Nenhuma. | Aplicar manualmente decisões num accessReviewInstance. |
| Parar de aplicar decisões | Nenhuma. | Permite que o utilizador que chama pare a ação de decisão aplicar num accessReviewInstance específico. |
| Decisões de registo do Batch | Nenhum | Reveja lotes de principais ou recursos numa chamada. |
| Repor decisões | Nenhum | Repõe todos os itens de decisão numa instância para notReviewed. |
| Fases da lista | coleção accessReviewStage | Obtenha as fases numa instância de revisão de acesso em várias fases. |
| Listar decisões | accessReviewInstanceDecisionItem collection (coleção accessReviewInstanceDecisionItem ) | Obtenha os recursos accessReviewInstanceDecisionItem a partir da propriedade de navegação de decisões. |
| Listar instâncias de revisão de acesso pendentes (preteridas) | accessReviewInstance collection. | Obtenha todos os recursos de accessReviewInstance pendentes atribuídos ao utilizador que chama. Este método está a ser preterido e substituído por filterByCurrentUser. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| endDateTime | DateTimeOffset | DateTime quando a instância de revisão está agendada para o fim. O tipo DatetimeOffset representa informações de data e hora com o formato ISO 8601 e está sempre na hora UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Oferece suporte para $select. Somente leitura. |
| erros | accessReviewError collection (coleção accessReviewError ) | Coleção de erros num ciclo de vida da instância de revisão de acesso. Somente leitura. |
| fallbackReviewers | accessReviewReviewerScope collection (coleção accessReviewReviewerScope ) | Esta coleção de âmbitos de revisores é utilizada para definir a lista de revisores de contingência. Estes revisores de contingência são notificados para tomar medidas se não forem encontrados utilizadores na lista de revisores especificados. Isto pode ocorrer quando o proprietário do grupo é especificado como revisor, mas o proprietário do grupo não existe ou o gestor é especificado como revisor, mas o gestor de um utilizador não existe. Oferece suporte para $select. |
| id | Cadeia de caracteres | Identificador exclusivo da instância. Oferece suporte para $select. Somente leitura. |
| scope | accessReviewScope | Criado com base no âmbito e instanceEnumerationScope no nível accessReviewScheduleDefinition. Define o âmbito dos utilizadores revistos num grupo.
$select Suporta e $filter (contains apenas). Somente leitura. |
| startDateTime | DateTimeOffset | DateTime quando a instância de revisão está agendada para iniciar. Pode ser no futuro. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Oferece suporte para $select. Somente leitura. |
| status | Cadeia de caracteres | Especifica o estado de um accessReview. Valores possíveis: Initializing, NotStarted, , StartingInProgress, Completing, , Completed, AutoReviewinge AutoReviewed.
$selectSuporta apenas , $orderbye $filter (eq ). Somente leitura. |
| revisores | accessReviewReviewerScope collection (coleção accessReviewReviewerScope ) | Esta coleção de âmbitos de revisão de acesso é utilizada para definir quem são os revisores. Oferece suporte para $select. Para obter exemplos de opções para atribuir revisores, veja Atribuir revisores à definição de revisão de acesso com a Microsoft Graph API. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| contactedReviewers | accessReviewReviewer collection | Devolve a coleção de revisores que foram contactados para concluir esta revisão. Embora os revisores e as propriedades fallbackReviewers do accessReviewScheduleDefinition possam especificar proprietários ou gestores de grupos como revisores, contactedReviewers devolve as respetivas identidades individuais. Oferece suporte para $select. Somente leitura. |
| definição | accessReviewScheduleDefinition | Existe exatamente um accessReviewScheduleDefinition associado a cada instância. É a agenda principal da instância, em que as instâncias são criadas para cada periodicidade de uma definição de revisão e cada grupo selecionado para rever pela definição. |
| Estágios | coleção accessReviewStage | Se a instância tiver várias fases, esta ação devolve a coleção de fases. Só será criada uma nova fase quando a fase anterior terminar. A existência, número e definições de fases numa instância de revisão são criadas com base no accessReviewStageSettings no acesso principalReviewScheduleDefinition. |
| decisões | accessReviewInstanceDecisionItem collection (coleção accessReviewInstanceDecisionItem ) | Cada utilizador revisto num accessReviewInstance tem um item de decisão que representa se foi aprovado, negado ou ainda não revisto. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.accessReviewInstance",
"id": "string (identifier)",
"startDateTime": "string (timestamp)",
"endDateTime": "string (timestamp)",
"status": "string",
"scope": {
"@odata.type": "microsoft.graph.accessReviewScope"
},
"reviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewerScope"
}
],
"fallbackReviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewerScope"
}
],
"contactedReviewers": [
{
"@odata.type": "microsoft.graph.accessReviewReviewer"
}
]
}