Tipo de recurso accessReviewInstanceaccessReviewInstance resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs sob /beta a versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível na versão 1.0, use o seletor de versão.To determine whether an API is available in v1.0, use the Version selector.

Observação

As APIs de revisão de acesso nesta seção são as APIs de revisão de acesso recomendadas.The access review APIs in this section are the recommended access review APIs. A versão mais antiga, as críticasdo Access , serão preteridas.The older version, Access reviews, will be deprecated.

Representa uma recorrência de revisão de acesso do Azure AD.Represents an Azure AD access review recurrence. Se o accessReviewScheduleDefinition pai for uma revisão de acesso recorrente, as instâncias representarão cada recorrência.If the parent accessReviewScheduleDefinition is a recurring access review, instances represent each recurrence. Uma revisão que não se recorre terá exatamente uma instância.A review that does not recur will have exactly one instance. As instâncias também representam cada grupo exclusivo que está sendo revisado na definição de agendamento.Instances also represent each unique group being reviewed in the schedule definition. Se uma definição de agenda analisar vários grupos, cada grupo terá uma instância exclusiva para cada recorrência.If a schedule definition reviews multiple groups, each group will have a unique instance for each recurrence.

Cada accessReviewInstance contém uma lista de decisões que os revisores podem tomar medidas.Every accessReviewInstance contains a list of decisions that reviewers can take action on. Há uma decisão por identidade sendo revisada.There is one decision per identity being reviewed.

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Listar accessReviewInstancesList accessReviewInstances Coleção accessReviewInstanceaccessReviewInstance collection Obter uma lista dos objetos accessReviewInstance e suas propriedades.Get a list of the accessReviewInstance objects and their properties.
Obter accessReviewInstanceGet accessReviewInstance accessReviewInstanceaccessReviewInstance Retorna accessReviewInstance para um accessReviewScheduleDefinition.Returns accessReviewInstance for an accessReviewScheduleDefinition. Não inclui accessReviewInstanceDecisionItem associado no objeto.Does not include associated accessReviewInstanceDecisionItem`s in the object.
Listar pendingAccessReviewInstancesList pendingAccessReviewInstances Coleção accessReviewInstance.accessReviewInstance collection. Obter todos os recursos de accessReviewInstance pendentes atribuídos ao usuário de chamada.Get all pending accessReviewInstance resources assigned to the calling user.
Enviar lembrete accessReviewInstanceSend accessReviewInstance reminder Nenhum.None. Envie um lembrete aos revisores de um accessReviewInstance.Send a reminder to the reviewers of an accessReviewInstance.
Parar accessReviewInstanceStop accessReviewInstance Nenhum.None. Pare manualmente um accessReviewInstance.Manually stop an accessReviewInstance.
Aceitar recomendaçõesAccept recommendations Nenhum.None. Permite que o usuário de chamada aceite a recomendação de decisão para cada acesso NotReviewInstanceDecisionItem em que ele é o revisor para um accessReviewInstance específico.Allows the calling user to accept the decision recommendation for each NotReviewed accessReviewInstanceDecisionItem that they are the reviewer on for a specific accessReviewInstance.
Aplicar decisõesApply decisions Nenhum.None. Aplicar manualmente a decisão em um accessReviewInstance.Manually apply decision on an accessReviewInstance.
Decisões de registro em lotesBatch record decisions NenhumNone Revise lotes de entidades ou recursos em uma chamada.Review batches of principals or resources in one call.

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
idid StringString Identificador exclusivo da instância.Unique identifier of the instance.
displayNamedisplayName StringString Nome do access paiReviewScheduleDefinition.Name of the parent accessReviewScheduleDefinition.
startDateTimestartDateTime DateTimeOffsetDateTimeOffset DateTime quando a instância de revisão está agendada para começar.DateTime when review instance is scheduled to start. Pode ser no futuro.May be in the future. O tipo DateTimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC.The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
endDateTimeendDateTime DateTimeOffsetDateTimeOffset DateTime quando a instância de revisão está agendada para terminar. O tipo DatetimeOffset representa informações de data e hora usando o formato ISO 8601 e está sempre em horário UTC.DateTime when review instance is scheduled to end.The DatetimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
statusstatus StringString Especifica o status de um accessReview.Specifies the status of an accessReview. Os estados típicos Initializing NotStarted incluem , Starting , , , , , e InProgress Completing Completed AutoReviewing AutoReviewed .The typical states include Initializing, NotStarted, Starting, InProgress, Completing, Completed, AutoReviewing, and AutoReviewed. Somente leitura.Read-only.
escoposcope accessReviewScopeaccessReviewScope Criado com base no escopo e instanceEnumerationScope no accessReviewScheduleDefinition nível.Created based on scope and instanceEnumerationScope at the accessReviewScheduleDefinition level. Define o escopo dos usuários revisados em um grupo.Defines the scope of users reviewed in a group. No caso de uma revisão de grupo único, o escopo definido no accessReviewScheduleDefinition nível se aplica a todas as instâncias.In the case of a single-group review, the scope defined at the accessReviewScheduleDefinition level applies to all instances. No caso da revisão de todos os grupos, o escopo pode ser diferente para cada grupo.In the case of all groups review, scope may be different for each group. Somente leitura.Read-only.
decisionsdecisions Coleção accessReviewInstanceDecisionItemaccessReviewInstanceDecisionItem collection Cada usuário revisado em um accessReviewInstance tem um item de decisão que representa se seu acesso foi aprovado, negado ou ainda não revisado.Each user reviewed in an accessReviewInstance has a decision item representing if their access was approved, denied, or not yet reviewed.
definitiondefinition accessReviewScheduleDefinitionaccessReviewScheduleDefinition Há exatamente um accessReviewScheduleDefinition associado a cada instância.There is exactly one accessReviewScheduleDefinition associated with each instance. É a agenda pai da instância, onde as instâncias são criadas para cada recorrência de uma definição de revisão e cada grupo selecionado para revisar pela definição.It is the parent schedule for the instance, where instances are created for each recurrence of a review definition and each group selected to review by the definition.

RelaçõesRelationships

RelaçãoRelationship TipoType DescriçãoDescription
definition accessReviewScheduleDefinitionaccessReviewScheduleDefinition Há exatamente um accessReviewScheduleDefinition associado a cada instância.There is exactly one accessReviewScheduleDefinition associated with each instance. É a agenda pai da instância, onde as instâncias são criadas para cada recorrência de uma definição de revisão e cada grupo selecionado para revisar pela definição.It is the parent schedule for the instance, where instances are created for each recurrence of a review definition and each group selected to review by the definition.
decisions Coleção accessReviewInstanceDecisionItemaccessReviewInstanceDecisionItem collection Cada usuário revisado em um tem um item de decisão representando se eles foram accessReviewInstance aprovados, negados ou ainda não revisados.Each user reviewed in an accessReviewInstance has a decision item representing if they were approved, denied, or not yet reviewed.

Representação JSONJSON representation

Veja a seguir uma representação JSON do recurso.Here is a JSON representation of the resource.

{
 "@odata.type": "#microsoft.graph.accessReviewInstance",
 "id": "string (identifier)",
 "displayName": "string",
 "startDateTime": "string (timestamp)",
 "endDateTime": "string (timestamp)",
 "status": "string",
 "scope": {
    "@odata.type": "microsoft.graph.accessReviewScope"
  }
}