Adicionar proprietários
Namespace: microsoft.graph
Adicione um utilizador ou principal de serviço aos proprietários do Microsoft 365 ou do grupo de segurança. Os proprietários são um conjunto de usuários ou os diretores de serviço que têm permissão para modificar o objeto do grupo.
Importante: se você atualizar os proprietários do grupo, e você criou uma equipe para o grupo, poderá levar até duas horas para que os proprietários sejam sincronizados com o Microsoft Teams. Além disso, se você quiser que o proprietário seja capaz de fazer alterações em uma equipe - por exemplo, criando um plano Planner - o proprietário também precisará ser adicionado como um membro do grupo/equipe.
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
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
Delegado (conta corporativa ou de estudante) | Group.ReadWrite.All | Directory.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Group.ReadWrite.All | Directory.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 função necessária. As seguintes funções com menos privilégios são suportadas para esta operação:
Microsoft Entra função | Limitações | Permissão de função-chave |
---|---|---|
Proprietários de grupos | Pode modificar todos os tipos de proprietários de grupos | microsoft.directory/groups/owners/update |
Administrador do usuário | Só é possível modificar proprietários de utilizadores | microsoft.directory/groups/owners/update |
Escritores de diretório | Só é possível modificar proprietários de utilizadores | microsoft.directory/groups/owners/update |
Administrador do Grupos | Pode modificar todos os tipos de proprietários de grupos | microsoft.directory/groups/owners/update |
Administrador do Exchange | Só é possível modificar os proprietários de grupos do Microsoft 365 | microsoft.directory/groups.unified/owners/update |
Administrador do SharePoint | Só é possível modificar os proprietários de grupos do Microsoft 365 | microsoft.directory/groups.unified/owners/update |
Administrador do Teams | Só é possível modificar os proprietários de grupos do Microsoft 365 | microsoft.directory/groups.unified/owners/update |
Administrador do Yammer | Só é possível modificar os proprietários de grupos do Microsoft 365 | microsoft.directory/groups.unified/owners/update |
Administrador do Intune | Só é possível modificar proprietários de grupos de segurança | microsoft.directory/groups.security/owners/update |
Administrador de Conhecimento | Só é possível modificar proprietários de grupos de segurança | microsoft.directory/groups.security/owners/update |
Gerente de Conhecimento | Só é possível modificar proprietários de grupos de segurança | microsoft.directory/groups.security/owners/update |
Administrador do Windows 365 | Só é possível modificar proprietários de grupos de segurança | microsoft.directory/groups.security/owners/update |
Solicitação HTTP
POST /groups/{id}/owners/$ref
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 com o @odata.id de um objeto user ou servicePrincipal a ser adicionado
Resposta
Se tiver êxito, este método retornará um código de resposta 204 No Content
. Não devolve nada no corpo da resposta. Esse método retorna um 400 Bad Request
código de resposta quando o objeto já é um membro do grupo. Esse método retorna um 404 Not Found
código de resposta quando o objeto adicionado não existe.
Exemplo
Solicitação
O exemplo seguinte mostra um pedido que adiciona um utilizador como proprietário do grupo.
POST https://graph.microsoft.com/v1.0/groups/{id}/owners/$ref
Content-type: application/json
{
"@odata.id": "https://graph.microsoft.com/v1.0/users/{id}"
}
No corpo da solicitação, forneça uma representação JSON com o @odata.id de um objeto user ou servicePrincipal a ser adicionado.
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 204 No Content