:doc:`BedrockRuntime <../../bedrock-runtime>` / Client / get_async_invoke

****************
get_async_invoke
****************



.. py:method:: BedrockRuntime.Client.get_async_invoke(**kwargs)

  

  Retrieve information about an asynchronous invocation.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/bedrock-runtime-2023-09-30/GetAsyncInvoke>`_  


  **Request Syntax**
  ::

    response = client.get_async_invoke(
        invocationArn='string'
    )
    
  :type invocationArn: string
  :param invocationArn: **[REQUIRED]** 

    The invocation's ARN.

    

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

    
    ::

      {
          'invocationArn': 'string',
          'modelArn': 'string',
          'clientRequestToken': 'string',
          'status': 'InProgress'|'Completed'|'Failed',
          'failureMessage': 'string',
          'submitTime': datetime(2015, 1, 1),
          'lastModifiedTime': datetime(2015, 1, 1),
          'endTime': datetime(2015, 1, 1),
          'outputDataConfig': {
              's3OutputDataConfig': {
                  's3Uri': 'string',
                  'kmsKeyId': 'string',
                  'bucketOwner': 'string'
              }
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **invocationArn** *(string) --* 

        The invocation's ARN.

        
      

      - **modelArn** *(string) --* 

        The invocation's model ARN.

        
      

      - **clientRequestToken** *(string) --* 

        The invocation's idempotency token.

        
      

      - **status** *(string) --* 

        The invocation's status.

        
      

      - **failureMessage** *(string) --* 

        An error message.

        
      

      - **submitTime** *(datetime) --* 

        When the invocation request was submitted.

        
      

      - **lastModifiedTime** *(datetime) --* 

        The invocation's last modified time.

        
      

      - **endTime** *(datetime) --* 

        When the invocation ended.

        
      

      - **outputDataConfig** *(dict) --* 

        Output data settings.

        .. note::    This is a Tagged Union structure. Only one of the     following top level keys will be set: ``s3OutputDataConfig``.     If a client receives an unknown member it will     set ``SDK_UNKNOWN_MEMBER`` as the top level key,     which maps to the name or tag of the unknown     member. The structure of ``SDK_UNKNOWN_MEMBER`` is     as follows::

                'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}


      
        

        - **s3OutputDataConfig** *(dict) --* 

          A storage location for the output data in an S3 bucket

          
          

          - **s3Uri** *(string) --* 

            An object URI starting with ``s3://``.

            
          

          - **kmsKeyId** *(string) --* 

            A KMS encryption key ID.

            
          

          - **bucketOwner** *(string) --* 

            If the bucket belongs to another AWS account, specify that account's ID.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`BedrockRuntime.Client.exceptions.AccessDeniedException`

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

  
  *   :py:class:`BedrockRuntime.Client.exceptions.InternalServerException`

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

  