:doc:`CodeCommit <../../codecommit>` / Client / get_pull_request_approval_states

********************************
get_pull_request_approval_states
********************************



.. py:method:: CodeCommit.Client.get_pull_request_approval_states(**kwargs)

  

  Gets information about the approval states for a specified pull request. Approval states only apply to pull requests that have one or more approval rules applied to them.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/codecommit-2015-04-13/GetPullRequestApprovalStates>`_  


  **Request Syntax**
  ::

    response = client.get_pull_request_approval_states(
        pullRequestId='string',
        revisionId='string'
    )
    
  :type pullRequestId: string
  :param pullRequestId: **[REQUIRED]** 

    The system-generated ID for the pull request.

    

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

    The system-generated ID for the pull request revision.

    

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

    
    ::

      {
          'approvals': [
              {
                  'userArn': 'string',
                  'approvalState': 'APPROVE'|'REVOKE'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **approvals** *(list) --* 

        Information about users who have approved the pull request.

        
        

        - *(dict) --* 

          Returns information about a specific approval on a pull request.

          
          

          - **userArn** *(string) --* 

            The Amazon Resource Name (ARN) of the user.

            
          

          - **approvalState** *(string) --* 

            The state of the approval, APPROVE or REVOKE. REVOKE states are not stored.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`CodeCommit.Client.exceptions.PullRequestDoesNotExistException`

  
  *   :py:class:`CodeCommit.Client.exceptions.InvalidPullRequestIdException`

  
  *   :py:class:`CodeCommit.Client.exceptions.PullRequestIdRequiredException`

  
  *   :py:class:`CodeCommit.Client.exceptions.InvalidRevisionIdException`

  
  *   :py:class:`CodeCommit.Client.exceptions.RevisionIdRequiredException`

  
  *   :py:class:`CodeCommit.Client.exceptions.EncryptionIntegrityChecksFailedException`

  
  *   :py:class:`CodeCommit.Client.exceptions.EncryptionKeyAccessDeniedException`

  
  *   :py:class:`CodeCommit.Client.exceptions.EncryptionKeyDisabledException`

  
  *   :py:class:`CodeCommit.Client.exceptions.EncryptionKeyNotFoundException`

  
  *   :py:class:`CodeCommit.Client.exceptions.EncryptionKeyUnavailableException`

  