Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Namespace: microsoft.graph.security
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.
Crie um novo objeto ediscoveryReviewSet .
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | eDiscovery.Read.All | eDiscovery.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | eDiscovery.Read.All | eDiscovery.ReadWrite.All |
Importante
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função com suporte do Microsoft Purview por meio de uma das seguintes opções:
- Gerente de Descoberta Eletrônica. Permite que os membros acessem conjuntos de revisão em casos de Descoberta Eletrônica que eles criam e dos quais são membros. Essa é a opção menos privilegiada para acessar conjuntos de revisão em seus próprios casos.
- Administrador de Descoberta. Fornece todas as permissões do Gerente de Descoberta Eletrônica, além da capacidade de acessar conjuntos de revisão em todos os casos de Descoberta Eletrônica na organização.
- Revisor. Fornece acesso somente leitura a conjuntos de revisão em casos de Descoberta Eletrônica em que o usuário é membro. Os revisores podem exibir e marcar documentos, mas não podem realizar outras tarefas de gerenciamento de casos.
A função Revisão permite que os usuários acessem conjuntos de revisão em casos de Descoberta Eletrônica dos quais são membros. Os usuários podem exibir e marcar documentos em conjuntos de revisão, mas não podem visualizar os resultados da pesquisa ou executar outras tarefas de pesquisa ou gerenciamento de casos.
Para obter mais informações sobre permissões e funções da Descoberta Eletrônica, consulte Atribuir permissões na Descoberta Eletrônica.
Solicitação HTTP
POST /security/cases/ediscoveryCases/{ediscoveryCaseId}/reviewSets
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON do objeto ediscoveryReviewSet .
Você pode especificar as propriedades a seguir ao criar um ediscoveryReviewSet.
| Propriedade | Tipo | Descrição |
|---|---|---|
| description | Cadeia de caracteres | A descrição do conjunto de revisão. |
| displayName | Cadeia de caracteres | O nome do conjunto de revisão. Obrigatório. |
Resposta
Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto microsoft.graph.security.ediscoveryReviewSet no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/security/cases/ediscoveryCases/b0073e4e-4184-41c6-9eb7-8c8cc3e2288b/reviewSets
Content-Type: application/json
{
"displayName": "My review set 2"
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#security/cases/ediscoveryCases('b0073e4e-4184-41c6-9eb7-8c8cc3e2288b')/reviewSets/$entity",
"displayName": "My review set 2",
"id": "887306f5-1eb4-4409-b18c-ba47f4e3fa9b",
"createdDateTime": "2022-05-23T16:33:13.5126494Z",
"createdBy": {
"application": null,
"user": {
"id": "c25c3914-f9f7-43ee-9cba-a25377e0cec6",
"displayName": null,
"userPrincipalName": "c25c3914-f9f7-43ee-9cba-a25377e0cec6"
}
}
}