Skip to main content

groups

Creates, updates, deletes, gets or lists a groups resource.

Overview

Namegroups
TypeResource
Idaws.workdocs.groups

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringThe ID of the user group. (pattern: <code>[&\w+-.@]+</code>)
namestringThe name of the group.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_groupsselectsearchQuery, regionAuthentication, organizationId, marker, limitDescribes the groups specified by the query. Groups are defined by the underlying Active Directory.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
searchQuerystringA query to describe groups by group name.
AuthenticationstringAmazon WorkDocs authentication token. Not required when using Amazon Web Services administrator credentials to access the API.
limitintegerThe maximum number of items to return with this call.
markerstringThe marker for the next set of results. (You received this marker from a previous call.)
organizationIdstringThe ID of the organization.

SELECT examples

Describes the groups specified by the query. Groups are defined by the underlying Active Directory.

SELECT
id,
name
FROM aws.workdocs.groups
WHERE searchQuery = '{{ searchQuery }}' -- required
AND region = '{{ region }}' -- required
AND Authentication = '{{ Authentication }}'
AND organizationId = '{{ organizationId }}'
AND marker = '{{ marker }}'
AND limit = '{{ limit }}'
;