Skip to contents

Updates a group on a Tableau Server or Tableau Cloud site.

Usage

update_group(
  tableau,
  group_id,
  group_name = NULL,
  AD_group_name = NULL,
  AD_domain = NULL,
  minimum_site_role = NULL,
  license_mode = NULL,
  on_demand_access = NULL,
  asJob = FALSE,
  api_version = 3.19
)

Arguments

tableau

A list containing the Tableau authentication variables: `base_url`, `token`, and `site_id`.

group_id

The ID of the group to update.

group_name

The new name for the group (optional).

AD_group_name

The name of the Active Directory group to synchronize with (optional).

AD_domain

The domain for the Active Directory group (optional).

minimum_site_role

Required if an import element or grantLicenseMode attribute are present in the request. The site role assigned to users who are imported from Active Directory or granted a license automatically using the grant license on-sync or on-login mode.

license_mode

Optional. The mode for automatically applying licenses for group members. When the mode is onLogin, a license is granted for each group member when they log in to a site.

on_demand_access

Optional. A boolean value that is used to enable on-demand access for embedded Tableau content when the Tableau Cloud site is licensed with Embedded Analytics usage-based model.

asJob

A Boolean value indicating whether to synchronize with Active Directory as a background task (true) or synchronize immediately (false). Default is false.

api_version

The API version to use (default: 3.19).

Value

TRUE if the operation was successful, FALSE otherwise.