Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

update_user

update_user(**kwargs)

Updates the specified attributes of the specified user, and grants or revokes administrative privileges to the Amazon WorkDocs site.

See also: AWS API Documentation

Request Syntax

response = client.update_user(
    AuthenticationToken='string',
    UserId='string',
    GivenName='string',
    Surname='string',
    Type='USER'|'ADMIN'|'POWERUSER'|'MINIMALUSER'|'WORKSPACESUSER',
    StorageRule={
        'StorageAllocatedInBytes': 123,
        'StorageType': 'UNLIMITED'|'QUOTA'
    },
    TimeZoneId='string',
    Locale='en'|'fr'|'ko'|'de'|'es'|'ja'|'ru'|'zh_CN'|'zh_TW'|'pt_BR'|'default',
    GrantPoweruserPrivileges='TRUE'|'FALSE'
)
Parameters
  • AuthenticationToken (string) -- Amazon WorkDocs authentication token. Not required when using Amazon Web Services administrator credentials to access the API.
  • UserId (string) --

    [REQUIRED]

    The ID of the user.

  • GivenName (string) -- The given name of the user.
  • Surname (string) -- The surname of the user.
  • Type (string) -- The type of the user.
  • StorageRule (dict) --

    The amount of storage for the user.

    • StorageAllocatedInBytes (integer) --

      The amount of storage allocated, in bytes.

    • StorageType (string) --

      The type of storage.

  • TimeZoneId (string) -- The time zone ID of the user.
  • Locale (string) -- The locale of the user.
  • GrantPoweruserPrivileges (string) -- Boolean value to determine whether the user is granted Power user privileges.
Return type

dict

Returns

Response Syntax

{
    'User': {
        'Id': 'string',
        'Username': 'string',
        'EmailAddress': 'string',
        'GivenName': 'string',
        'Surname': 'string',
        'OrganizationId': 'string',
        'RootFolderId': 'string',
        'RecycleBinFolderId': 'string',
        'Status': 'ACTIVE'|'INACTIVE'|'PENDING',
        'Type': 'USER'|'ADMIN'|'POWERUSER'|'MINIMALUSER'|'WORKSPACESUSER',
        'CreatedTimestamp': datetime(2015, 1, 1),
        'ModifiedTimestamp': datetime(2015, 1, 1),
        'TimeZoneId': 'string',
        'Locale': 'en'|'fr'|'ko'|'de'|'es'|'ja'|'ru'|'zh_CN'|'zh_TW'|'pt_BR'|'default',
        'Storage': {
            'StorageUtilizedInBytes': 123,
            'StorageRule': {
                'StorageAllocatedInBytes': 123,
                'StorageType': 'UNLIMITED'|'QUOTA'
            }
        }
    }
}

Response Structure

  • (dict) --

    • User (dict) --

      The user information.

      • Id (string) --

        The ID of the user.

      • Username (string) --

        The login name of the user.

      • EmailAddress (string) --

        The email address of the user.

      • GivenName (string) --

        The given name of the user.

      • Surname (string) --

        The surname of the user.

      • OrganizationId (string) --

        The ID of the organization.

      • RootFolderId (string) --

        The ID of the root folder.

      • RecycleBinFolderId (string) --

        The ID of the recycle bin folder.

      • Status (string) --

        The status of the user.

      • Type (string) --

        The type of user.

      • CreatedTimestamp (datetime) --

        The time when the user was created.

      • ModifiedTimestamp (datetime) --

        The time when the user was modified.

      • TimeZoneId (string) --

        The time zone ID of the user.

      • Locale (string) --

        The locale of the user.

      • Storage (dict) --

        The storage for the user.

        • StorageUtilizedInBytes (integer) --

          The amount of storage used, in bytes.

        • StorageRule (dict) --

          The storage for a user.

          • StorageAllocatedInBytes (integer) --

            The amount of storage allocated, in bytes.

          • StorageType (string) --

            The type of storage.

Exceptions

  • WorkDocs.Client.exceptions.EntityNotExistsException
  • WorkDocs.Client.exceptions.UnauthorizedOperationException
  • WorkDocs.Client.exceptions.UnauthorizedResourceAccessException
  • WorkDocs.Client.exceptions.IllegalUserStateException
  • WorkDocs.Client.exceptions.ProhibitedStateException
  • WorkDocs.Client.exceptions.FailedDependencyException
  • WorkDocs.Client.exceptions.ServiceUnavailableException
  • WorkDocs.Client.exceptions.DeactivatingLastSystemUserException
  • WorkDocs.Client.exceptions.InvalidArgumentException