:doc:`ResilienceHub <../../resiliencehub>` / Client / list_app_version_resource_mappings

**********************************
list_app_version_resource_mappings
**********************************



.. py:method:: ResilienceHub.Client.list_app_version_resource_mappings(**kwargs)

  

  Lists how the resources in an application version are mapped/sourced from. Mappings can be physical resource identifiers, CloudFormation stacks, resource-groups, or an application registry app.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/resiliencehub-2020-04-30/ListAppVersionResourceMappings>`_  


  **Request Syntax**
  ::

    response = client.list_app_version_resource_mappings(
        appArn='string',
        appVersion='string',
        maxResults=123,
        nextToken='string'
    )
    
  :type appArn: string
  :param appArn: **[REQUIRED]** 

    Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn: ``partition``:resiliencehub: ``region``: ``account``:app/ ``app-id``. For more information about ARNs, see `Amazon Resource Names (ARNs) <https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html>`__ in the *Amazon Web Services General Reference* guide.

    

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

    The version of the application.

    

  
  :type maxResults: integer
  :param maxResults: 

    Maximum number of results to include in the response. If more results exist than the specified ``MaxResults`` value, a token is included in the response so that the remaining results can be retrieved.

    

  
  :type nextToken: string
  :param nextToken: 

    Null, or the token from a previous call to get the next set of results.

    

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

    
    ::

      {
          'nextToken': 'string',
          'resourceMappings': [
              {
                  'appRegistryAppName': 'string',
                  'eksSourceName': 'string',
                  'logicalStackName': 'string',
                  'mappingType': 'CfnStack'|'Resource'|'AppRegistryApp'|'ResourceGroup'|'Terraform'|'EKS',
                  'physicalResourceId': {
                      'awsAccountId': 'string',
                      'awsRegion': 'string',
                      'identifier': 'string',
                      'type': 'Arn'|'Native'
                  },
                  'resourceGroupName': 'string',
                  'resourceName': 'string',
                  'terraformSourceName': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **nextToken** *(string) --* 

        Token for the next set of results, or null if there are no more results.

        
      

      - **resourceMappings** *(list) --* 

        Mappings used to map logical resources from the template to physical resources. You can use the mapping type ``CFN_STACK`` if the application template uses a logical stack name. Or you can map individual resources by using the mapping type ``RESOURCE``. We recommend using the mapping type ``CFN_STACK`` if the application is backed by a CloudFormation stack.

        
        

        - *(dict) --* 

          Defines a resource mapping.

          
          

          - **appRegistryAppName** *(string) --* 

            Name of the application this resource is mapped to when the ``mappingType`` is ``AppRegistryApp``.

            
          

          - **eksSourceName** *(string) --* 

            Name of the Amazon Elastic Kubernetes Service cluster and namespace that this resource is mapped to when the ``mappingType`` is ``EKS``.

             

            .. note::

              

              This parameter accepts values in "eks-cluster/namespace" format.

              

            
          

          - **logicalStackName** *(string) --* 

            Name of the CloudFormation stack this resource is mapped to when the ``mappingType`` is ``CfnStack``.

            
          

          - **mappingType** *(string) --* 

            Specifies the type of resource mapping.

            
          

          - **physicalResourceId** *(dict) --* 

            Identifier of the physical resource.

            
            

            - **awsAccountId** *(string) --* 

              The Amazon Web Services account that owns the physical resource.

              
            

            - **awsRegion** *(string) --* 

              The Amazon Web Services Region that the physical resource is located in.

              
            

            - **identifier** *(string) --* 

              Identifier of the physical resource.

              
            

            - **type** *(string) --* 

              Specifies the type of physical resource identifier.

                Arn  

              The resource identifier is an Amazon Resource Name (ARN) and it can identify the following list of resources:

               

              
              * ``AWS::ECS::Service``
               
              * ``AWS::EFS::FileSystem``
               
              * ``AWS::ElasticLoadBalancingV2::LoadBalancer``
               
              * ``AWS::Lambda::Function``
               
              * ``AWS::SNS::Topic``
              

                Native  

              The resource identifier is an Resilience Hub-native identifier and it can identify the following list of resources:

               

              
              * ``AWS::ApiGateway::RestApi``
               
              * ``AWS::ApiGatewayV2::Api``
               
              * ``AWS::AutoScaling::AutoScalingGroup``
               
              * ``AWS::DocDB::DBCluster``
               
              * ``AWS::DocDB::DBGlobalCluster``
               
              * ``AWS::DocDB::DBInstance``
               
              * ``AWS::DynamoDB::GlobalTable``
               
              * ``AWS::DynamoDB::Table``
               
              * ``AWS::EC2::EC2Fleet``
               
              * ``AWS::EC2::Instance``
               
              * ``AWS::EC2::NatGateway``
               
              * ``AWS::EC2::Volume``
               
              * ``AWS::ElasticLoadBalancing::LoadBalancer``
               
              * ``AWS::RDS::DBCluster``
               
              * ``AWS::RDS::DBInstance``
               
              * ``AWS::RDS::GlobalCluster``
               
              * ``AWS::Route53::RecordSet``
               
              * ``AWS::S3::Bucket``
               
              * ``AWS::SQS::Queue``
              

              
        
          

          - **resourceGroupName** *(string) --* 

            Name of the Resource Groups that this resource is mapped to when the ``mappingType`` is ``ResourceGroup``.

            
          

          - **resourceName** *(string) --* 

            Name of the resource that this resource is mapped to when the ``mappingType`` is ``Resource``.

            
          

          - **terraformSourceName** *(string) --* 

            Name of the Terraform source that this resource is mapped to when the ``mappingType`` is ``Terraform``.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`ResilienceHub.Client.exceptions.InternalServerException`

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

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

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

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

  