Preislistendateien mit der AWS Price List Bulk API abrufen - AWS Fakturierung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Preislistendateien mit der AWS Price List Bulk API abrufen

Füllen Sie diese kurze Umfrage aus AWS-Preisliste, um Feedback dazu zu geben. Ihre Antworten bleiben anonym. Hinweis: Diese Umfrage ist nur auf Englisch verfügbar.

Wir empfehlen die Verwendung der Preislisten-Bulk-API, wenn Sie die folgenden Aufgaben ausführen möchten:

  • Verwenden Sie große Mengen an Produkt- und Preisinformationen für AWS-Services.

  • Verwenden Sie Produkt- und Preisinformationen mit hohem Durchsatz für einen AWS-Service, z. B. die Verarbeitung in großen Mengen.

Wenn die Preislisten-Abfrage-API nicht ausreichend Durchsatz und Kontingente für Ihren Anwendungsfall bietet, verwenden Sie außerdem die Preislisten-Massen-API.

Wir empfehlen Ihnen, die AWS Price List Bulk API zu verwenden, um Preislistendateien programmgesteuert zu finden und herunterzuladen. Gehen Sie wie folgt vor, um die URL der Preislistendateien abzurufen.

Wenn Sie die AWS Price List Bulk API nicht verwenden möchten, können Sie die Preislistendateien manuell herunterladen. Weitere Informationen finden Sie unter Manuelles Abrufen von Preislistendateien.

Verwenden Sie den DescribeServices-API-Vorgang, um alle verfügbaren AWS-Services zu finden, die von der Preislisten-Bulk-API unterstützt werden. Dieser API-Vorgang gibt den ServiceCode-Wert aus der Liste der Services zurück. Mithilfe dieses Werts können Sie später nach relevanten Preislistendateien suchen.

Beispiel: Nach verfügbaren Services suchen

Der folgende Befehl zeigt, wie Sie nach verfügbaren AWS-Services suchen können.

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

Das AWS-Region ist der API-Endpunkt für die Price List Bulk API. Die Endpunkte stehen in keinem Zusammenhang mit Produkt- oder Serviceattributen.

Antwort

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

Weitere Informationen zu diesem API-Vorgang finden Sie unter DescribeServicesund sprachspezifisch AWS SDKs in der AWS Fakturierung und Kostenmanagement API-Referenz

Verwenden Sie den ListPriceLists-API-Vorgang, um eine Liste der Preislistenreferenzen abzurufen, für deren Anzeige Sie berechtigt sind. Zum Filtern Ihrer Ergebnisse können Sie die ServiceCode-, CurrencyCode- und EffectiveDate-Parameter angeben.

Das AWS-Region ist der API-Endpunkt für die Price List Bulk API. Die Endpunkte stehen in keinem Zusammenhang mit Produkt- oder Serviceattributen.

Beispiele für die Suche nach Preislistendateien

Beispiel: Suchen Sie nach Preislistendateien für alle AWS-Regionen

Wenn Sie den --region-code-Parameter nicht angeben, gibt der API-Vorgang Preislistendateireferenzen von allen verfügbaren AWS-Regionen zurück. 

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

Antwort

{
   "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"
      },
      ...
   ]
}
Beispiel: Suchen nach Preislistendateien für eine bestimmte Region

Wenn Sie den RegionCode-Parameter angeben, gibt der API-Vorgang Preislistendateireferenzen zurück, die für diese Region spezifisch sind. Verwenden Sie den EffectiveDate-Parameter, um historische Preislistendateien zu finden. Sie können beispielsweise ein Datum in der Vergangenheit angeben, um nach einer bestimmte Preislistendatei zu suchen.

Aus der Antwort können Sie dann den PriceListArn-Wert mit dem GetPriceListFileUrl-API-Vorgang verwenden, um Ihre bevorzugten Preislistendateien abzurufen.

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

Antwort

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

Weitere Informationen zu diesem API-Vorgang finden Sie unter ListPriceListsund sprachspezifisch AWS SDKs in der AWS Fakturierung und Kostenmanagement API-Referenz.

Verwenden Sie den API-Vorgang GetPriceListFileUrl, um eine URL für eine Preislistendatei abzurufen. Diese URL basiert auf den PriceListArn- und FileFormats-Werten, die Sie aus der ListPriceLists-Antwort in Schritt 1 und Schritt 2 abgerufen haben

Beispiel: Abrufen einer bestimmten Preislistendatei

Der folgende Befehl ruft die URL für eine bestimmte Preislistendatei für Amazon RDS ab.

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

Antwort

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

Aus der Antwort können Sie die URL zum Herunterladen der Preislistendatei verwenden.

Weitere Informationen zu diesem API-Vorgang finden Sie in den folgenden Themen: