batch_associate_user_stack

AppStream.Client.batch_associate_user_stack(**kwargs)

Associates the specified users with the specified stacks. Users in a user pool cannot be assigned to stacks with fleets that are joined to an Active Directory domain.

See also: AWS API Documentation

Request Syntax

response = client.batch_associate_user_stack(
    UserStackAssociations=[
        {
            'StackName': 'string',
            'UserName': 'string',
            'AuthenticationType': 'API'|'SAML'|'USERPOOL'|'AWS_AD',
            'SendEmailNotification': True|False
        },
    ]
)
Parameters
UserStackAssociations (list) --

[REQUIRED]

The list of UserStackAssociation objects.

  • (dict) --

    Describes a user in the user pool and the associated stack.

    • StackName (string) -- [REQUIRED]

      The name of the stack that is associated with the user.

    • UserName (string) -- [REQUIRED]

      The email address of the user who is associated with the stack.

      Note

      Users' email addresses are case-sensitive.

    • AuthenticationType (string) -- [REQUIRED]

      The authentication type for the user.

    • SendEmailNotification (boolean) --

      Specifies whether a welcome email is sent to a user after the user is created in the user pool.

Return type
dict
Returns
Response Syntax
{
    'errors': [
        {
            'UserStackAssociation': {
                'StackName': 'string',
                'UserName': 'string',
                'AuthenticationType': 'API'|'SAML'|'USERPOOL'|'AWS_AD',
                'SendEmailNotification': True|False
            },
            'ErrorCode': 'STACK_NOT_FOUND'|'USER_NAME_NOT_FOUND'|'DIRECTORY_NOT_FOUND'|'INTERNAL_ERROR',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --
    • errors (list) --

      The list of UserStackAssociationError objects.

      • (dict) --

        Describes the error that is returned when a user can’t be associated with or disassociated from a stack.

        • UserStackAssociation (dict) --

          Information about the user and associated stack.

          • StackName (string) --

            The name of the stack that is associated with the user.

          • UserName (string) --

            The email address of the user who is associated with the stack.

            Note

            Users' email addresses are case-sensitive.

          • AuthenticationType (string) --

            The authentication type for the user.

          • SendEmailNotification (boolean) --

            Specifies whether a welcome email is sent to a user after the user is created in the user pool.

        • ErrorCode (string) --

          The error code for the error that is returned when a user can’t be associated with or disassociated from a stack.

        • ErrorMessage (string) --

          The error message for the error that is returned when a user can’t be associated with or disassociated from a stack.

Exceptions

  • AppStream.Client.exceptions.OperationNotPermittedException
  • AppStream.Client.exceptions.InvalidParameterCombinationException