Criar usuário legalHoldSource
Namespace: microsoft.graph.ediscovery
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.
Adiciona um userSource a um objeto legalHold.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | eDiscovery.Read.All | eDiscovery.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sem suporte. | Sem suporte. |
Solicitação HTTP
POST /compliance/ediscovery/cases/{caseId}/legalHolds/{legalholdId}/userSources
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 userSource .
A tabela a seguir lista as propriedades necessárias ao criar o userSource.
Propriedade | Tipo | Descrição |
---|---|---|
Cadeia de caracteres | Endereço SMTP do usuário ou do endereço SMTP da caixa de correio do grupo. Para obter o endereço de email do grupo, use Grupos de listas ou Grupo Get. Usando o grupo get, você pode consultar pelo nome do grupo usando $filter ; por exemplo, https://graph.microsoft.com/v1.0/groups?$filter=displayName eq 'secret group'&$select=mail,id,displayName . |
|
includedSources | microsoft.graph.ediscovery.sourceType | Especifica quais fontes estão incluídas nesse grupo. Esse valor deve ser mailbox , site não tem suporte para legalHolds no momento. |
Resposta
Se for bem-sucedido, esse método retornará um 201 Created
código de resposta e um objeto microsoft.graph.ediscovery.userSource no corpo da resposta.
Exemplos
Solicitação
POST https://graph.microsoft.com/beta/compliance/ediscovery/cases/c816dd6f-5af8-40c5-a760-331361e05c60/legalHolds/387566cc-38ae-4e85-ab4b-cd2dd34faa07/userSources
Content-Type: application/json
{
"email": "adelev@contoso.com",
"includedSources": "mailbox"
}
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#compliance/ediscovery/cases/c816dd6f-5af8-40c5-a760-331361e05c60/legalholds/387566cc-38ae-4e85-ab4b-cd2dd34faa07/userSources",
"value": [
{
"displayName": "Adele Vance",
"createdDateTime": "2020-12-28T20:08:57.857Z",
"id": "2192ca40-8ea2-410e-ba3b-ec8ae873be6b",
"email": "AdeleV@contoso.com",
"includedSources": "mailbox",
"createdBy": {
"user": {
"id": null,
"displayName": "EDiscovery admin"
}
}
}
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de