:doc:`QuickSight <../../quicksight>` / Client / update_action_connector_permissions

***********************************
update_action_connector_permissions
***********************************



.. py:method:: QuickSight.Client.update_action_connector_permissions(**kwargs)

  

  Updates the permissions for an action connector by granting or revoking access for specific users and groups. You can control who can view, use, or manage the action connector.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/quicksight-2018-04-01/UpdateActionConnectorPermissions>`_  


  **Request Syntax**
  ::

    response = client.update_action_connector_permissions(
        AwsAccountId='string',
        ActionConnectorId='string',
        GrantPermissions=[
            {
                'Principal': 'string',
                'Actions': [
                    'string',
                ]
            },
        ],
        RevokePermissions=[
            {
                'Principal': 'string',
                'Actions': [
                    'string',
                ]
            },
        ]
    )
    
  :type AwsAccountId: string
  :param AwsAccountId: **[REQUIRED]** 

    The Amazon Web Services account ID that contains the action connector.

    

  
  :type ActionConnectorId: string
  :param ActionConnectorId: **[REQUIRED]** 

    The unique identifier of the action connector whose permissions you want to update.

    

  
  :type GrantPermissions: list
  :param GrantPermissions: 

    The permissions to grant to users and groups for this action connector.

    

  
    - *(dict) --* 

      Permission for the resource.

      

    
      - **Principal** *(string) --* **[REQUIRED]** 

        The Amazon Resource Name (ARN) of the principal. This can be one of the following:

         

        
        * The ARN of an Quick Sight user or group associated with a data source or dataset. (This is common.)
         
        * The ARN of an Quick Sight user, group, or namespace associated with an analysis, dashboard, template, or theme. Namespace sharing is not supported for action connectors. (This is common.)
         
        * The ARN of an Amazon Web Services account root: This is an IAM ARN rather than a Quick Sight ARN. Use this option only to share resources (templates) across Amazon Web Services accounts. Account root sharing is not supported for action connectors. (This is less common.)
        

        

      
      - **Actions** *(list) --* **[REQUIRED]** 

        The IAM action to grant or revoke permissions on.

        

      
        - *(string) --* 

        
    
    

  :type RevokePermissions: list
  :param RevokePermissions: 

    The permissions to revoke from users and groups for this action connector.

    

  
    - *(dict) --* 

      Permission for the resource.

      

    
      - **Principal** *(string) --* **[REQUIRED]** 

        The Amazon Resource Name (ARN) of the principal. This can be one of the following:

         

        
        * The ARN of an Quick Sight user or group associated with a data source or dataset. (This is common.)
         
        * The ARN of an Quick Sight user, group, or namespace associated with an analysis, dashboard, template, or theme. Namespace sharing is not supported for action connectors. (This is common.)
         
        * The ARN of an Amazon Web Services account root: This is an IAM ARN rather than a Quick Sight ARN. Use this option only to share resources (templates) across Amazon Web Services accounts. Account root sharing is not supported for action connectors. (This is less common.)
        

        

      
      - **Actions** *(list) --* **[REQUIRED]** 

        The IAM action to grant or revoke permissions on.

        

      
        - *(string) --* 

        
    
    

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

    
    ::

      {
          'Arn': 'string',
          'ActionConnectorId': 'string',
          'RequestId': 'string',
          'Status': 123,
          'Permissions': [
              {
                  'Principal': 'string',
                  'Actions': [
                      'string',
                  ]
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Arn** *(string) --* 

        The Amazon Resource Name (ARN) of the action connector.

        
      

      - **ActionConnectorId** *(string) --* 

        The unique identifier of the action connector.

        
      

      - **RequestId** *(string) --* 

        The Amazon Web Services request ID for this operation.

        
      

      - **Status** *(integer) --* 

        The HTTP status code of the request.

        
      

      - **Permissions** *(list) --* 

        The updated permissions configuration for the action connector.

        
        

        - *(dict) --* 

          Permission for the resource.

          
          

          - **Principal** *(string) --* 

            The Amazon Resource Name (ARN) of the principal. This can be one of the following:

             

            
            * The ARN of an Quick Sight user or group associated with a data source or dataset. (This is common.)
             
            * The ARN of an Quick Sight user, group, or namespace associated with an analysis, dashboard, template, or theme. Namespace sharing is not supported for action connectors. (This is common.)
             
            * The ARN of an Amazon Web Services account root: This is an IAM ARN rather than a Quick Sight ARN. Use this option only to share resources (templates) across Amazon Web Services accounts. Account root sharing is not supported for action connectors. (This is less common.)
            

            
          

          - **Actions** *(list) --* 

            The IAM action to grant or revoke permissions on.

            
            

            - *(string) --* 
        
      
    
  
  **Exceptions**
  
  *   :py:class:`QuickSight.Client.exceptions.ThrottlingException`

  
  *   :py:class:`QuickSight.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`QuickSight.Client.exceptions.InternalFailureException`

  
  *   :py:class:`QuickSight.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`QuickSight.Client.exceptions.UnsupportedUserEditionException`

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

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

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

  