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.

# Versionsinformationen aktualisieren
<a name="ml-update-version"></a>

 Sie können die Katalog-API verwenden, um Details einer vorhandenen Version Ihres Machine-Learning-Produkts in zu aktualisieren AWS Marketplace. 

**Wichtig**  
 Sie können den ARN für eine Version nicht aktualisieren. Wenn Sie den ARN ändern müssen, müssen Sie stattdessen eine neue Version erstellen. 

**Verwenden `StartChangeSet`, um eine Version hinzuzufügen:**
+  Um Versionsinformationen zu aktualisieren, rufen Sie den `StartChangeSet` Vorgang mit dem `UpdateDeliveryOptions` Änderungstyp auf. 

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

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "UpdateDeliveryOptions",
      "Entity":
      {
        "Identifier": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "Version":
        {
          "ReleaseNotes": "{{Adding support for new parameters}}"
        },
        "DeliveryOptions":
        [
          {
            "Id": "{{example1-2222-cccc-2222-cccccccccccc}}",
            "Details":
            {
              "SagemakerModelPackageDeliveryOptionDetails":
              {
                "SampleNotebookUrl": "{{https://www.amazon.com}}",
                "RepositoryUrl":"{{https://www,amazon.com}}",
                "InputProperties": 
                { 
                    "SampleInput": {
                        "RealtimeInferenceUrl": "{{https://www.sampleData.com}}",
                        "BatchTranformUrl": "{{https://www.sampleData.com}}",
                     },
                 },
                 "RecommendedInstanceTypes": {
                        "BatchTransform": "{{ml.m4.large}}",
                        "RealtimeInference": "{{ml.m4.large}}"
                  }
            }
          }
        ]
      }
    }
  ]
}
```

## Pflichtfelder
<a name="ml-update-version-required-fields"></a>
+  `Entity`(Objekt) — erforderlich 

  Enthält Informationen zu Ihrem ML-Produkt.
  +  `Identifier`(Zeichenfolge) — erforderlich 

    Ihre Produkt-ID. Weitere Informationen finden Sie unter [Identifier](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier).
  +  `Type`(Zeichenfolge) — erforderlich 

    Gibt die Versandmethode (Produkttyp) an. Das muss es sein`MachineLearningProduct@1.0`.
+  `DetailsDocument`(Objekt) — erforderlich 

   Enthält die aktualisierten Versionsinformationen. 
  + `Version`(Objekt) — erforderlich

    Definiert versionsspezifische Informationen.
    + `VersionTitle`(Zeichenfolge) — erforderlich

      Die Versions-ID, die Käufern angezeigt wird, z. B. „Version 1.1“ oder „1.1“. Käufer verwenden diesen Titel, um Versionen für die Bereitstellung auszuwählen.
    + `ReleaseNotes`(Zeichenfolge) — erforderlich 

      Detaillierte Hinweise zu dieser Version, begrenzt auf 30.000 Zeichen.
  + `DeliveryOptions`(Array) — erforderlich 

    Gibt die Versandmethoden für Ihre Produktversion an. Beschränkt auf eine Lieferoption pro Version.
    + `Id`(Zeichenfolge) — erforderlich 

      Eindeutiger Bezeichner für die DeliveryOption. Rufen Sie dies mithilfe der DescribeEntity Aktion für Ihr Produkt ab.
    + `Details`(Objekt) — erforderlich 

      Enthält die Spezifikationen der Lieferoptionen.
      + `SageMakerModelPackageSubscriptionDetails`oder `SageMakerAlgorithmSubscriptionDetails` (Objekt) — erforderlich 

        Einzelheiten der Lieferoption.
        + `SampleNotebookUrl`(Zeichenfolge) — erforderlich 

          Beispiel für einen Jupyter-Notebook-Link, der Code für Käufer bereitstellt.
        + `RepositoryUrl`(Zeichenfolge) — erforderlich 

          Git-Repository-URL zum Klonen von Notizbuch- und Beispieldaten.
        + `UsageInstructions`(Zeichenfolge) — erforderlich 

          Für Algorithmen: Trainingsinformationen. Für Modelle: zusätzliche Nutzungsinformationen.
        + `InputProperties`(Objekt) — erforderlich 

          Einzelheiten zu den Eingabeanforderungen model/algorithm von.
          + `Description`(Zeichenfolge) — erforderlich 

            Beschreibung der erforderlichen Eingaben.
          + `Limitations` (string) 

            Alle Eingabebeschränkungen.
          + `SampleInput`(Objekt) — erforderlich 

            Beispiel-Eingabedaten für verschiedene Operationen.
            + `RealtimeInferenceUrl` (string) 

              Beispiel-Eingabe-URL für Echtzeit-Inferenz.
            + `RealtimeInferenceText` (string) 

              Beispieleingabetext für Echtzeit-Inferenz.
            + `BatchTransformUrl` (string) 

              Beispiel für eine Eingabe-URL für Batch-Transformationsaufträge.
            + `BatchTransformText` (string) 

              Beispieleingabetext für Batch-Transformationsaufträge.
          + `Parameters`(Reihe<Object>) 

            Details für jeden Eingabeparameter.
            + `Name`(Zeichenfolge) — erforderlich 

              Name des Eingabeparameters.
            + `Description`(Zeichenfolge) — erforderlich 

              Beschreibung des Eingabeparameters.
            + `Constraints` (string) 

              Parametereinschränkungen (MinValue MaxValue AllowedValues, MinLength, MaxLength,,, Muster usw.).
            + `Required`(boolescher Wert) 

              Gibt an, ob der Parameter erforderlich ist. Standard ist „false“.
          + `SageMakerCustomAttributes`(Reihe<Object>) 

            Einzelheiten zur Unterstützung CustomAttributes.
            + `Name`(Zeichenfolge) — erforderlich 

              Name des benutzerdefinierten Attributs.
            + `Description`(Zeichenfolge) — erforderlich 

              Beschreibung des benutzerdefinierten Attributs.
            + `Constraints` (string) 

              Attributbeschränkungen (MinValue MaxValue, AllowedValues, MinLength, MaxLength,, Muster usw.).
            + `Required`(boolescher Wert) 

              Gibt an, ob das Attribut erforderlich ist. Standard ist „false“.
        + `OutputProperties`(Objekt) — erforderlich 

          Einzelheiten der Ausgabe model/algorithm von.
          + `Description`(Zeichenfolge) — erforderlich 

            Beschreibung der model/algorithm Ausgaben.
          + `SampleOutput`(Array<Object>) — erforderlich 

            Beispielausgabedaten für verschiedene Operationen.
            + `RealtimeInferenceUrl` (string) 

              Beispielausgabe-URL für Echtzeit-Inferenz.
            + `RealtimeInferenceText` (string) 

              Beispielausgabetext für Echtzeit-Inferenz.
            + `BatchTransformUrl` (string) 

              Beispielausgabe-URL für Batch-Transformationsaufträge.
            + `BatchTransformText` (string) 

              Beispielausgabetext für Batch-Transformationsaufträge.
          + `Parameters`(Reihe) 

            Details für jeden Ausgabeparameter.
            + `Name`(Zeichenfolge) — erforderlich 

              Name des Ausgabeparameters.
            + `Description`(Zeichenfolge) — erforderlich 

              Beschreibung des Ausgabeparameters.
            + `AlwaysReturned`(boolescher Wert) 

              Gibt an, ob der Parameter immer zurückgegeben wird. Standard ist „false“.
        + `RecommendedInstanceTypes`(Objekt) — erforderlich 

          Empfohlene Instance-Typen für optimale Leistung.
          + `BatchTransform`(Zeichenfolge) — erforderlich 

            Empfohlener Instanztyp für Batch-Transformationsvorgänge.
          + `RealtimeInference`(Zeichenfolge) — erforderlich 

            Empfohlener Instanztyp für Inferenzoperationen in Echtzeit.
          + `Training`(Zeichenfolge) — erforderlich 

            Empfohlener Instanztyp für Algorithmus-Trainingsoperationen. Nur für SageMaker Algorithmen erforderlich.

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

Eine erfolgreiche Anfrage gibt Folgendes zurück:

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

**Verarbeitung von Änderungssätzen**  
Die Änderungsanforderung wird in eine Verarbeitungswarteschlange gestellt, in der sie mehrere Schritte durchläuft:

1. Validierung: Das System prü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 wird die neue Version aktualisiert. 

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

**Asynchrone Fehler**  
Spezifische Fehler für `UpdateDeliveryOptions` 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. | 
| INVALID\_DELIVERY\_OPTION\_ID | Geben Sie die IDs der Lieferoptionen an, die im Produkt zu finden sind. IDs wurden nicht gefunden: [x] | 
| INCOMPATIBLE\_DELIVERY\_OPTION\_STATUS | Die Versandoption kann nicht aktualisiert werden, da sie sich im eingeschränkten Status befindet. Versuchen Sie stattdessen, eine neue Version hinzuzufügen. | 
| INCOMPATIBLE\_DELIVERY\_OPTIONS | Das Produkt hat zuvor [X] als Lieferoption verwendet, daher sollten alle zukünftigen Lieferoptionen vom Typ [X] sein | 
| INVALID\_RECOMMENDED\_INSTANCE\_TYPE | Stellen Sie einen vorhandenen, verfügbaren Instanztyp für [X] bereit (X kann Batch Transform, Realtime Inference oder Algorithm Training sein) | 
| DUPLICATE\_VERSION\_TITLE | Der Versionstitel muss sich von allen anderen Versionstiteln dieses Produkts unterscheiden. | 
| FIELD\_NOT\_ALLOWED\_TO\_CHANGE | Feld X darf nicht geändert werden. |