:doc:`FinSpaceData <../../finspace-data>` / Client / create_permission_group

***********************
create_permission_group
***********************



.. py:method:: FinSpaceData.Client.create_permission_group(**kwargs)

  

  Creates a group of permissions for various actions that a user can perform in FinSpace.

  

  .. danger::

        This operation is deprecated and may not function as expected. This operation should not be used going forward and is only kept for the purpose of backwards compatiblity.


  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/finspace-2020-07-13/CreatePermissionGroup>`_  


  **Request Syntax**
  ::

    response = client.create_permission_group(
        name='string',
        description='string',
        applicationPermissions=[
            'CreateDataset'|'ManageClusters'|'ManageUsersAndGroups'|'ManageAttributeSets'|'ViewAuditData'|'AccessNotebooks'|'GetTemporaryCredentials',
        ],
        clientToken='string'
    )
    
  :type name: string
  :param name: **[REQUIRED]** 

    The name of the permission group.

    

  
  :type description: string
  :param description: 

    A brief description for the permission group.

    

  
  :type applicationPermissions: list
  :param applicationPermissions: **[REQUIRED]** 

    The option to indicate FinSpace application permissions that are granted to a specific group.

     

    .. warning::

       

      When assigning application permissions, be aware that the permission ``ManageUsersAndGroups`` allows users to grant themselves or others access to any functionality in their FinSpace environment's application. It should only be granted to trusted users.

       

     

    
    * ``CreateDataset`` – Group members can create new datasets.
     
    * ``ManageClusters`` – Group members can manage Apache Spark clusters from FinSpace notebooks.
     
    * ``ManageUsersAndGroups`` – Group members can manage users and permission groups. This is a privileged permission that allows users to grant themselves or others access to any functionality in the application. It should only be granted to trusted users.
     
    * ``ManageAttributeSets`` – Group members can manage attribute sets.
     
    * ``ViewAuditData`` – Group members can view audit data.
     
    * ``AccessNotebooks`` – Group members will have access to FinSpace notebooks.
     
    * ``GetTemporaryCredentials`` – Group members can get temporary API credentials.
    

    

  
    - *(string) --* 

    

  :type clientToken: string
  :param clientToken: 

    A token that ensures idempotency. This token expires in 10 minutes.

    This field is autopopulated if not provided.

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'permissionGroupId': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **permissionGroupId** *(string) --* 

        The unique identifier for the permission group.

        
  
  **Exceptions**
  
  *   :py:class:`FinSpaceData.Client.exceptions.InternalServerException`

  
  *   :py:class:`FinSpaceData.Client.exceptions.ValidationException`

  
  *   :py:class:`FinSpaceData.Client.exceptions.ThrottlingException`

  
  *   :py:class:`FinSpaceData.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`FinSpaceData.Client.exceptions.LimitExceededException`

  
  *   :py:class:`FinSpaceData.Client.exceptions.ConflictException`

  