AWS Price List Bulk API を使用した料金表ファイルの取得 - AWS 請求

AWS Price List Bulk API を使用した料金表ファイルの取得

注記

AWS の料金表 に関するフィードバックをお寄せいただく場合は、こちらの簡単なアンケートにご回答ください。回答者は匿名になります。注: このアンケートは英語にのみ対応しています。

以下のタスクを実行する場合は、Price List Bulk API を使用することをお勧めします。

  • AWS のサービスの製品情報や料金情報を大量に処理する。

  • 一括処理など、AWS のサービスで高スループットで製品および料金情報を処理する。

また、Price List Query API ではユースケースに十分なスループットとクォータが得られない場合も、Price List Bulk API を使用します。

AWS Price List Bulk API を使用して、料金表ファイルをプログラムで検索してダウンロードすることをお勧めします。料金表ファイルの URL を取得するには、次の手順を参照してください。

AWS Price List Bulk API を使用しない場合は、料金表ファイルを手動でダウンロードできます。詳細については、「料金表ファイルの手動取得」を参照してください。

DescribeServices API オペレーションを使用して、Price List Bulk API がサポートする利用可能な AWS のサービスをすべて検索します。この API オペレーションは、サービスのリストから ServiceCode 値を返します。後でこの値を使用して、関連する料金表ファイルを検索します。

例: 利用可能なサービスの検索

次のコマンドは、利用可能な AWS のサービスの検索方法を示しています。

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

AWS リージョンは Price List Bulk API の 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 リファレンスの「DescribeServices」および「各言語の AWS SDK」を参照してください。

ListPriceLists API オペレーションを使用して、表示権限のある料金表参照リストを取得します。結果を絞り込む場合は、ServiceCode、CurrencyCode、および EffectiveDate パラメータを指定します。

AWS リージョンは Price List Bulk API の 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 リファレンスの「ListPriceLists」および「各言語の AWS SDK」を参照してください。

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 オペレーションの詳細については、次のトピックを参照してください。