

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
<a name="using-the-aws-price-list-bulk-api"></a>


|  | 
| --- |
| Füllen Sie diese [kurze Umfrage](https://amazonmr.au1.qualtrics.com/jfe/form/SV_cO0deTMyKyFeezA) 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.<a name="using-the-aws-price-list-bulk-api-fetching-price-list-files"></a>

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](using-the-aws-price-list-bulk-api-fetching-price-list-files-manually.md).

### Schritt 1: Verfügbare Produkte finden AWS-Services
<a name="price-bulk-api-step-1-find-available-services"></a>

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.

**Example 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 [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html)und [sprachspezifisch AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_DescribeServices.html#API_pricing_DescribeServices_SeeAlso) in der AWS Fakturierung und Kostenmanagement API-Referenz*

**Anmerkung**  
Die `DescribeServices` API kehrt derzeit zwar nicht `serviceCodes` für Savings Plans zurück, Sie benötigen jedoch Folgendes, `serviceCodes` um Savings Plans in nachfolgenden API-Aufrufen verwenden zu können:  


| ServiceCode | SavingsPlanCode | 
| --- | --- | 
| ComputeSavingsPlans | AWSComputeSavingsPlan | 
| MachineLearningSavingsPlans | AWSMachineLearningSavingsPlans | 
| DatabaseSavingsPlans | AWSDatabaseSavingsPlans | 
Verwenden Sie die `ServiceCode` Werte, wenn Sie mit den `GetPriceListFileUrl` API-Operationen `ListPriceLists` und arbeiten. Das `SavingsPlanCode` ist nur erforderlich, wenn Sie Preislistendateien manuell herunterladen, anstatt die zu verwenden APIs.

### Schritt 2: Suchen nach Preislistendateien für eine verfügbare AWS-Service
<a name="price-list-bulk-api-step-2-find-available-price-list-files"></a>

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
<a name="price-list-bulk-api-examples-find-price-list-files"></a>

**Example 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"
      },
      ...
   ]
}
```

**Example 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 [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html)-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 [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html)und [sprachspezifisch AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_ListPriceLists.html#API_pricing_ListPriceLists_SeeAlso) in der *AWS Fakturierung und Kostenmanagement API-Referenz*.

### Schritt 3: Abrufen einer bestimmten Preislistendatei
<a name="price-list-bulk-api-step-3-getting-specific-price-list"></a>

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](#price-bulk-api-step-1-find-available-services) und [Schritt 2](#price-list-bulk-api-step-2-find-available-price-list-files) abgerufen haben 

**Example 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:
+  [https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html)*und [sprachspezifisch AWS SDKs](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_pricing_GetPriceListFileUrl.html#API_pricing_GetPriceListFileUrl_SeeAlso) in der API-Referenz AWS Fakturierung und Kostenmanagement *
+ [Lesen der Preislistendateien](bulk-api-reading-price-list-files.md)