BillingandCostManagementPricingCalculator / Paginator / ListWorkloadEstimates

ListWorkloadEstimates#

class BillingandCostManagementPricingCalculator.Paginator.ListWorkloadEstimates#

paginator = client.get_paginator('list_workload_estimates')

paginate(**kwargs)#

Creates an iterator that will paginate through responses from BillingandCostManagementPricingCalculator.Client.list_workload_estimates().

Request Syntax

response_iterator = paginator.paginate(
    createdAtFilter={
        'afterTimestamp': datetime(2015, 1, 1),
        'beforeTimestamp': datetime(2015, 1, 1)
    },
    expiresAtFilter={
        'afterTimestamp': datetime(2015, 1, 1),
        'beforeTimestamp': datetime(2015, 1, 1)
    },
    filters=[
        {
            'name': 'STATUS'|'NAME',
            'values': [
                'string',
            ],
            'matchOption': 'EQUALS'|'STARTS_WITH'|'CONTAINS'
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

createdAtFilter (dict) –
Filter workload estimates based on their creation date.
- afterTimestamp (datetime) –
  
  Include results after this timestamp.
- beforeTimestamp (datetime) –
  
  Include results before this timestamp.
expiresAtFilter (dict) –
Filter workload estimates based on their expiration date.
- afterTimestamp (datetime) –
  
  Include results after this timestamp.
- beforeTimestamp (datetime) –
  
  Include results before this timestamp.
filters (list) –
Filters to apply to the list of workload estimates.
- (dict) –
  
  Represents a filter for listing workload estimates.
  - name (string) – [REQUIRED]
    
    The name of the filter attribute.
  - values (list) – [REQUIRED]
    
    The values to filter by.
    - (string) –
  - matchOption (string) –
    
    The match option for the filter (e.g., equals, contains).
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
- MaxItems (integer) –
  
  The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
- PageSize (integer) –
  
  The size of each page.
- StartingToken (string) –
  
  A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'items': [
        {
            'id': 'string',
            'name': 'string',
            'createdAt': datetime(2015, 1, 1),
            'expiresAt': datetime(2015, 1, 1),
            'rateType': 'BEFORE_DISCOUNTS'|'AFTER_DISCOUNTS',
            'rateTimestamp': datetime(2015, 1, 1),
            'status': 'UPDATING'|'VALID'|'INVALID'|'ACTION_NEEDED',
            'totalCost': 123.0,
            'costCurrency': 'USD',
            'failureMessage': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- items (list) –
  
  The list of workload estimates for the account.
  - (dict) –
    
    Provides a summary of a workload estimate.
    - id (string) –
      
      The unique identifier of the workload estimate.
    - name (string) –
      
      The name of the workload estimate.
    - createdAt (datetime) –
      
      The timestamp when the workload estimate was created.
    - expiresAt (datetime) –
      
      The timestamp when the workload estimate will expire.
    - rateType (string) –
      
      The type of pricing rates used for the estimate.
    - rateTimestamp (datetime) –
      
      The timestamp of the pricing rates used for the estimate.
    - status (string) –
      
      The current status of the workload estimate.
    - totalCost (float) –
      
      The total estimated cost for the workload.
    - costCurrency (string) –
      
      The currency of the estimated cost.
    - failureMessage (string) –
      
      An error message if the workload estimate creation or processing failed.
- NextToken (string) –
  
  A token to resume pagination.