View a markdown version of this page

Eine neue Version hinzufügen - AWS Marketplace

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:

  1. Um Ihren API-Aufruf zu validieren, ohne eine Version zu erstellen, setzen Sie Intent aufVALIDATE.

  2. Für die eigentliche Versionserstellung legen Sie Intent den 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) — erforderlich

    Enthält Informationen zu Ihrem ML-Produkt.

    • Identifier(Zeichenfolge) — erforderlich

      Ihre Produkt-ID. Weitere Informationen finden Sie unter Identifier.

    • Type(Zeichenfolge) — erforderlich

      Gibt die Versandmethode (Produkttyp) an. Das muss es seinMachineLearningProduct@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

        • SagemakerModelPackageDeliveryOptionDetailsoder SageMakerAlgorithmDeliveryOptionDetails (Objekt)

          • SageMakerModelPackageArnoder 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 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 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<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>) — erforderlich

              RealtimeInferenceUrl (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:

  1. Validierung: Das System überprüft, ob alle Informationen den AWS Marketplace Richtlinien entsprechen.

  2. Statusüberwachung: Sie können den Status der Anfrage auf zwei Arten überprüfen.

    • Über das AWS Marketplace Management Portal

    • Verwenden des Befehls DescribeChangeSet

  3. 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.