:doc:`Braket <../../braket>` / Client / get_device

**********
get_device
**********



.. py:method:: Braket.Client.get_device(**kwargs)

  

  Retrieves the devices available in Amazon Braket.

   

  .. note::

    

    For backwards compatibility with older versions of BraketSchemas, OpenQASM information is omitted from GetDevice API calls. To get this information the user-agent needs to present a recent version of the BraketSchemas (1.8.0 or later). The Braket SDK automatically reports this for you. If you do not see OpenQASM results in the GetDevice response when using a Braket SDK, you may need to set AWS_EXECUTION_ENV environment variable to configure user-agent. See the code examples provided below for how to do this for the AWS CLI, Boto3, and the Go, Java, and JavaScript/TypeScript SDKs.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/braket-2019-09-01/GetDevice>`_  


  **Request Syntax**
  ::

    response = client.get_device(
        deviceArn='string'
    )
    
  :type deviceArn: string
  :param deviceArn: **[REQUIRED]** 

    The ARN of the device to retrieve.

    

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

    
    ::

      {
          'deviceArn': 'string',
          'deviceName': 'string',
          'providerName': 'string',
          'deviceType': 'QPU'|'SIMULATOR',
          'deviceStatus': 'ONLINE'|'OFFLINE'|'RETIRED',
          'deviceCapabilities': 'string',
          'deviceQueueInfo': [
              {
                  'queue': 'QUANTUM_TASKS_QUEUE'|'JOBS_QUEUE',
                  'queueSize': 'string',
                  'queuePriority': 'Normal'|'Priority'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **deviceArn** *(string) --* 

        The ARN of the device.

        
      

      - **deviceName** *(string) --* 

        The name of the device.

        
      

      - **providerName** *(string) --* 

        The name of the partner company for the device.

        
      

      - **deviceType** *(string) --* 

        The type of the device.

        
      

      - **deviceStatus** *(string) --* 

        The status of the device.

        
      

      - **deviceCapabilities** *(string) --* 

        Details about the capabilities of the device.

        
      

      - **deviceQueueInfo** *(list) --* 

        The number of quantum tasks and hybrid jobs currently queued on the device.

        
        

        - *(dict) --* 

          Information about quantum tasks and hybrid jobs queued on a device.

          
          

          - **queue** *(string) --* 

            The name of the queue.

            
          

          - **queueSize** *(string) --* 

            The number of hybrid jobs or quantum tasks in the queue for a given device.

            
          

          - **queuePriority** *(string) --* 

            Optional. Specifies the priority of the queue. Quantum tasks in a priority queue are processed before the quantum tasks in a normal queue.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`Braket.Client.exceptions.ResourceNotFoundException`

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

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

  
  *   :py:class:`Braket.Client.exceptions.InternalServiceException`

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

  