【休息日】Workspace ONE UEM の REST API をひとつひとつ試していく - 04

隅田川から見た夜桜と東京スカイツリー(2025/4/7撮影)
日本のEUCコミュニティのイベント「Japan EUC Nexus April Meeting - Let's meet & talk to Omnissa in person!」の懇親会で乗った屋形船から撮影した夜景です。船の揺れもあったせいか、スカイツリーの後ろに見えた星明りも少しぶれてしまいました。

REST APIの名称にかけて、【休息日】とタグをつけたこのシリーズも4回目になりました。今のところ毎週末の休日である土日につつがなくブログの更新を乗せることができています。
本当はいろいろ試してみたいAPIや、Workspace ONE UEMだけでなく、ほかの製品のREST APIも試してみたいと思っているのですが、焦らずこのペースを続けていければいいなと考えています。

前回、私は「スマートグループの詳細をREST APIでクエリ可能か、試してみたい」とブログに書きました。

今回は、以下のAPIエンドポイントにアクセスしてみます。

「/smartgroups/{id}」

このAPIエンドポイントのクエリに必要なのは、Int32(数字)で表現されたSmartGroupのIDです。 このIDは、実は前回実行した「/apps/search」の返答に含まれています。

こちらは前回記載したブログをスクリーンショットした画像です。
下の方にSmartGroupsとあり、名前とIDが記載されています。

さっそく実行してみたところ、以下のような返答が返ってきました。
オレンジ色の箇所が、スマートグループの構成要素を表現した箇所です。

{
  "Name": "03_test_smart_group",
  "SmartGroupID": 3900,
  "SmartGroupUuid": "89067e85-e24f-45c7-b31c-8c0a75456d9f",
  "CriteriaType": "All",
  "ManagedByOrganizationGroupId": "1987",
  "ManagedByOrganizationGroupUuid": "5db9ba20-04af-4572-af19-70218bab3445",
  "ManagedByOrganizationGroupName": "01_test_company",
  "Devices": 0,
  "Assignments": 1,
  "Exclusions": 0,
  "OrganizationGroups": [],
  "UserGroups": [
    {
      "Name": "03_test_user_group",
      "Id": "608"
    }
  ],
  "Tags": [],
  "Ownerships": [
    "allownerships"
  ],
  "Platforms": [],
  "Models": [],
  "OperatingSystems": [],
  "UserAdditions": [],
  "DeviceAdditions": [],
  "UserExclusions": [],
  "DeviceExclusions": [],
  "UserGroupExclusions": [],
  "ManagementTypes": [],
  "EnrollmentCategories": [],
  "OEMAndModels": [],
  "CpuArchitectures": []
}

では、組織グループとして表示されていたスマートグループはどうでしょうか。

{
  "Name": "01_test_company",
  "SmartGroupID": 3897,
  "SmartGroupUuid": "1007e50a-aaa7-497c-8cc6-c82883e86332",
  "CriteriaType": "All",
  "ManagedByOrganizationGroupId": "1987",
  "ManagedByOrganizationGroupUuid": "5db9ba20-04af-4572-af19-70218bab3445",
  "ManagedByOrganizationGroupName": "01_test_company",
  "Devices": 0,
  "Assignments": 0,
  "Exclusions": 0,
  "OrganizationGroups": [
    {
      "Name": "01_test_company",
      "Id": "1987",
      "Uuid": "5db9ba20-04af-4572-af19-70218bab3445"
    }
  ],
  "UserGroups": [],
  "Tags": [],
  "Ownerships": [
    "allownerships"
  ],
  "Platforms": [],
  "Models": [],
  "OperatingSystems": [],
  "UserAdditions": [],
  "DeviceAdditions": [],
  "UserExclusions": [],
  "DeviceExclusions": [],
  "UserGroupExclusions": [],
  "ManagementTypes": [],
  "EnrollmentCategories": [],
  "OEMAndModels": [],
  "CpuArchitectures": []
}

同様に、スマートグループとしてきちんと構成要素を返答してくれました。返答をよく見てみると、組織グループだけが構成要素のスマートグループとして構成されていることがわかります。私は明示的な操作でこのスマートグループを作成していないので、どうやら組織グループを作成すると同時に、自動で作られているようです。

ここまでで、アプリの割り当てからその割り当てに使用されたスマートグループの詳細を確認することができました。ただし、詳細なアプリの割り当てを取得することができるAPIエンドポイント「/apps/{applicationUuid}/assignment-rules」のレスポンスは、Int32で表現されたスマートグループのIDではなく、スマートグループのUDIDの方で返答が返ってきます。
今回試したAPIエンドポイントはスマートグループのUDIDをキーにしてスマートグループ名を取得するものではないので、残念ながら、「/apps/{applicationUuid}/assignment-rules」を実行したときに得られるスマートグループのUDIDをもとにして、アプリがどのスマートグループに割り当てられているかを確認することはできません。
次回はこの課題に対して利用できると思われる、スマートグループの一覧を取得可能なAPIエンドポイントを試して実行してみます。

このブログの人気の投稿

Microsoft Graph PowerShellモジュールでMicrosoft 365の認証をWorkspace ONE Accessにフェデレーションする

■Workspace ONE UEM API Explorerについて

●久々にESXiのカスタムISOをつくってみた