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

*****************************
describe_managed_prefix_lists
*****************************



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

  

  Describes your managed prefix lists and any Amazon Web Services-managed prefix lists.

  

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


  **Request Syntax**
  ::

    response = client.describe_managed_prefix_lists(
        DryRun=True|False,
        Filters=[
            {
                'Name': 'string',
                'Values': [
                    'string',
                ]
            },
        ],
        MaxResults=123,
        NextToken='string',
        PrefixListIds=[
            'string',
        ]
    )
    
  :type DryRun: boolean
  :param DryRun: 

    Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ``DryRunOperation``. Otherwise, it is ``UnauthorizedOperation``.

    

  
  :type Filters: list
  :param Filters: 

    One or more filters.

     

    
    * ``owner-id`` - The ID of the prefix list owner.
     
    * ``prefix-list-id`` - The ID of the prefix list.
     
    * ``prefix-list-name`` - The name of the prefix list.
    

    

  
    - *(dict) --* 

      A filter name and value pair that is used to return a more specific list of results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.

       

      If you specify multiple filters, the filters are joined with an ``AND``, and the request returns only results that match all of the specified filters.

       

      For more information, see `List and filter using the CLI and API <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Filtering.html#Filtering_Resources_CLI>`__ in the *Amazon EC2 User Guide*.

      

    
      - **Name** *(string) --* 

        The name of the filter. Filter names are case-sensitive.

        

      
      - **Values** *(list) --* 

        The filter values. Filter values are case-sensitive. If you specify multiple values for a filter, the values are joined with an ``OR``, and the request returns all results that match any of the specified values.

        

      
        - *(string) --* 

        
    
    

  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned ``nextToken`` value.

    

  
  :type NextToken: string
  :param NextToken: 

    The token for the next page of results.

    

  
  :type PrefixListIds: list
  :param PrefixListIds: 

    One or more prefix list IDs.

    

  
    - *(string) --* 

    

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

    
    ::

      {
          'NextToken': 'string',
          'PrefixLists': [
              {
                  'PrefixListId': 'string',
                  'AddressFamily': 'string',
                  'State': 'create-in-progress'|'create-complete'|'create-failed'|'modify-in-progress'|'modify-complete'|'modify-failed'|'restore-in-progress'|'restore-complete'|'restore-failed'|'delete-in-progress'|'delete-complete'|'delete-failed',
                  'StateMessage': 'string',
                  'PrefixListArn': 'string',
                  'PrefixListName': 'string',
                  'MaxEntries': 123,
                  'Version': 123,
                  'Tags': [
                      {
                          'Key': 'string',
                          'Value': 'string'
                      },
                  ],
                  'OwnerId': 'string',
                  'IpamPrefixListResolverTargetId': 'string',
                  'IpamPrefixListResolverSyncEnabled': True|False
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **NextToken** *(string) --* 

        The token to use to retrieve the next page of results. This value is ``null`` when there are no more results to return.

        
      

      - **PrefixLists** *(list) --* 

        Information about the prefix lists.

        
        

        - *(dict) --* 

          Describes a managed prefix list.

          
          

          - **PrefixListId** *(string) --* 

            The ID of the prefix list.

            
          

          - **AddressFamily** *(string) --* 

            The IP address version.

            
          

          - **State** *(string) --* 

            The current state of the prefix list.

            
          

          - **StateMessage** *(string) --* 

            The state message.

            
          

          - **PrefixListArn** *(string) --* 

            The Amazon Resource Name (ARN) for the prefix list.

            
          

          - **PrefixListName** *(string) --* 

            The name of the prefix list.

            
          

          - **MaxEntries** *(integer) --* 

            The maximum number of entries for the prefix list.

            
          

          - **Version** *(integer) --* 

            The version of the prefix list.

            
          

          - **Tags** *(list) --* 

            The tags for the prefix list.

            
            

            - *(dict) --* 

              Describes a tag.

              
              

              - **Key** *(string) --* 

                The key of the tag.

                 

                Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with ``aws:``.

                
              

              - **Value** *(string) --* 

                The value of the tag.

                 

                Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters.

                
          
        
          

          - **OwnerId** *(string) --* 

            The ID of the owner of the prefix list.

            
          

          - **IpamPrefixListResolverTargetId** *(string) --* 

            The ID of the IPAM prefix list resolver target associated with this managed prefix list. When set, this prefix list becomes an IPAM managed prefix list.

             

            An IPAM-managed prefix list is a customer-managed prefix list that has been associated with an IPAM prefix list resolver target. When a prefix list becomes IPAM managed, its CIDRs are automatically synchronized based on the IPAM prefix list resolver's CIDR selection rules, and direct CIDR modifications are restricted.

            
          

          - **IpamPrefixListResolverSyncEnabled** *(boolean) --* 

            Indicates whether synchronization with an IPAM prefix list resolver is enabled for this managed prefix list. When enabled, the prefix list CIDRs are automatically updated based on the resolver's CIDR selection rules.

            
      
    
  