get_attribute_values

get_attribute_values(**kwargs)

Returns a list of attribute values. Attributes are similar to the details in a Price List API offer file. For a list of available attributes, see Offer File Definitions in the Billing and Cost Management User Guide.

See also: AWS API Documentation

Request Syntax

response = client.get_attribute_values(
    ServiceCode='string',
    AttributeName='string',
    NextToken='string',
    MaxResults=123
)
Parameters
  • ServiceCode (string) --

    [REQUIRED]

    The service code for the service whose attributes you want to retrieve. For example, if you want the retrieve an EC2 attribute, use AmazonEC2 .

  • AttributeName (string) --

    [REQUIRED]

    The name of the attribute that you want to retrieve the values for, such as volumeType .

  • NextToken (string) -- The pagination token that indicates the next set of results that you want to retrieve.
  • MaxResults (integer) -- The maximum number of results to return in response.
Return type

dict

Returns

Response Syntax

{
    'AttributeValues': [
        {
            'Value': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • AttributeValues (list) --

      The list of values for an attribute. For example, Throughput Optimized HDD and Provisioned IOPS are two available values for the AmazonEC2 volumeType .

      • (dict) --

        The values of a given attribute, such as Throughput Optimized HDD or Provisioned IOPS for the Amazon EC2 volumeType attribute.

        • Value (string) --

          The specific value of an attributeName .

    • NextToken (string) --

      The pagination token that indicates the next set of results to retrieve.

Exceptions

  • Pricing.Client.exceptions.InternalErrorException
  • Pricing.Client.exceptions.InvalidParameterException
  • Pricing.Client.exceptions.NotFoundException
  • Pricing.Client.exceptions.InvalidNextTokenException
  • Pricing.Client.exceptions.ExpiredNextTokenException

Examples

This operation returns a list of values available for the given attribute.

response = client.get_attribute_values(
    AttributeName='volumeType',
    MaxResults=2,
    ServiceCode='AmazonEC2',
)

print(response)

Expected Output:

{
    'AttributeValues': [
        {
            'Value': 'Throughput Optimized HDD',
        },
        {
            'Value': 'Provisioned IOPS',
        },
    ],
    'NextToken': 'GpgauEXAMPLEezucl5LV0w==:7GzYJ0nw0DBTJ2J66EoTIIynE6O1uXwQtTRqioJzQadBnDVgHPzI1en4BUQnPCLpzeBk9RQQAWaFieA4+DapFAGLgk+Z/9/cTw9GldnPOHN98+FdmJP7wKU3QQpQ8MQr5KOeBkIsAqvAQYdL0DkL7tHwPtE5iCEByAmg9gcC/yBU1vAOsf7R3VaNN4M5jMDv3woSWqASSIlBVB6tgW78YL22KhssoItM/jWW+aP6Jqtq4mldxp/ct6DWAl+xLFwHU/CbketimPPXyqHF3/UXDw==',
    'ResponseMetadata': {
        '...': '...',
    },
}