Adicionar membros
Namespace: microsoft.graph
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.
Adicionar um membro a um grupo de segurança ou do Microsoft 365. Ao utilizar a API para adicionar vários membros num único pedido, pode somar apenas 20 membros.
A tabela a seguir mostra os tipos de membros que podem ser adicionados a grupos de segurança ou grupos do Microsoft 365.
Tipo de objeto | Membro do grupo de segurança | Membro do Microsoft 365 grupo |
---|---|---|
Usuário | ||
Grupo de segurança | ||
Grupo Microsoft 365 | ||
Dispositivo | ||
Entidade de serviço | ||
Contatos organizacionais |
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
A tabela seguinte mostra a permissão com menos privilégios necessária para cada tipo de recurso ao chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.
Recurso com suporte | Delegada (conta corporativa ou de estudante) | Delegada (conta pessoal da Microsoft) | Application |
---|---|---|---|
device | GroupMember.ReadWrite.All e Device.ReadWrite.All | Sem suporte. | GroupMember.ReadWrite.All e Device.ReadWrite.All |
group | GroupMember.ReadWrite.All | Sem suporte. | GroupMember.ReadWrite.All |
orgContact | GroupMember.ReadWrite.All e OrgContact.Read.All | Sem suporte. | GroupMember.ReadWrite.All e OrgContact.Read.All |
servicePrincipal | GroupMember.ReadWrite.All e Application.ReadWrite.All | Sem suporte. | GroupMember.ReadWrite.All e Application.ReadWrite.All |
user | GroupMember.ReadWrite.All | Sem suporte. | GroupMember.ReadWrite.All |
Em cenários delegados, o utilizador com sessão iniciada também tem de ter uma função de Microsoft Entra suportada ou uma função personalizada com a permissão de microsoft.directory/groups/members/update
função. As seguintes funções são as funções com menos privilégios que são suportadas para esta operação, exceto para grupos atribuíveis a funções:
- Proprietários de grupos
- Escritores de diretório
- Administrador do Grupos
- Administrador de Governação de Identidades
- Administrador do usuário
- Administrador do Exchange - apenas para grupos do Microsoft 365
- Administrador do SharePoint - apenas para grupos do Microsoft 365
- Administrador do Teams - apenas para grupos do Microsoft 365
- Administrador do Yammer - apenas para grupos do Microsoft 365
- Administrador do Intune - apenas para grupos de segurança
Para adicionar membros a um grupo atribuível a funções, também tem de ser atribuída à aplicação a permissão RoleManagement.ReadWrite.Directory e tem de ser atribuída ao utilizador de chamada uma função de Microsoft Entra suportada. O Administrador de Funções Com Privilégios é a função com menos privilégios suportada para esta operação.
Solicitação HTTP
POST /groups/{group-id}/members/$ref
POST /groups/{group-id}/members/
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
Ao utilizar a /groups/{group-id}/members/$ref
sintaxe, forneça um objeto JSON que contenha uma propriedade @odata.id com uma referência por ID para um tipo de objeto membro de grupo suportado.
Ao utilizar a /groups/{group-id}/members
sintaxe, forneça um objeto JSON que contenha uma members@odata.bind propriedade com uma ou mais referências por IDs para um tipo de objeto membro de grupo suportado.
Se utilizar a referência directoryObjects , ou seja, https://graph.microsoft.com/v1.0/directoryObjects/{id}
, o tipo de objeto ainda tem de ser um tipo de objeto membro de grupo suportado.
Resposta
Se tiver êxito, este método retornará um código de resposta 204 No Content
. Devolve um 400 Bad Request
código de resposta quando o objeto já é membro do grupo ou não é suportado como membro do grupo. Devolve um 404 Not Found
código de resposta quando o objeto que está a ser adicionado não existe.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/groups/{group-id}/members/$ref
Content-type: application/json
{
"@odata.id": "https://graph.microsoft.com/beta/directoryObjects/{id}"
}
No corpo do pedido, forneça uma representação JSON do id
objeto directoryObject, utilizador ou grupo que pretende adicionar.
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content