使用 AWS 价目表批量处理 API 获取价目表文件 - AWS 账单

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 AWS 价目表批量处理 API 获取价目表文件

注意

要提供 AWS 价目表 相关的反馈，请完成这份简短调查。您的回复将是匿名的。注意：本调查仅提供英文版。

我们建议您在要执行以下任务时使用价目表批量处理 API：

  • 消耗大量的 AWS 服务 产品和定价信息。

  • 以高吞吐量消耗大量的 AWS 服务 产品和定价信息，例如批量处理。

此外，当价目表查询 API 无法为您的用例提供足够的吞吐量和限额时，请使用价目表批量处理 API。

我们建议您使用 AWS 价目表批量处理 API，以编程方式查找和下载价目表文件。要获取价目表文件的 URL，请参阅以下步骤。

如果您不想使用 AWS 价目表批量处理 API，可以手动下载价目表文件。有关更多信息，请参阅 手动获取价目表文件。

使用 DescribeServices API 操作查找价目表批量处理 API 支持的所有可用 AWS 服务。此 API 操作返回服务列表中的 ServiceCode 值。您稍后使用此值来查找相关的价目表文件。

例 示例：查找可用服务

以下命令说明如何查找可用的 AWS 服务。

aws pricing describe-services --region us-east-1

AWS 区域 是价目表批量处理 API 的端点。端点与产品或服务属性无关。

响应

{
    "FormatVersion": "aws_v1", 
    "NextToken": "abcdefg123", 
    "Services": [ 
        {
            "AttributeNames": [ 
                "volumeType", 
                "maxIopsvolume", 
                "instanceCapacity10xlarge", 
                "locationType", 
                "operation" 
            ], 
            "ServiceCode": "AmazonEC2" 
        },
        {
            "AttributeNames": [ 
                "productFamily", 
                "volumeType", 
                "engineCode", 
                "memory" 
            ], 
            "ServiceCode": "AmazonRDS" 
        },
        {...} 
    ] 
}

有关此 API 操作的更多信息，请参阅《AWS Billing and Cost Management API Reference》中的 DescribeServices 和 language-specific AWS SDKs

使用 ListPriceLists API 操作获取您有权查看的价目表参考清单。要筛选结果，您可以指定 ServiceCode、CurrencyCode、和 EffectiveDate 参数。

AWS 区域 是价目表批量处理 API 的端点。端点与产品或服务属性无关。

查找价目表文件的示例

例 示例：查找所有 AWS 区域 的价目表文件

如果您未指定 --region-code 参数，则 API 操作会返回所有可用 AWS 区域 的价目表文件参考。

aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --effective-date "2023-04-03 00:00"

响应

{
   "NextToken": "abcd1234",
   "PriceLists": [ 
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1",
         "RegionCode": "us-east-1"
      },
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2",
         "RegionCode": "us-west-2"
      },
      ...
   ]
}
例 示例：查找特定区域的价目表文件

如果您指定 RegionCode 参数，API 操作将返回该区域特定的价目表文件参考。要查找历史价目表文件，请使用 EffectiveDate 参数。例如，您可以指定过去的日期来查找特定的价目表文件。

然后，您可以从响应中将 PriceListArn 值与 GetPriceListFileUrl API 操作配合使用，以获取您的首选价目表文件。

aws pricing list-price-lists --service-code AmazonRDS --currency-code USD --region-code us-west-2 --effective-date "2023-04-03 00:00"

响应

{
   "PriceLists": [ 
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-west-2",
         "RegionCode": "us-west-2"
      }
   ]
}

有关此 API 操作的更多信息，请参阅《AWS Billing and Cost Management API Reference》中的 ListPriceLists 和 language-specific AWS SDKs。

使用 GetPriceListFileUrl API 操作获取价目表文件的 URL。此 URL 基于您在第 1 步和第 2 步中从 ListPriceLists 响应中检索到的 PriceListArn 和 FileFormats 值。

例 示例：获取特定的价目表文件

以下命令获取 Amazon RDS 特定价目表文件的 URL。

aws pricing get-price-list-file-url --price-list-arn arn:aws:pricing:::price-list/aws/AmazonRDS/USD/20230328234721/us-east-1 --file-format json --region us-east-1

响应

{
    "Url": "https://pricing.us-east-1.amazonaws.com/offers/v1.0/aws/AmazonRDS/20230328234721/us-east-1/index.json"
}

从响应中，您可以使用 URL 下载价目表文件。

有关此 API 操作的更多信息，请参阅以下主题：