

Die AWS Marketplace API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der [AWS Marketplace API-Referenz](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).

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.

# Aktualisieren Sie die Preisbedingungen
<a name="update-pricing-terms"></a>

Sie können die Katalog-API verwenden, um die Preise Ihrer Produkte für maschinelles Lernen in zu aktualisieren AWS Marketplace.

**Anmerkung**  
Sie müssen die Preise für alle unterstützten Instanztypen Ihrer Produkte für maschinelles Lernen festlegen. Wenn Sie Ihre erste Version erstellen, `AddDeliveryOptions` ändern Sie die `UpdatePricingTerms` Typen mit Preisen für alle unterstützten Instanztypen, um Ihr Produkt zu veröffentlichen. Wenn Sie einem vorhandenen Produkt eine neue Version mit neuen Instanztypen hinzufügen, die zuvor nicht unterstützt wurden, müssen Sie diese Instanztypen in die Liste aufnehmen `UpdatePricingTerms` und die Typen `AddDeliveryOptions` ändern.

Um die Preisbedingungen zu aktualisieren, rufen Sie den `StartChangeSet` Vorgang mit dem `UpdatePricingTerms` Änderungstyp auf.

## Erforderliche Syntax
<a name="request-syntax"></a>

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
    "Catalog": "AWSMarketplace",
    "ChangeSet": [
        {
            "ChangeType": "UpdatePricingTerms",
            "Entity": {
                "Type": "Offer@1.0",
                "Identifier": "$CreateOfferChange.Entity.Identifier"
            },
            "DetailsDocument": {
                "PricingModel": "Usage",
                "Terms": [
                    {
                        "Type": "UsageBasedPricingTerm",
                        "CurrencyCode": "USD",
                        "RateCards": [
                            {
                                "RateCard": [
                                    {
                                      "DimensionKey": "ml.m4.4xlarge.m.i.b",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m5.4xlarge.m.i.b",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m4.16xlarge.m.i.b",
                                      "Price": 0.1
                                    },    
                                    {
                                      "DimensionKey": "m.i.c",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m4.4xlarge.a.t",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m5.4xlarge.a.t",
                                      "Price": 0.1
                                    },
                                    {
                                      "DimensionKey": "ml.m4.16xlarge.a.t",
                                      "Price": 0.1
                                    }
                                ]
                            }   
                        ]
                    },
                    {
                        "Type": "FreeTrialPricingTerm",
                        "Duration": "P30D",
                        "Grants": [
                            {
                                "DimensionKey": "ml.m4.4xlarge.m.i.b"
                            },
                              {
                                "DimensionKey": "ml.m5.4xlarge.m.i.b"
                              },
                              {
                                "DimensionKey": "ml.m4.16xlarge.m.i.b"
                              },
                              {
                                "DimensionKey": "m.i.c"
                              },
                              {
                                "DimensionKey": "ml.m4.4xlarge.a.t"
                              },
                              {
                                "DimensionKey": "ml.m5.4xlarge.a.t"
                              },
                              {
                                "DimensionKey": "ml.m4.16xlarge.a.t"
                              }
                        ]
                    }
                ]
            }
        },
    ]
}
```

## Pflichtfelder
<a name="pricing-terms-required-fields"></a>
+ `Entity`(Objekt) (erforderlich) — Enthält Informationen zum Angebot Ihres ML-Produkts.
  + `Identifier`(string) (erforderlich) — Die Angebots-ID, für die Sie die Preisbedingungen aktualisieren möchten. Weitere Informationen finden Sie unter [Identifier](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
  + `Type`(string) (erforderlich) — `Type` Muss `Offer@1.0` für die Aktualisierung der Preisgestaltung verwendet werden.
+ `DetailsDocument`(object) (erforderlich) — Einzelheiten zu den Preisbedingungen Ihres Produkts für maschinelles Lernen.
  + `PricingModel`(string) (erforderlich) — Das Preismodell für Ihr Produkt — Sie können zwischen Nutzung, Kostenlos und Vertrag (für private Angebote) wählen. Weitere Informationen finden Sie unter [Produktpreise für Machine Learning](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-pricing.html).
  + `Terms`(Reihe von Objekten) — Eine Reihe von Preisbegriffen, die zusammen die Gesamtpreisgestaltung Ihres Produkts definieren.
    + `Type`(string) (erforderlich) — Die Art der Preisangabe. Gültige Optionen sind `UsageBasedPricingTerm` `FreeTrialPricingTerm` oder oder `FixedUpfrontPricingTerm` (für private Angebote).
    + `CurrencyCode`(Zeichenfolge) (erforderlich für `UsageBasedPricingTerm` oder `FixedUpfrontPricingTerm` — die Währung der Preisangabe). Gültige Werte sind `USD`.
    + `RateCards`(Array von Objekten) (erforderlich für`UsageBasedPricingTerm`) — Die Preiskarten, die die Preisgestaltung für Ihr maschinelles Lernprodukt definieren. Sie dürfen `RateCard` nur eines in dieses Array aufnehmen.
      + `RateCard`(Array von Objekten) — Die Reihe von Dimensionen und Raten für Ihr Machine-Learning-Produkt. Für alle unterstützten Instanztypen müssen Preise angegeben werden, damit Ihr Produkt veröffentlicht werden kann.
        + `DimensionKey`— Die Dimension, für die Sie den Preis angeben. Gültige Dimensionsschlüssel sind:
          + Instanztyp, gefolgt von der Operation für Stundensätze:
            + Der Instanztyp beginnt mit, `ml` gefolgt vom Namen und der Größe der Instanz. Zum Beispiel `ml.m4.xlarge`
            + Der Betrieb erfolgt `m.i.b` für die Batch-Transformation, `m.i.r` für stündliche Echtzeit-Inferenzen und `a.t` für das Algorithmus-Training.
            + Beispiele: `ml.m4.4xlarge.m.i.b` für die Batch-Transformation, `ml.m4.xlarge.m.i.r` für Echtzeit-Inferenz oder `ml.m4.16xlarge.a.t` für das Algorithmus-Training
          + `m.i.c`für die Preisgestaltung pro Inferenz in Echtzeit.
        + `Price`- Die Geschwindigkeit der Dimension. Die Rate ist entweder stündlich oder pro Inferenz, abhängig vom DimensionKey.
    + `Duration`(string) (erforderlich für `FreeTrialPricingTerm` oder `FixedUpfrontPricingTerm` — Die Dauer Ihrer kostenlosen Testversion oder Ihres Vertrags. Für die kostenlose Testversion liegen die gültigen Werte zwischen X und Y. Für den Vertrag liegen die gültigen Werte zwischen X und Y.
    + Grants (Anordnung von Objekten) — Einzelheiten darüber, welche DimensionKeys für eine kostenlose Testversion in Frage kommen. Alle unterstützten DimensionKeys müssen bereitgestellt werden.
      + DimensionKey - Die Dimension, die im Rahmen des kostenlosen Testangebots enthalten sein soll.
        + Instanztyp, gefolgt von der Operation für Stundensätze:
          + Der Instanztyp beginnt mit, `ml` gefolgt vom Namen und der Größe der Instanz, z. B. `ml.m4.xlarge`
          + Der Vorgang `m.i.b` dient der Batch-Transformation, `m.i.r` der stündlichen Inferenz in Echtzeit oder `a.t` dem Algorithmus-Training.
          + Beispiele: `ml.m4.4xlarge.m.i.b` für die Batch-Transformation, `ml.m4.xlarge.m.i.r` für Echtzeit-Inferenz oder `ml.m4.16xlarge.a.t` für das Algorithmus-Training
        + `m.i.c`für die Preisgestaltung pro Inferenz in Echtzeit.

## Antwortsyntax
<a name="update-pricing-response-syntax"></a>

Bei einer erfolgreichen Anfrage wird Folgendes zurückgegeben:

```
{
    "ChangeSetId": "{{example123456789012abcdef}}",
    "ChangeSetArn": "arn:aws:aws-marketplace:{{us-east-1}}:{{123456789012}}:AWSMarketplace/ChangeSet/{{example123456789012abcdef}}"
}
```

## Verarbeitung von Änderungssätzen
<a name="update-pricing-change-set-processing"></a>

Die Änderungsanforderung wird in eine Verarbeitungswarteschlange gestellt, in der sie mehrere Schritte durchläuft:

1. Validierung: Das System überprüft, ob alle Informationen den AWS Marketplace Richtlinien entsprechen.
   + Bearbeitungszeit: Wenige Minuten bis mehrere Stunden
   + Informationen zu Validierungsfehlern finden Sie unter [Status und Fehler des Änderungssatzes](https://docs.aws.amazon.com/marketplace/latest/APIReference/work-with-seller-products.html#seller-product-change-set-errors).

1. Statusüberwachung: Sie können den Status der Anfrage auf zwei Arten überprüfen.
   + Über das AWS Marketplace Verwaltungsportal
   + Verwenden des Befehls `DescribeChangeSet`

1. Abschluss: Nach der Genehmigung werden die Preisbedingungen aktualisiert.

## Fehler
<a name="update-pricing-errors"></a>

**Asynchrone Fehler**  
Spezifische Fehler für `UpdatePricingTerms` Aktionen können mithilfe der `DescribeChangeSet` Operation abgerufen werden, nachdem der Änderungssatz mit der Verarbeitung begonnen hat. Einzelheiten zu Fehlern und zur Problembehebung finden Sie unter [Status und Fehler des Änderungssatzes](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets).


| Fehlercode | Fehlermeldung | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | Verwenden Sie ein vorhandenes limitiertes oder öffentliches Produkt. | 