directoryObject: checkMemberObjects
Namespace: microsoft.graph
Verifique se há associação em uma lista de IDs de grupo, IDs de unidade administrativa ou IDs de função de diretório, para as IDs do usuário, grupo, entidade de serviço, contato organizacional, dispositivo ou objeto de diretório especificado. Esse método é transitivo.
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
Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
Associações para um objeto de diretório
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegado (conta corporativa ou de estudante) | Directory.Read.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Aplicativo | Directory.Read.All |
Associações para um usuário
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegado (conta corporativa ou de estudante) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Application | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
Associações para um grupo
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegada (conta corporativa ou de estudante) | GroupMember. Read. All, Group. Read. All, Directory. Read. All, Group. ReadWrite. All, Directory. ReadWrite. All |
Delegada (conta pessoal da Microsoft) | Sem suporte. |
Aplicativo | GroupMember. Read. All, Group. Read. All, Directory. Read. All, Group. ReadWrite. All, Directory. ReadWrite. All |
Associações para uma entidade de serviço
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegado (conta corporativa ou de estudante) | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Aplicativo | Application.Read.All, Directory.Read.All, Application.ReadWrite.All, Directory.ReadWrite.All |
Associações para um contato organizacional
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegado (conta corporativa ou de estudante) | Directory.Read.All, Directory.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Aplicativo | Directory.Read.All, Directory.ReadWrite.All |
Associações para um dispositivo
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegado (conta corporativa ou de estudante) | Device.Read.All, Directory.Read.All, Directory.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
Solicitação HTTP
Associações para um objeto de diretório.
POST /directoryObjects/{id}/checkMemberObjects
Associações para um usuário.
POST /me/checkMemberObjects
POST /users/{id | userPrincipalName}/checkMemberObjects
Associações para um grupo.
POST /groups/{id}/checkMemberObjects
Associações para uma entidade de serviço.
POST /servicePrincipals/{id}/checkMemberObjects
Associações para um contato organizacional.
POST /contacts/{id}/checkMemberObjects
Associações para um dispositivo.
POST /devices/{id}/checkMemberObjects
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
Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.
Parâmetro | Tipo | Descrição |
---|---|---|
ids | Coleção de cadeias de caracteres | Uma coleção que contém as IDs de objeto dos grupos, unidades administrativas, funções de diretório ou IDs roleTemplate de funções de diretório, nas quais marcar associação. Você pode especificar até 20 objetos. |
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e um novo objeto de coleção String no corpo da resposta.
Exemplos
A seguir está um exemplo de como chamar essa API.
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/v1.0/me/checkMemberObjects
Content-type: application/json
{
"ids": [
"80a963dd-84af-4eb8-b2a6-781e444d4fb0",
"62e90394-69f5-4237-9190-012177145e10",
"86a64f51-3a64-4cc6-a8c8-6b8f000c0f52",
"ac38546e-ddf3-437a-ac5c-27a94cd7a0f1"
]
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
"80a963dd-84af-4eb8-b2a6-781e444d4fb0",
"62e90394-69f5-4237-9190-012177145e10"
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte:Enviar e exibir comentários de