使用批量价目表获取 Amazon 价目表文件 API - Amazon 账单
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用批量价目表获取 Amazon 价目表文件 API

注意

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

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

  • 消耗大量的 Amazon Web Services产品和定价信息。

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

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

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

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

使用该DescribeServicesAPI操作查找批量价目表API支持的所有可用 Amazon Web Services 商品。此API操作返回服务列表中的ServiceCode值。您稍后使用此值来查找相关的价目表文件。

例 示例：查找可用服务

以下命令说明如何查找可用的 Amazon Web Services。

aws pricing describe-services --region cn-northwest-1

Amazon Web Services 区域 是批量价目表的API终端节点API。端点与产品或服务属性无关。

响应

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

有关此API操作的更多信息，请参阅 “参考” 中的 “DescribeServices和特定 Amazon SDKs于语言”Amazon Billing and Cost Management API

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

Amazon Web Services 区域 是批量价目表的API终端节点API。端点与产品或服务属性无关。

查找价目表文件的示例

例 示例：查找所有人的价目表文件 Amazon Web Services 区域

如果您未指定--region-code参数，则该API操作会返回所有可用价目表文件引用 Amazon Web Services 区域。

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:cn:pricing:::price-list/cn/AmazonRDS/USD/20230328234721/cn-northwest-1",
         "RegionCode": "cn-northwest-1"
      },
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:cn:pricing:::price-list/cn/AmazonRDS/USD/20230328234721/cn-northwest-1",
         "RegionCode": "cn-northwest-1"
      },
      ...
   ]
}
例 示例：查找特定区域的价目表文件

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

然后，您可以从响应中使用该PriceListArn值进行GetPriceListFileUrlAPI操作，以获取您的首选价目表文件。

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

响应

{
   "PriceLists": [ 
      { 
         "CurrencyCode": "USD",
         "FileFormats": [ "json", "csv" ],
         "PriceListArn": "arn:cn:pricing:::price-list/cn/AmazonRDS/USD/20230328234721/cn-northwest-1",
         "RegionCode": "cn-northwest-1"
      }
   ]
}

有关此API操作的更多信息，请参阅 “参考” Amazon SDKs 中的 “ListPriceListsAmazon Billing and Cost Management API和特定于语言”。

使用GetPriceListFileUrlAPI操作获取价目表文件。URLURL这基于您在步骤 1 PriceListArn 和步骤 2 中从ListPriceLists响应中检索到的和FileFormats值

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

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

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

响应

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

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

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