Adicionar proprietário do grupoAdd group owner

Namespace: microsoft.graphNamespace: microsoft.graph

Adiciona um usuário aos proprietários do grupo.Add a user to the group's owners. Os proprietários são um conjunto de usuários que não são administradores e que têm permissão para alterar o objeto de grupo.The owners are a set of non-admin users who are allowed to modify the group object.

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.Important: If you update the group owners and you created a team for the group, it can take up to 2 hours for the owners to be synchronized with 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.Also, if you want the owner to be able to make changes in a team - for example, by creating a Planner plan - the owner also needs to be added as a group/team member.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Group.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllGroup.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
ApplicationApplication Group.ReadWrite.All e User.ReadWrite.AllGroup.ReadWrite.All and User.ReadWrite.All

Solicitação HTTPHTTP request

POST /groups/{id}/owners/$ref

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obrigatório.application/json. Required.

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON do objeto user a ser adicionado.In the request body, supply a JSON representation of the user object to be added.

RespostaResponse

Se bem-sucedido, este método retorna um código de resposta 204 No Content.If successful, this method returns a 204 No Content response code. Não retorna nada no corpo da resposta.It does not return anything in the response body. Esse método retorna um 400 Bad Request código de resposta quando o objeto já é um membro do grupo.This method returns a 400 Bad Request response code when the object is already a member of the group. Esse método retorna um 404 Not Found código de resposta quando o objeto adicionado não existe.This method returns a 404 Not Found response code when the object being added doesn't exist.

ExemploExample

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

POST https://graph.microsoft.com/v1.0/groups/{id}/owners/$ref
Content-type: application/json
Content-length: 30

{
  "@odata.id": "https://graph.microsoft.com/v1.0/users/{id}"
}

No corpo da solicitação, forneça uma representação JSON de um objeto user a ser adicionado.In the request body, supply a JSON representation of user object to be added.

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

Observação:  o objeto de resposta mostrado aqui pode ser encurtado por questões de legibilidade.Note: The response object shown here might be shortened for readability. Todas as propriedades serão retornadas de uma chamada real.All the properties will be returned from an actual call.

HTTP/1.1 204 No Content