:doc:`EC2 <../../ec2>` / Client / get_instance_tpm_ek_pub

***********************
get_instance_tpm_ek_pub
***********************



.. py:method:: EC2.Client.get_instance_tpm_ek_pub(**kwargs)

  

  Gets the public endorsement key associated with the Nitro Trusted Platform Module (NitroTPM) for the specified instance.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ec2-2016-11-15/GetInstanceTpmEkPub>`_  


  **Request Syntax**
  ::

    response = client.get_instance_tpm_ek_pub(
        InstanceId='string',
        KeyType='rsa-2048'|'ecc-sec-p384',
        KeyFormat='der'|'tpmt',
        DryRun=True|False
    )
    
  :type InstanceId: string
  :param InstanceId: **[REQUIRED]** 

    The ID of the instance for which to get the public endorsement key.

    

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

    The required public endorsement key type.

    

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

    The required public endorsement key format. Specify ``der`` for a DER-encoded public key that is compatible with OpenSSL. Specify ``tpmt`` for a TPM 2.0 format that is compatible with tpm2-tools. The returned key is base64 encoded.

    

  
  :type DryRun: boolean
  :param DryRun: 

    Specify this parameter to verify whether the request will succeed, without actually making the request. If the request will succeed, the response is ``DryRunOperation``. Otherwise, the response is ``UnauthorizedOperation``.

    

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

    
    ::

      {
          'InstanceId': 'string',
          'KeyType': 'rsa-2048'|'ecc-sec-p384',
          'KeyFormat': 'der'|'tpmt',
          'KeyValue': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **InstanceId** *(string) --* 

        The ID of the instance.

        
      

      - **KeyType** *(string) --* 

        The public endorsement key type.

        
      

      - **KeyFormat** *(string) --* 

        The public endorsement key format.

        
      

      - **KeyValue** *(string) --* 

        The public endorsement key material.

        
  