tipo de recurso unifiedRoot

Namespace: microsoft.graph

Recurso de contêiner que agrupa as coleções de revisão de acesso unificado no segmento de identityGovernance/accessReviews/unified caminho. A unified rota é o ponto de entrada para análises de acesso centradas no usuário (escopo de catálogo), em que um administrador analisa o acesso de um usuário em todos os recursos contidos em um catálogo de gerenciamento de direitos em uma única revisão, em vez de revisar um recurso por vez.

Um catálogo é um contêiner que agrupa vários tipos de recursos, atualmente grupos e aplicativos. Com uma revisão centrada no usuário, um revisor (normalmente o gerente do usuário) avalia o acesso de uma entidade de segurança a cada grupo e aplicativo no catálogo a partir de uma única exibição consolidada. As coleções reutilizam as mesmas formas de recurso accessReviewScheduleDefinition, accessReviewInstance e accessReviewInstanceDecisionItem que a API de revisões de acesso geralmente disponível; o escopo do catálogo é expresso por meio do principalResourceMembershipsScope da definição de revisão.

Esse recurso é alcançado por meio do relacionamento unificado no recurso accessReviewSet .

A tabela a seguir resume como a rota unificada difere da API de revisões de acesso atual.

Herda de entidade.

Methods

Somente listar e criar definições são documentadas como métodos unificados dedicados, pois a criação de uma revisão de escopo de catálogo é a única operação específica para a rota unificada. Depois que uma definição é criada, suas instâncias, estágios e decisões são gerenciados por meio das operações compartilhadas accessReviewScheduleDefinition, accessReviewInstance e accessReviewInstanceDecisionItem (por exemplo, obter, atualizar, excluir, listar instâncias, parar e aplicar decisões), abordadas no segmento de identityGovernance/accessReviews/unified caminho. A seção Exemplos mostra essas operações compartilhadas no caminho unificado e links para as páginas do método correspondentes.

Propriedades

Nenhum.

Relações

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.unifiedRoot"
}

Exemplos

A criação e a listagem de definições centradas no usuário (escopo de catálogo) são documentadas nas páginas de método Definições de lista e Definição de criação. Os exemplos a seguir mostram como navegar pelas instâncias e decisões de uma definição e aplicar resultados pela unified rota. Cada solicitação é endereçada no segmento de identityGovernance/accessReviews/unified caminho.

Exemplo 1: Listar instâncias de uma definição de revisão de acesso unificada

O exemplo a seguir lista os objetos accessReviewInstance para uma definição centrada no usuário. Para obter exemplos de código nos SDKs do Microsoft Graph, consulte Listar instâncias.

Solicitação

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/accessReviews/unified/definitions('29f2d16e-9ca6-4052-bbfe-802c48944448')/instances",
    "value": [
        {
            "id": "e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f",
            "status": "InProgress",
            "startDateTime": "2026-08-31T00:00:00Z",
            "endDateTime": "2026-09-06T00:00:00Z"
        }
    ]
}

Exemplo 2: Listar as entidades de segurança em revisão para uma instância

O exemplo a seguir agrupa os objetos accessReviewInstanceDecisionItem por entidade de segurança para retornar os usuários distintos cujo acesso está sendo revisado na instância. Para obter exemplos de código nos SDKs do Microsoft Graph, consulte Decisões de lista.

Solicitação

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/decisions?$apply=groupby((principal/id,principal/displayName))

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/accessReviews/unified/definitions('29f2d16e-9ca6-4052-bbfe-802c48944448')/instances('e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f')/decisions",
    "value": [
        {
            "principal": {
                "id": "a4c6f1e2-6f2d-4b8a-9c3e-2f1a0b5d7e9c",
                "displayName": "Alex Wilber"
            }
        }
    ]
}

Exemplo 3: Listar decisões para uma instância

O exemplo a seguir lista os objetos accessReviewInstanceDecisionItem individuais, um por entidade de segurança e recurso, para uma instância de revisão centrada no usuário. Para obter exemplos de código nos SDKs do Microsoft Graph, consulte Decisões de lista.

Solicitação

GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/decisions

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/accessReviews/unified/definitions('29f2d16e-9ca6-4052-bbfe-802c48944448')/instances('e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f')/decisions",
    "value": [
        {
            "id": "9f8c2b1a-3d4e-4f5a-8b6c-7d8e9f0a1b2c",
            "decision": "NotReviewed",
            "principal": {
                "id": "a4c6f1e2-6f2d-4b8a-9c3e-2f1a0b5d7e9c",
                "displayName": "Alex Wilber"
            },
            "resource": {
                "id": "b74444cb-038a-4802-8fc9-b9d1ed0cf11f",
                "displayName": "Marketing"
            }
        }
    ]
}

Exemplo 4: Interromper uma instância de revisão de acesso unificado

O exemplo a seguir interrompe uma instância de revisão centrada no usuário em andamento. Para obter exemplos de código nos SDKs do Microsoft Graph, consulte accessReviewInstance: stop.

Solicitação

POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/stop

Resposta

HTTP/1.1 204 No Content

Exemplo 5: Aplicar as decisões de uma instância de revisão de acesso unificada

O exemplo a seguir aplica as decisões registradas de uma instância de revisão centrada no usuário concluída. Para obter exemplos de código nos SDKs do Microsoft Graph, consulte accessReviewInstance: applyDecisions.

Solicitação

POST https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448/instances/e6cf9d5b-6222-4e6f-9f7e-1c2f4e0b5a2f/applyDecisions

Resposta

HTTP/1.1 204 No Content

Exemplo 6: Excluir uma definição de revisão de acesso unificada

O exemplo a seguir exclui um accessReviewScheduleDefinition centrado no usuário. Para obter exemplos de código nos SDKs do Microsoft Graph, consulte Excluir accessReviewScheduleDefinition.

Solicitação

DELETE https://graph.microsoft.com/beta/identityGovernance/accessReviews/unified/definitions/29f2d16e-9ca6-4052-bbfe-802c48944448

Resposta

HTTP/1.1 204 No Content