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.

# Eine Version einschränken
<a name="ml-restrict-version"></a>

 Sie können die Katalog-API verwenden, um eine Version Ihres Machine-Learning-Produkts in einzuschränken AWS Marketplace. Wenn diese Option eingeschränkt ist, können neue Käufer nicht auf diese Version zugreifen. Bestehende Abonnenten behalten den Zugriff auf eingeschränkte Versionen. AWS Marketplace Die Richtlinien schreiben vor, dass Bestandskäufer nach der Beschränkung 90 Tage lang weiterhin Support erhalten. 

**Wichtig**  
 Mindestens eine Version mit uneingeschränktem Zugriff muss verfügbar bleiben. Sie können die letzte öffentlich verfügbare Version eines Produkts nicht einschränken. 

**So schränken Sie eine Version ein:**
+  Um eine Version einzuschränken, rufen Sie den `StartChangeSet` Vorgang mit dem `RestrictDeliveryOptions` Änderungstyp auf. 

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

```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
  "ChangeSet":
  [
    {
      "ChangeType": "RestrictDeliveryOptions",
      "Entity":
      {
        "Identifier": "{{example1-abcd-1234-5ef6-7890abcdef12@1}}",
        "Type": "MachineLearningProduct@1.0"
      },
      "DetailsDocument":
      {
        "DeliveryOptionIds":
        [
          "{{example1-2222-cccc-2222-cccccccccccc}}"
        ]
      }
    }
  ]
}
```

## Pflichtfelder
<a name="ml-restrict-version-required-fields"></a>

**Pflichtfelder**
+  `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. 
  + `DeliveryOptionIds`(Array von Objekten) — erforderlich

    Liste der DeliveryOption IDs für die Versionen, die Sie einschränken möchten. Rufen Sie die eindeutige ID für jede Version ab, DeliveryOption indem Sie die DescribeEntity Aktion für die Version aufrufen, die Sie einschränken möchten.

## Antwortsyntax
<a name="ml-restrict-version-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"
}
```

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.  Fertigstellung: Nach der Genehmigung ist die neue Version eingeschränkt. 

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

**Asynchrone Fehler**  
Die folgenden Fehler können bei der Verarbeitung von Änderungssätzen auftreten und können mithilfe der `DescribeChangeSet` Operation behoben werden:


| Fehlercode | Fehlermeldung | 
| --- | --- | 
| INCOMPATIBLE\_PRODUCT\_STATUS | Verwenden Sie ein vorhandenes öffentliches oder eingeschränktes Produkt | 
| MISSING\_DELIVERY\_OPTION\_IDS | Geben Sie die Lieferoption aus der vorhandenen ID-Liste an. | 
| INVALID\_DELIVERY\_OPTION\_IDS | Geben Sie die IDs der Lieferoptionen an, die im Produkt zu finden sind. IDs wurden nicht gefunden: [x] | 
| INVALID\_DELIVERY\_OPTION\_STATUS | Die Lieferoption-IDs [invalid\_ids] sind ungültig. Stellen Sie Lieferoptionen im öffentlichen Bereich bereit. | 
| ALL\_DELIVERY\_OPTIONS\_RESTRICTED | Stellen Sie weniger Lieferoptionen zur Verfügung, die eingeschränkt werden müssen, da mindestens eine Option im öffentlichen Zustand bleiben muss. |