:doc:`ServiceCatalog <../../servicecatalog>` / Client / disassociate_principal_from_portfolio

*************************************
disassociate_principal_from_portfolio
*************************************



.. py:method:: ServiceCatalog.Client.disassociate_principal_from_portfolio(**kwargs)

  

  Disassociates a previously associated principal ARN from a specified portfolio.

   

  The ``PrincipalType`` and ``PrincipalARN`` must match the ``AssociatePrincipalWithPortfolio`` call request details. For example, to disassociate an association created with a ``PrincipalARN`` of ``PrincipalType`` IAM you must use the ``PrincipalType`` IAM when calling ``DisassociatePrincipalFromPortfolio``.

   

  For portfolios that have been shared with principal name sharing enabled: after disassociating a principal, share recipient accounts will no longer be able to provision products in this portfolio using a role matching the name of the associated principal.

   

  For more information, review `associate-principal-with-portfolio <https://docs.aws.amazon.com/cli/latest/reference/servicecatalog/associate-principal-with-portfolio.html#options>`__ in the Amazon Web Services CLI Command Reference.

   

  .. note::

    

    If you disassociate a principal from a portfolio, with PrincipalType as ``IAM``, the same principal will still have access to the portfolio if it matches one of the associated principals of type ``IAM_PATTERN``. To fully remove access for a principal, verify all the associated Principals of type ``IAM_PATTERN``, and then ensure you disassociate any ``IAM_PATTERN`` principals that match the principal whose access you are removing.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/servicecatalog-2015-12-10/DisassociatePrincipalFromPortfolio>`_  


  **Request Syntax**
  ::

    response = client.disassociate_principal_from_portfolio(
        AcceptLanguage='string',
        PortfolioId='string',
        PrincipalARN='string',
        PrincipalType='IAM'|'IAM_PATTERN'
    )
    
  :type AcceptLanguage: string
  :param AcceptLanguage: 

    The language code.

     

    
    * ``jp`` - Japanese
     
    * ``zh`` - Chinese
    

    

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

    The portfolio identifier.

    

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

    The ARN of the principal (user, role, or group). This field allows an ARN with no ``accountID`` with or without wildcard characters if ``PrincipalType`` is ``IAM_PATTERN``.

    

  
  :type PrincipalType: string
  :param PrincipalType: 

    The supported value is ``IAM`` if you use a fully defined ARN, or ``IAM_PATTERN`` if you specify an ``IAM`` ARN with no AccountId, with or without wildcard characters.

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`ServiceCatalog.Client.exceptions.InvalidParametersException`

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

  