Tagged Groups Entity (2020/10)

All tagged groups entities are structured as follows:

entity:

  • [int] Id: A unique identifier for the tagged group instance

  • [string] Name: The name of the tagged group instance. The maximum length of this string is 50 characters.

  • [string] Rule:  Defines a tag-based expression, and based on that expression, the system will assign players to this tag. For example, an expression can select for players having a WiFi connection with 10GB of free space on an SD1 disk.

  • [bool] IsDynamic:  Whether the tagged group instance is dynamic or static. Dynamic groups get populated by players automatically. Players must be manually assigned to static groups even if a rule exists.

  • [string] Description: The customer-defined description of the tagged group. The maximum length of this string is 256 characters.

  • [bool] HasChanges:  Whether the tagged (static) group instance has changes. This indicates if changes occurred on the player side. If so, the list of matches is no longer valid and needs to be manually updated.

  • [DateTime] CreationDate: Indicates when the tagged group was created on BSN.cloud. See DateTime for more information about this data type.

  • [DateTime] LastModifiedDate: Indicates when the tagged group was last modified on BSN.cloud. See DateTime for more information about this data type.

  • [ushort] DevicesCount: The number of players that are members of the tagged group (players can be part of many groups, and groups can contain many players).

  • [DeviceHealthStatus[]] DevicesHealthStatus: Returns one of "Ok", "Warning", or  "Error", depending on the player's health

  • [DeviceInfo[]] Devices: Supported representations include:

    • [int] Id: The unique identifier for the device
    • [string] Serial:  The device serial number
  • [List<Permission>] PermissionsA list of permission object instances representing permissions rules assigned to the tagged group instance