group: assignLicense

名前空間: microsoft.graph

グループのライセンスを追加または削除します。 グループに割り当てられているライセンスは、グループ内のすべてのユーザーに割り当てられます。 グループ ベースのライセンスの詳細については、「Azure Active Directoryでのグループ ベースのライセンスとは」を参照してください。

ディレクトリで使用可能なサブスクリプションを取得するには、 GET subscribedSkus 要求を実行します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) Group.ReadWrite.All、Directory.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション Group.ReadWrite.All、Directory.ReadWrite.All

HTTP 要求

POST /groups/{id}/assignLicense

要求ヘッダー

ヘッダー
Authorization ベアラー {token}。必須。
Content-Type application/json. Required.

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター 説明
addLicenses assignedLicense コレクション 追加するライセンス を指定する assignedLicense オブジェクトのコレクション。 ライセンスに関連付けられている servicePlans を無効にするには、assignedLicense オブジェクトに disabledPlans プロパティを設定します。
removeLicenses Guid コレクション 削除するライセンスを識別する skuId のコレクション。

応答

成功した場合、このメソッドは 202 Accepted 応答コードと応答本文のターゲット グループ オブジェクトを返します。

例 1: グループにライセンスを追加する

次の例では、グループにライセンスを追加します。

要求

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": []
}

応答

応答は、更新されたグループ オブジェクトです。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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,
}

例 2: グループからライセンスを削除する

次の例では、グループからライセンスを削除します。

要求

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"
  ]
}

応答

応答は、更新されたグループ オブジェクトです。

メモ: 読みやすくするために、ここに示す応答オブジェクトが短くなる可能性があります。

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,

}