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.
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 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. UpdatePricingTermsMuss bei neuen Produkten alle unterstützten Instance-Typen abdecken. UpdatePricingDimensionsist 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.
Wird verwendet StartChangeSet, um eine Version hinzuzufügen
Um eine neue Version hinzuzufügen, rufen Sie den StartChangeSet Vorgang mit dem AddDeliveryOptions Änderungstyp auf:
-
Um Ihren API-Aufruf zu validieren, ohne eine Version zu erstellen, setzen Sie
IntentaufVALIDATE. -
Für die eigentliche Versionserstellung legen Sie
Intentden Wert auf festAPPLY.
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) — erforderlichEnthält Informationen zu Ihrem ML-Produkt.
-
Identifier(Zeichenfolge) — erforderlichIhre Produkt-ID. Weitere Informationen finden Sie unter Identifier.
-
Type(Zeichenfolge) — erforderlichGibt die Versandmethode (Produkttyp) an. Das muss es sein
MachineLearningProduct@1.0.
-
-
DetailsDocument(Objekt) — erforderlichEnthält alle Details zur neuen Version Ihres Produkts.
-
Version(Objekt) — erforderlichDetails zu der Version, die hinzugefügt wird.
-
VersionTitle(Zeichenfolge) — erforderlichDer Titel der Version, z. B. „Version 1.1“ oder „1.1“. Käufer wählen Versionen aus diesen Titeln aus.
-
ReleaseNotes(Zeichenfolge) — erforderlichDetaillierte Hinweise zu dieser Version. Muss weniger als 30.000 Zeichen enthalten.
-
-
DeliveryOptions(Array) — erforderlichEine Reihe von Liefermethoden für Ihre Produktversion. Beschränkt auf eine Lieferoption pro Version.
-
Details(Objekt) — erforderlich-
SagemakerModelPackageDeliveryOptionDetailsoderSageMakerAlgorithmDeliveryOptionDetails(Objekt)-
SageMakerModelPackageArnoderSageMakerAlgorithmArn(Zeichenfolge) — erforderlichAmazon-Ressourcenname (ARN) Ihres Modellpakets oder Algorithmus.
-
AccessRoleArn(Zeichenfolge) — erforderlichIAM-Rolle ARN für AWS Marketplace für den Zugriff auf die SageMaker Ressource.
-
SampleNotebookUrl(Zeichenfolge) — erforderlichLink zum Beispiel für ein Jupyter-Notizbuch mit Verwendungscode. Weitere Informationen finden Sie in einer Beispielvorlage für ein Notizbuch
unter. GitHub -
RepositoryUrl(Zeichenfolge) — erforderlichGit-Repository-URL für den Zugriff auf Notizbücher und Beispieldaten. Weitere Informationen finden Sie unter einem Beispiel für ein Git-Repository
GitHub. -
UsageInstructions(Zeichenfolge) — erforderlichTrainingsinformationen für Algorithmen oder Nutzungsdetails für Modelle.
-
InputProperties(Objekt) — erforderlich-
Description(Zeichenfolge) — erforderlichBeschreibung der Eingaben model/algorithm
-
Limitations(string)Eingabebeschränkungen
-
SampleInput(Objekt) — erforderlichRealtimeInferenceUrl (Zeichenfolge) | RealtimeInferenceText (Zeichenfolge) | BatchTransformUrl (Zeichenfolge) | BatchTransformText (Zeichenfolge)
-
Parameters(Reihe<Object>)Name (Zeichenfolge) —erforderlich | Beschreibung (Zeichenfolge) —Erforderlich | Einschränkungen (Zeichenfolge) | Erforderlich (boolean)
-
SageMakerCustomAttributes<Object>(Array)Beschreibt alle, CustomAttributesdie von Ihrem Modell unterstützt werden.
Name(Zeichenfolge) —erforderlich |Description(Zeichenfolge) —Erforderlich |Constraints(Zeichenfolge) |Required(boolean)
-
-
OutputProperties(Objekt) — erforderlich-
Description(Zeichenfolge) — erforderlich -
SampleOutput(Array<Object>) — erforderlichRealtimeInferenceUrl (Zeichenfolge) | RealtimeInferenceText (Zeichenfolge) | BatchTransformUrl (Zeichenfolge) | BatchTransformText (Zeichenfolge)
-
Parameters(Reihe)Name (Zeichenfolge) —erforderlich | Beschreibung (Zeichenfolge) —erforderlich | AlwaysReturned (boolean)
-
-
RecommendedInstanceTypes(Objekt) — erforderlich-
BatchTransform(Zeichenfolge) — Erforderlich -
RealtimeInference(Zeichenfolge) — Erforderlich -
Training(string) — Nur für SageMaker Algorithmen erforderlich
-
-
-
-
-
Antwortsyntax
Wenn Sie die Anfrage einreichen, wird ein Änderungssatz erstellt und die API gibt Folgendes zurück:
{ "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" }
Verarbeitung des Änderungssatzes
Die Änderungsanforderung wird in eine Verarbeitungswarteschlange gestellt, in der sie mehrere Schritte durchläuft:
-
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.
-
-
Statusüberwachung: Sie können den Status der Anfrage auf zwei Arten überprüfen.
-
Über das AWS Marketplace Management Portal
-
Verwenden des Befehls
DescribeChangeSet
-
-
Abschluss: Nach der Genehmigung wird die neue Version hinzugefügt.
Fehler
Asynchrone Fehler
Die folgenden Fehler sind spezifisch für AddDeliveryOptions Aktionen in der AWS Marketplace Katalog-API. Diese Fehler treten auf, wenn Sie aufrufen, DescribeChangeSet während ein Änderungssatz verarbeitet wird. Weitere Informationen DescribeChangeSet zur Überprüfung des Status eines Änderungsantrags finden Sie unter Mit Änderungssätzen arbeiten.
| Fehlercode | Fehlermeldung |
|---|---|
| INCOMPATIBLE_PRODUCT_STATUS | Wir konnten das bereitgestellte Produkt nicht finden. Geben Sie ein gültiges Produkt an. |
| DUPLICATE_VERSION_TITLE | Der angegebene Versionstitel wird bereits verwendet. Erstellen Sie einen eindeutigen Versionstitel. |
| INVALID_RECOMMENDED_INSTANCE_TYPE | Sie haben keinen gültigen Instanztyp für [x] angegeben. Geben Sie einen gültigen Instanztyp ein und versuchen Sie es erneut. Gültige Typen sind: [gültig] |
| INCOMPATIBLE_DELIVERY_OPTIONS | Die von Ihnen angegebene Lieferoption entspricht nicht Ihrer vorherigen Auswahl: [vorherige Auswahl]. Aktualisieren Sie Ihre Lieferoption und versuchen Sie es erneut. |
| INVALID_ASSET_ARN | Sie haben keinen gültigen ARN für angegeben SageMakerAlgorithmDeliveryOption. Geben Sie einen gültigen ARN ein und versuchen Sie es erneut. |
| DUPLICATE_ASSET | Sie haben keinen eindeutigen ARN für dieses Produkt angegeben. Geben Sie einen eindeutigen ARN ein und versuchen Sie es erneut. |
| ASSET_NOT_FOUND | Wir konnten den von Ihnen angegebenen ARN nicht finden. Stellen Sie sicher, dass der ARN korrekt ist und über die erforderlichen Berechtigungen verfügt. |
| ASSET_VALIDATION_EXCEPTION | SagemakerModelArn/SagemakerAlgorithmArn [x] kann nicht in das AWS Sagemaker-Konto aufgenommen werden |
| INVALID_ACCESS_ROLE | Wir konnten den von Ihnen angegebenen ARN für die IAM-Rolle nicht finden. Stellen Sie sicher, dass der ARN korrekt ist, und versuchen Sie es erneut. |
| UPDATE_PRICING_REQUIRED | UpdatePricingTerms ist erforderlich. |