【休息日】Workspace ONE UEM の REST API をひとつひとつ試していく - 03
折り紙で作成した兜(2025/4/5撮影) 5月5日はこどもの日です。子供が困難から守られるように、鎧や兜などの防具を飾るようになったそうです。 |
前回、前々回までで、アプリケーションの割り当てを確認するためのAPIエンドポイントを一つずつ実行して、その結果を見てきました。結果として、どのAPIエンドポイントもアプリの割り当てに使用されたスマートグループを返答してくれました。
ところで、Workspace ONE UEMでは、アプリの割り当てにスマートグループだけでなく、組織グループも使用することができます
※「スマートグループや組織グループってなに?」という方は、本ブログでも解説記事を記載していますので、こちらもご参照くださいますと幸いです。
- ■Workspace ONE UEMで試してみた(5):組織グループってなんだ? - その1
- ■Workspace ONE UEMで試してみた(5):組織グループってなんだ? - その2
- ■ひっそりとWorkspace ONE UEM解説をする(1):スマートグループって何だろう?
設定方法はとても簡単で、アプリの割り当ての時に、マウスオーバーすると出てくるリストの中から組織グループを選択するだけです。
前回と前々回試したAPIのレスポンスでは、アプリの割り当て対象として選択されたグループはすべてスマートグループとして返答されましたが、組織グループを割り当てたときはどのような形で返されるのでしょうか。少しだけ気になります。
まずは「/apps/{applicationUuid}/assignment-rules」です。なお、今回は「assignment_04」として、組織グループ「01_test_company」を使用した割り当てを追加しています。
{
"assignments": [
{
"priority": 0,
"distribution": {
"name": "assignment_01",
"description": "",
"smart_groups": [
"9f097342-3882-402c-9686-ab5080840f9d"
],
"bsp_assignments": {
"smart_groups_online_licenses": [],
"smart_groups_offline_licenses": []
},
"app_delivery_method": "ON_DEMAND",
"pre_release_version": 0,
"auto_update_devices_with_previous_versions": false,
"display_in_app_catalog": false,
"requires_approval": false,
"hide_notifications": false,
"application_transforms": [],
"installer_deferral_allowed": false,
"installer_deferral_interval": 0,
"installer_deferral_exit_code": "",
"is_default_assignment": true,
"keep_app_updated_automatically": false
},
"restriction": {
"remove_on_unenroll": false,
"prevent_application_backup": false,
"make_app_mdm_managed": false,
"managed_access": false,
"desired_state_management": false,
"prevent_removal": false
},
"tunnel": {},
"application_configuration": [],
"application_attributes": [],
"is_dynamic_template_saved": false,
"is_apple_education_assignment": false,
"is_android_enterprise_config_template": false,
"app_profiles_mapping": []
},
{
"priority": 1,
"distribution": {
"name": "assignment_02",
"description": "",
"smart_groups": [
"b0edde14-0b08-44bf-97e9-9b30bb67af31"
],
"bsp_assignments": {
"smart_groups_online_licenses": [],
"smart_groups_offline_licenses": []
},
"app_delivery_method": "AUTO",
"pre_release_version": 0,
"auto_update_devices_with_previous_versions": false,
"display_in_app_catalog": false,
"requires_approval": false,
"hide_notifications": false,
"application_transforms": [],
"installer_deferral_allowed": false,
"installer_deferral_interval": 0,
"installer_deferral_exit_code": "",
"is_default_assignment": false,
"keep_app_updated_automatically": false
},
"restriction": {
"remove_on_unenroll": false,
"prevent_application_backup": false,
"make_app_mdm_managed": false,
"managed_access": false,
"desired_state_management": false,
"prevent_removal": false
},
"tunnel": {},
"application_configuration": [],
"application_attributes": [],
"is_dynamic_template_saved": false,
"is_apple_education_assignment": false,
"is_android_enterprise_config_template": false,
"app_profiles_mapping": []
},
{
"priority": 2,
"distribution": {
"name": "assignment_03",
"description": "",
"smart_groups": [
"89067e85-e24f-45c7-b31c-8c0a75456d9f"
],
"bsp_assignments": {
"smart_groups_online_licenses": [],
"smart_groups_offline_licenses": []
},
"app_delivery_method": "ON_DEMAND",
"pre_release_version": 0,
"auto_update_devices_with_previous_versions": false,
"display_in_app_catalog": false,
"requires_approval": false,
"hide_notifications": false,
"application_transforms": [],
"installer_deferral_allowed": false,
"installer_deferral_interval": 0,
"installer_deferral_exit_code": "",
"is_default_assignment": false,
"keep_app_updated_automatically": false
},
"restriction": {
"remove_on_unenroll": false,
"prevent_application_backup": false,
"make_app_mdm_managed": false,
"managed_access": false,
"desired_state_management": false,
"prevent_removal": false
},
"tunnel": {},
"application_configuration": [],
"application_attributes": [],
"is_dynamic_template_saved": false,
"is_apple_education_assignment": false,
"is_android_enterprise_config_template": false,
"app_profiles_mapping": []
},
{
"priority": 3,
"distribution": {
"name": "assignment_04",
"description": "organization group",
"smart_groups": [
"1007e50a-aaa7-497c-8cc6-c82883e86332"
],
"bsp_assignments": {
"smart_groups_online_licenses": [],
"smart_groups_offline_licenses": []
},
"app_delivery_method": "ON_DEMAND",
"pre_release_version": 0,
"auto_update_devices_with_previous_versions": false,
"display_in_app_catalog": false,
"requires_approval": false,
"hide_notifications": false,
"application_transforms": [],
"installer_deferral_allowed": false,
"installer_deferral_interval": 0,
"installer_deferral_exit_code": "",
"is_default_assignment": false,
"keep_app_updated_automatically": false
},
"restriction": {
"remove_on_unenroll": false,
"prevent_application_backup": false,
"make_app_mdm_managed": false,
"managed_access": false,
"desired_state_management": false,
"prevent_removal": false
},
"tunnel": {},
"application_configuration": [],
"application_attributes": [],
"is_dynamic_template_saved": false,
"is_apple_education_assignment": false,
"is_android_enterprise_config_template": false,
"app_profiles_mapping": []
}
],
"excluded_smart_groups": [],
"application_msi_deployment_params": {}
}
次に、「/apps/search」です。
{
"Application": [
{
"ApplicationName": "Google Chrome",
"BundleId": "com.google.chrome.ios",
"AppType": "Public",
"Status": "Active",
"Platform": 2,
"AssignmentStatus": "Assigned",
"ApplicationSize": "252.93 MB",
"CategoryList": {
"Category": []
},
"SmartGroups": [
{
"Id": 3898,
"Name": "01_test_smart_group"
},
{
"Id": 3899,
"Name": "02_test_smart_group"
},
{
"Id": 3900,
"Name": "03_test_smart_group"
},
{
"Id": 3897,
"Name": "01_test_company"
}
],
"Comments": "",
"IsReimbursable": false,
"ApplicationUrl": "https://apps.apple.com/us/app/google-chrome/id535886823",
"ApplicationSource": 1,
"LocationGroupId": 1987,
"RootLocationGroupName": "01_test_company",
"OrganizationGroupUuid": "5db9ba20-04af-4572-af19-70218bab3445",
"LargeIconUri": "https://dsXXXX.awmdm.com/DeviceServices/publicblob/8d4dc459-01f3-4909-91ce-98346d9d9b6f/BlobHandler.pblob",
"MediumIconUri": "https://dsXXXX.awmdm.com/DeviceServices/publicblob/8d4dc459-01f3-4909-91ce-98346d9d9b6f/BlobHandler.pblob",
"SmallIconUri": "https://dsXXXX.awmdm.com/DeviceServices/publicblob/8d4dc459-01f3-4909-91ce-98346d9d9b6f/BlobHandler.pblob",
"PushMode": 0,
"AppRank": 0,
"AssignedDeviceCount": 0,
"InstalledDeviceCount": 0,
"NotInstalledDeviceCount": 0,
"AutoUpdateVersion": false,
"EnableProvisioning": false,
"IsDependencyFile": false,
"ContentGatewayId": 0,
"Id": {
"Value": 3063
},
"Uuid": "5789e907-5a5c-4b53-b508-572946a6be8d"
}
],
"Page": 0,
"PageSize": 500,
"Total": 1
}
どちらのAPIエンドポイントも、割り当てに使用した組織グループ「01_test_company」をスマートグループとして返答してきました。「01_test_company」については組織グループとして割り当てグループの一覧内には表示されていますが、スマートグループとしてきちんと取り扱われるようです。
次回は、スマートグループの詳細をREST APIでクエリ可能か、試してみたいと思います。
※まだ対応するAPIエンドポイントを探せていませんが。。