group: assignLicense

Namespace: microsoft.graph

Adicione ou remova licenças no grupo. As licenças atribuídas ao grupo serão atribuídas a todos os usuários no grupo. Para saber mais sobre o licenciamento baseado em grupo, confira O que é o licenciamento baseado em grupo no Azure Active Directory.

Para obter as assinaturas disponíveis no diretório, execute uma solicitação GET subscribedSkus.

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) Group.ReadWrite.All, Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Group.ReadWrite.All, Directory.ReadWrite.All

Solicitação HTTP

POST /groups/{id}/assignLicense

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório.
Content-Type application/json. Obrigatório.

Corpo da solicitação

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

Parâmetro Tipo Descrição
addLicenses Coleção assignedLicense Uma coleção de objetos assignedLicense que especifica as licenças a adicionar. Você pode desabilitar servicePlans associado a uma licença definindo a propriedade disabledPlans em um objeto assignedLicense .
removeLicenses Coleção de GUIDs Uma coleção de skuIds que identificam as licenças a serem removidas.

Resposta

Se tiver êxito, este método retornará um código 202 Accepted de resposta e um objeto de grupo de destino no corpo da resposta.

Exemplos

Exemplo 1: Adicionar licenças ao grupo

O exemplo a seguir adiciona licenças ao grupo.

Solicitação

POST https://graph.microsoft.com/v1.0/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/assignLicense
Content-type: application/json

{
  "addLicenses": [
    {
      "disabledPlans": [
        "113feb6c-3fe4-4440-bddc-54d774bf0318",
        "14ab5db5-e6c4-4b20-b4bc-13e36fd2227f"
      ],
      "skuId": "b05e124f-c7cc-45a0-a6aa-8cf78c946968"
    },
    {
      "disabledPlans": [
        "a413a9ff-720c-4822-98ef-2f37c2a21f4c"
      ],
      "skuId": "c7df2760-2c81-4ef7-b578-5b5392b571df"
    }
  ],
  "removeLicenses": []
}

Resposta

A resposta é o objeto de grupo atualizado.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 202 Accepted
Content-type: application/json
location: https://graph.microsoft.com/v2/e8e96c2a-d787-4eb1-98d7-9e57c965f1de/directoryObjects/1132b215-826f-42a9-8cfe-1643d19d17fd/Microsoft.DirectoryServices.Group

{
  "id": "1132b215-826f-42a9-8cfe-1643d19d17fd",
  "createdDateTime": "2021-03-12T11:15:03Z",
  "groupTypes": [],
  "securityEnabled": true,
}

Exemplo 2: Remover licenças do grupo

O exemplo a seguir remove licenças do grupo.

Solicitação

POST https://graph.microsoft.com/v1.0/groups/1132b215-826f-42a9-8cfe-1643d19d17fd/assignLicense
Content-type: application/json

{
  "addLicenses": [],
  "removeLicenses": [
    "c7df2760-2c81-4ef7-b578-5b5392b571df",
    "b05e124f-c7cc-45a0-a6aa-8cf78c946968"
  ]
}

Resposta

A resposta é o objeto de grupo atualizado.

Nota: O objeto de resposta mostrado aqui pode ser reduzido para legibilidade..

HTTP/1.1 202 Accepted
Content-type: application/json
location: https://graph.microsoft.com/v2/d056d009-17b3-4106-8173-cd3978ada898/directoryObjects/1ad75eeb-7e5a-4367-a493-9214d90d54d0/Microsoft.DirectoryServices.Group


{
  "id": "1ad75eeb-7e5a-4367-a493-9214d90d54d0",
  "deletedDateTime": null,
  "classification": null,
  "createdDateTime": "2018-04-18T22:05:03Z",
  "securityEnabled": true,

}