groupLifecyclePolicy: addGroup

Namespace: microsoft.graph

Adiciona grupos específicos a uma política de ciclo de vida. Essa ação limita a política de ciclo de vida do grupo a um conjunto de grupos somente se a propriedade managedGroupTypes do groupLifecyclePolicy estiver definida como Selected.

Permissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Directory.ReadWrite.All

Solicitação HTTP

POST /groupLifecyclePolicies/{id}/addGroup

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório.
Content-Type application/json

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Parâmetro Tipo Descrição
groupId Cadeia de caracteres O identificador do grupo a ser acrescentado à política.

Quando a propriedade managedGroupTypes do groupLifecyclePolicy Selectedé definida como , você pode adicionar até 500 grupos à lista. Se você precisar adicionar mais de 500 grupos, a propriedade managedGroupTypes do groupLifecyclePolicy deve ser definida como All.

Somente um grupo pode ser adicionado por solicitação.

Resposta

Quando é bem-sucedido, este método retorna um código de resposta 200 OK. Se o grupo for adicionado à política, um true valor será retornado no corpo da resposta. Caso contrário, um false valor será retornado no corpo da resposta.

Exemplo

Solicitação

POST https://graph.microsoft.com/v1.0/groupLifecyclePolicies/{id}/addGroup
Content-type: application/json

{
  "groupId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
}

Resposta

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": true
}