groupLifecyclePolicy: addGroup

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 de versão.

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/beta/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
}