View a markdown version of this page

Versionsinformationen aktualisieren - AWS Marketplace
Erforderliche SyntaxPflichtfelderAntwortsyntaxFehler

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.

Versionsinformationen aktualisieren

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

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

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

        • SageMakerModelPackageSubscriptionDetailsoder 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

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.

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

    • Über das AWS Marketplace Verwaltungsportal

    • Verwenden des Befehls DescribeChangeSet

  3. Abschluss: Nach der Genehmigung wird die neue Version aktualisiert.

Fehler

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.

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.