WorkMail / Client / describe_group

describe_group#

WorkMail.Client.describe_group(**kwargs)#

Returns the data available for the group.

See also: AWS API Documentation

Request Syntax

response = client.describe_group(
    OrganizationId='string',
    GroupId='string'
)
Parameters:
  • OrganizationId (string) –

    [REQUIRED]

    The identifier for the organization under which the group exists.

  • GroupId (string) –

    [REQUIRED]

    The identifier for the group to be described.

    The identifier can accept GroupId, Groupname, or email. The following identity formats are available:

    • Group ID: 12345678-1234-1234-1234-123456789012 or S-1-1-12-1234567890-123456789-123456789-1234

    • Email address: group@domain.tld

    • Group name: group

Return type:

dict

Returns:

Response Syntax

{
    'GroupId': 'string',
    'Name': 'string',
    'Email': 'string',
    'State': 'ENABLED'|'DISABLED'|'DELETED',
    'EnabledDate': datetime(2015, 1, 1),
    'DisabledDate': datetime(2015, 1, 1),
    'HiddenFromGlobalAddressList': True|False
}

Response Structure

  • (dict) –

    • GroupId (string) –

      The identifier of the described group.

    • Name (string) –

      The name of the described group.

    • Email (string) –

      The email of the described group.

    • State (string) –

      The state of the user: enabled (registered to WorkMail) or disabled (deregistered or never registered to WorkMail).

    • EnabledDate (datetime) –

      The date and time when a user was registered to WorkMail, in UNIX epoch time format.

    • DisabledDate (datetime) –

      The date and time when a user was deregistered from WorkMail, in UNIX epoch time format.

    • HiddenFromGlobalAddressList (boolean) –

      If the value is set to true, the group is hidden from the address book.

Exceptions

  • WorkMail.Client.exceptions.EntityNotFoundException

  • WorkMail.Client.exceptions.InvalidParameterException

  • WorkMail.Client.exceptions.OrganizationNotFoundException

  • WorkMail.Client.exceptions.OrganizationStateException