WorkDocs / Client / add_resource_permissions

add_resource_permissions#

WorkDocs.Client.add_resource_permissions(**kwargs)#

Creates a set of permissions for the specified folder or document. The resource permissions are overwritten if the principals already have different permissions.

See also: AWS API Documentation

Request Syntax

response = client.add_resource_permissions(
    AuthenticationToken='string',
    ResourceId='string',
    Principals=[
        {
            'Id': 'string',
            'Type': 'USER'|'GROUP'|'INVITE'|'ANONYMOUS'|'ORGANIZATION',
            'Role': 'VIEWER'|'CONTRIBUTOR'|'OWNER'|'COOWNER'
        },
    ],
    NotificationOptions={
        'SendEmail': True|False,
        'EmailMessage': 'string'
    }
)
Parameters:
  • AuthenticationToken (string) – Amazon WorkDocs authentication token. Not required when using Amazon Web Services administrator credentials to access the API.

  • ResourceId (string) –

    [REQUIRED]

    The ID of the resource.

  • Principals (list) –

    [REQUIRED]

    The users, groups, or organization being granted permission.

    • (dict) –

      Describes the recipient type and ID, if available.

      • Id (string) – [REQUIRED]

        The ID of the recipient.

      • Type (string) – [REQUIRED]

        The type of the recipient.

      • Role (string) – [REQUIRED]

        The role of the recipient.

  • NotificationOptions (dict) –

    The notification options.

    • SendEmail (boolean) –

      Boolean value to indicate an email notification should be sent to the recipients.

    • EmailMessage (string) –

      Text value to be included in the email body.

Return type:

dict

Returns:

Response Syntax

{
    'ShareResults': [
        {
            'PrincipalId': 'string',
            'InviteePrincipalId': 'string',
            'Role': 'VIEWER'|'CONTRIBUTOR'|'OWNER'|'COOWNER',
            'Status': 'SUCCESS'|'FAILURE',
            'ShareId': 'string',
            'StatusMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    • ShareResults (list) –

      The share results.

      • (dict) –

        Describes the share results of a resource.

        • PrincipalId (string) –

          The ID of the principal.

        • InviteePrincipalId (string) –

          The ID of the invited user.

        • Role (string) –

          The role.

        • Status (string) –

          The status.

        • ShareId (string) –

          The ID of the resource that was shared.

        • StatusMessage (string) –

          The status message.

Exceptions

  • WorkDocs.Client.exceptions.UnauthorizedOperationException

  • WorkDocs.Client.exceptions.UnauthorizedResourceAccessException

  • WorkDocs.Client.exceptions.FailedDependencyException

  • WorkDocs.Client.exceptions.ServiceUnavailableException

  • WorkDocs.Client.exceptions.ProhibitedStateException