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

 

折り紙で作成した兜(2025/4/5撮影)
5月5日はこどもの日です。子供が困難から守られるように、鎧や兜などの防具を飾るようになったそうです。

前回、前々回までで、アプリケーションの割り当てを確認するためのAPIエンドポイントを一つずつ実行して、その結果を見てきました。結果として、どのAPIエンドポイントもアプリの割り当てに使用されたスマートグループを返答してくれました。

ところで、Workspace ONE UEMでは、アプリの割り当てにスマートグループだけでなく、組織グループも使用することができます
※「スマートグループや組織グループってなに?」という方は、本ブログでも解説記事を記載していますので、こちらもご参照くださいますと幸いです。

設定方法はとても簡単で、アプリの割り当ての時に、マウスオーバーすると出てくるリストの中から組織グループを選択するだけです。

前回と前々回試した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エンドポイントを探せていませんが。。

このブログの人気の投稿

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

■Workspace ONE UEM API Explorerについて

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