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 neue Version hinzufügen
Sie können die Katalog-API oder das AWS Marketplace Verwaltungsportal verwenden, um einem Machine-Learning-Produkt eine neue Version hinzuzufügen. Weitere Informationen zur Nutzung des Portals finden Sie unter [Hinzufügen einer neuen Version](https://docs.aws.amazon.com/marketplace/latest/userguide/machine-learning-products.html) im *AWS Marketplace Marketplace-Verkäuferleitfaden*.
**Anmerkung**
Bei ML-Produkten besteht eine Version aus einer einzigen Lieferoption, die das Produkt darstellt, das Sie zur Verfügung stellen. Wenn Sie in der Katalog-API mit Lieferoptionen für ML-Produkte arbeiten, werden Versionen Ihres Produkts effektiv geändert.
Wenn Sie neue Instance-Typen hinzufügen, nehmen Sie einen `UpdatePricingTerms` Änderungstyp in Ihr Änderungssatz auf, um die Preise für neue Instance-Typen festzulegen. `UpdatePricingTerms`Muss bei neuen Produkten alle unterstützten Instance-Typen abdecken. `UpdatePricingDimensions`ist für ML-Produkte nicht erforderlich oder wird nicht unterstützt, da Dimensionen automatisch für alle unterstützten Instanztypen generiert werden. Weitere Informationen finden Sie unter [Preisdimensionen aktualisieren](work-with-seller-products.md#update-dimensions).
**Wird verwendet `StartChangeSet`, um eine Version hinzuzufügen**
Um eine neue Version hinzuzufügen, rufen Sie den `StartChangeSet` Vorgang mit dem `AddDeliveryOptions` Änderungstyp auf:
1. Um Ihren API-Aufruf zu validieren, ohne eine Version zu erstellen, setzen Sie `Intent` auf`VALIDATE`.
1. Für die eigentliche Versionserstellung legen Sie `Intent` den Wert auf fest`APPLY`.
## Erforderliche Syntax
```
POST /StartChangeSet HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"ChangeSet": [{
"ChangeType": "AddDeliveryOptions",
"Entity": {
"Identifier": "example1-abcd-1234-5ef6-7890abcdef12@1",
"Type": "MachineLearningProduct@1.0"
},
"DetailsDocument": {
"Version": {
"VersionTitle": "version 1.1",
"ReleaseNotes": "Patch update for small bugfix in version 1.0"
},
"DeliveryOptions": [{
"Details": {
"SageMakerAlgorithmDeliveryOptionDetails": {
"SageMakerAlgorithmArn": "arn:aws:sagemaker:us-east-2:605142612156:algorithm/scikit-decision-trees-1552343220",
"AccessRoleArn": "arn:aws:iam::12345678901:role/AwsMarketplaceSageMakerIngestion",
"UsageInstructions":"This is how you use your algorithm",
"SampleNotebookUrl": "https://www.amazon.com",
"RepositoryUrl": "https://www,amazon.com",
"InputProperties": {
"Description": "Input should have all columns in the train/test file except for 'is_fraud' column.",
"Limitations": "Can predict on 1 input in the CSV only at a time",
"SampleInput": {
"RealtimeInferenceText": "{\"prompt\":\"Write summary\",
\"maxTokens\": 1 }",
"BatchTransformUrl": "https://www.sampleData.com",
},
"Parameters": [{
"Name": "prompt",
"Description": "Represents the instruct-style prompt for the model. DataType is String",
"Constraints": "Minimum length should be 1",
"Required": true
},
{
"Name": "maxTokens",
"Description": "Denotes the number of tokens to predict per generation. See BPE Tokens for more details.",
"Constraints": "Minvalue: 1, MaxValue: 30"
}
],
"SageMakerCustomAttributes": [{
"Name": "threshold",
"Description": "Threshold of the confidence score of the detected object",
"Constraints": "Should be an Integer"
}]
},
"OutputProperties": {
"Description": "The output is a JSON object that has the generated text along with likelihoods of tokens, if requested. See example json.",
"SampleOutput": {
"RealtimeInferenceUrl": "https://www.sampledata.com",
"BatchTransformUrl": "https://www.sampleData.com",
},
"Parameters": [{
"Name": "id",
"Description": "An identifier for response"
"AlwaysReturned": true
},
{
"Name": "generations",
"Description": "The generated text along with the likelihoods for tokens requested.",
}
],
},
"RecommendedInstanceTypes": {
"BatchTransform": "ml.m4.large",
"RealtimeInference": "ml.m4.large",
"Training": "ml.m4.large"
}
}
}]
}
}],
"Intent": "APPLY"
}
```
## 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 alle Details zur neuen Version Ihres Produkts.
+ `Version`(Objekt) — erforderlich
Details zu der Version, die hinzugefügt wird.
+ `VersionTitle`(Zeichenfolge) — erforderlich
Der Titel der Version, z. B. „Version 1.1“ oder „1.1“. Käufer wählen Versionen aus diesen Titeln aus.
+ `ReleaseNotes`(Zeichenfolge) — erforderlich
Detaillierte Hinweise zu dieser Version. Muss weniger als 30.000 Zeichen enthalten.
+ `DeliveryOptions`(Array) — erforderlich
Eine Reihe von Liefermethoden für Ihre Produktversion. Beschränkt auf eine Lieferoption pro Version.
+ `Details`(Objekt) — erforderlich
+ `SagemakerModelPackageDeliveryOptionDetails`oder `SageMakerAlgorithmDeliveryOptionDetails` (Objekt)
+ `SageMakerModelPackageArn`oder `SageMakerAlgorithmArn` (Zeichenfolge) — erforderlich
Amazon-Ressourcenname (ARN) Ihres Modellpakets oder Algorithmus.
+ `AccessRoleArn`(Zeichenfolge) — erforderlich
IAM-Rolle ARN für AWS Marketplace für den Zugriff auf die SageMaker Ressource.
+ `SampleNotebookUrl`(Zeichenfolge) — erforderlich
Link zum Beispiel für ein Jupyter-Notizbuch mit Verwendungscode. Weitere Informationen finden Sie in einer [Beispielvorlage für ein Notizbuch](https://github.com/aws/amazon-sagemaker-examples/blob/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage/Sample_Notebook_Template/title_of_your_product-Model.ipynb) unter. GitHub
+ `RepositoryUrl`(Zeichenfolge) — erforderlich
Git-Repository-URL für den Zugriff auf Notizbücher und Beispieldaten. Weitere Informationen finden Sie unter einem [Beispiel für ein Git-Repository](https://github.com/aws/amazon-sagemaker-examples/tree/master/aws_marketplace/curating_aws_marketplace_listing_and_sample_notebook/ModelPackage/Sample_Notebook_Template) GitHub.
+ `UsageInstructions`(Zeichenfolge) — erforderlich
Trainingsinformationen für Algorithmen oder Nutzungsdetails für Modelle.
+ `InputProperties`(Objekt) — erforderlich
+ `Description`(Zeichenfolge) — erforderlich
Beschreibung der Eingaben model/algorithm
+ `Limitations` (string)
Eingabebeschränkungen
+ `SampleInput`(Objekt) — erforderlich
RealtimeInferenceUrl (Zeichenfolge) \| RealtimeInferenceText (Zeichenfolge) \| BatchTransformUrl (Zeichenfolge) \| BatchTransformText (Zeichenfolge)
+ `Parameters`(Reihe