Lösungen im AWS Marketplace und in AWS Partner Central Entität der Lösung Erste Schritte mit Lösungen Listen Sie Ihre Lösungen auf Details zur Lösung abrufen Listet den Änderungsverlauf für eine Lösung auf Taggen Sie Lösungen und Änderungssätze Erstellen Sie eine Lösung Aktualisieren Sie die Lösungsinformationen Aktualisieren Sie verwandte Produkte Eine Lösung veröffentlichen Aktualisieren Sie die Optionen zur Käuferbindung Aktualisieren Sie die Sichtbarkeit der Lösung Häufige asynchrone Fehlercodes Lebenszyklus der Lösung IAM-Berechtigungen für Lösungen

Arbeite mit Lösungen

Eine Lösung ist eine Sammlung von Produkten und Dienstleistungen, die zusammenarbeiten, um spezifische Kundenprobleme zu lösen. Die Lösungen können AWS Marketplace Marketplace-Produkte und Produkte anderer Anbieter umfassen. Mithilfe von Lösungen können Sie zeigen, wie sich mehrere Produkte integrieren lassen, um branchenspezifische Anwendungsfälle zu adressieren. Die Lösung beschreibt das Kundenproblem, Anwendungsfälle, Integrationsdetails und verwandte Produkte.

Lösungen im AWS Marketplace und in AWS Partner Central

Wenn Sie von Partner Central 2.0 zu Partner Central 3.0 migrieren, werden Sie aufgefordert, ein AWS-Konto zu erstellen und sich als AWS Marketplace-Verkäufer zu registrieren. Weitere Informationen finden Sie unter Registrieren und Ihr Verkäuferprofil erstellen. Diese Registrierung ist erforderlich, um:

Migrieren Sie Ihre bestehenden Partner Central-Lösungen in den AWS Marketplace Marketplace-Katalog (alle Lösungen werden in den AWSMarketplace Katalog migriert)
Sorgen Sie dafür, dass Ihre AWS Marketplace Marketplace-Lösungen mit Partner Central-APIs wie Verkaufs-APIs funktionieren.

Grundlegendes zur Profilverknüpfung und Migration

Es gibt zwei unterschiedliche Szenarien für die Verbindung Ihrer Partner Central- und AWS Marketplace Marketplace-Konten:

Nur Profilverknüpfung — Wenn Sie Ihre AWS Partner Central- und AWS-Konten verknüpfen, ohne zu Partner Central 3.0 zu migrieren, bleiben Ihre AWS Marketplace-Lösungen und Partner Central-Lösungen getrennt. Sie verwalten jede Plattform unabhängig voneinander.

Profilmigration — Wenn Sie mit verknüpften AWS Marketplace Marketplace-Verkäuferprofilen zu Partner Central 3.0 migrieren:

Ihre Partner Central 2.0-Lösungen migrieren auf AWS Marketplace
Sie verwalten Lösungen nur über AWS Marketplace
Partner Central-APIs können auf migrierte Lösungen zugreifen

Anmerkung

Wenn Sie Ihre AWS Partner Central- und AWS-Konten bereits verknüpft haben (siehe Verknüpfen von AWS Partner Central- und AWS-Konten), müssen Sie kein neues AWS-Konto erstellen. Stellen Sie jedoch sicher, dass Ihr vorhandenes AWS-Konto als AWS Marketplace-Verkäufer registriert ist. Um Ihre Lösung auf der AWS Marketplace Marketplace-Käuferwebsite öffentlich verfügbar zu machen, benötigen Sie ein öffentliches Profil als AWS Marketplace Marketplace-Verkäufer. Anweisungen zur Registrierung von Verkäufern im AWS Marketplace finden Sie unter Registrieren und Ihr Verkäuferprofil erstellen.

Bereitstellung bereits vorhandener AWS Marketplace Marketplace-Lösungen für Partner Central-APIs

AWS Marketplace Marketplace-Lösungen, die Sie vor der Migration des Partner Central 3.0-Profils erstellt haben, werden von den Partner Central-APIs nicht automatisch erkannt. Dies gilt auch, nachdem Sie die Migration abgeschlossen und Ihr AWS-Konto mit einem Partner Central-Konto verknüpft haben.

Um eine bestehende Lösung vor der Migration für Partner Central-APIs sichtbar zu machen, aktualisieren Sie jedes Feld in der Lösung. Sie können dieselben Informationen eingeben, die derzeit dort sind. Wiederholen Sie diesen Vorgang für jede Lösung, die Sie vor der Migration des Partner Central 3.0-Profils erstellt haben.

Verwenden Sie beispielsweise den UpdateInformation Änderungstyp, um den Namen einer Lösung mit dem aktuellen Wert zu aktualisieren. Nachdem Sie eine Lösung einmal aktualisiert haben, erkennen die Partner Central-APIs automatisch alle future Updates für diese Lösung.

Entität der Lösung

Eine Lösung ist ein Marketingdokument, das Käufern hilft, Ihre Angebote zu entdecken und zu verstehen. Lösungen enthalten einen Titel, eine Beschreibung, Anwendungsfälle, AWS Marketplace Marketplace-Produkte und Produkte, die nicht von AWS Marketplace stammen. Die Lösung ist ein von Produkt-, Angebots- und Angebotssets getrennter Entitätstyp. Jede Lösung hat ihre eigene Entdeckungs- und Angebotserfahrung, die Käufer getrennt von den einzelnen Produkten durchsuchen können.

Schlüsselmerkmale

Gruppieren Sie mehrere Produkte, darunter sowohl AWS Marketplace Marketplace-Produkte als auch Produkte anderer Anbieter.
Bieten Sie Käufern ein spezielles Einkaufs- und Angebotserlebnis.
Gruppieren Sie Produkte, die Sie besitzen, mit Produkten anderer Verkäufer.

Der Entitätstyp der Lösung istSolution@1.0.

Entitätskennungen

Lösungen verwenden das soln-* Identifier-Format (z. B.soln-abc123def456).

ARN-Format der Entität

Die Lösungen folgen dem AWS-ARN-Standardformat:


arn:{aws-partition}:aws-marketplace:{region}:{account-id}:{aws-marketplace-catalog}/Solution/{solution-id}

Beispiel:


arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123def456

Erste Schritte mit Lösungen

Dieser Abschnitt enthält detaillierte Informationen zum Erstellen und Verwalten von Lösungen mithilfe von AWS Marketplace Katalog-API-Änderungstypen.

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

Gültige AWS Marketplace Marketplace-Verkäuferregistrierung und ein öffentliches Profil. Weitere Informationen finden Sie unter Registrieren und Ihr Verkäuferprofil erstellen.
Zugriff auf die API und Erfüllung der Voraussetzungen für Verkäufer Weitere Informationen finden Sie unter Zugriffskontrolle für die AWS Marketplace Catalog API.
Sie haben sich mit den Grundlagen der Verwendung der AWS Marketplace Catalog API vertraut gemacht, siehe Verwenden der AWS Marketplace Catalog API.

Listen Sie Ihre Lösungen auf

Um alle Lösungen in Ihrem Konto aufzulisten, rufen Sie den ListEntities API-Vorgang auf und stellen Sie EntityType die Option Lösung ein.

Anforderung


POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "Solution"
}

Antwort


{
  "EntitySummaryList": [
    {
      "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
      "EntityId": "soln-abc123456",
      "EntityType": "Solution",
      "LastModifiedDate": "2024-10-10T19:50:43Z",
      "Name": "Test Solution 1",
      "Visibility": "Limited"
    }
  ],
  "NextToken": null
}

Filtern Sie Lösungen nach Sichtbarkeit

Mithilfe des FilterList Parameters können Sie Lösungen nach Sichtbarkeit filtern.

Anforderung


POST /ListEntities HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "EntityType": "Solution",
  "FilterList": [
    {
      "Name": "Visibility",
      "ValueList": [
        "Public"
      ]
    }
  ]
}

Details zur Lösung abrufen

Rufen Sie den DescribeEntity API-Vorgang auf, um detaillierte Informationen zu einer bestimmten Lösung zu erhalten.

Anmerkung

Die DescribeEntity Antwort gibt ein zurückEntityIdentifier, das ein EntityId mit einem RevisionId. For solutions kombiniert, die Lösungs-ID EntityId ist und für optimistisches Sperren verwendet werden RevisionId kann. Weitere Informationen finden Sie unter Identifikatoren.

Anforderung


GET /DescribeEntity?catalog=AWSMarketplace&entityId=soln-abc123456 HTTP/1.1

Antwort


{
  "Details": "{...}",
  "DetailsDocument": {
    "Lifecycle": {
      "Visibility": "Limited"
    },
    "Identifiers": {
      "Id": "soln-abc123456"
    },
    "Presentation": {
      "Title": "My Solution",
      "Name": "solution_for_customer_X",
      "ShortDescription": "Solution value proposition",
      "LongDescription": "Detailed solution description",
      "LogoUrl": "https://s3.amazonaws.com/logo.jpg",
      "UseCases": [
        {
          "Group": "advertising_and_marketing",
          "SubGroup": "ad_intelligence_and_measurement",
          "Item": "amazon_ads_insights",
          "Description": "Use case description"
        }
      ]
    },
    "RelatedProducts": {
      "AwsMarketplaceProducts": [
        {
          "ProductId": "prod-123"
        }
      ],
      "IntegrationDescription": "How products work together",
      "NonAwsMarketplaceProducts": [
        {
          "Type": "Hardware",
          "Title": "A hardware product",
          "Url": "https://example.com",
          "Description": "My hardware product description"
        }
      ]
    },
    "BuyerEngagement": [
      {
        "EngagementOption": "RequestPrivateOffer"
      }
    ]
  },
  "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456",
  "EntityIdentifier": "soln-abc123456@12",
  "EntityType": "Solution@1.0",
  "LastModifiedDate": "2025-04-22T01:02:48Z"
}

Listet den Änderungsverlauf für eine Lösung auf

Um den Änderungsverlauf für eine bestimmte Lösung anzuzeigen, rufen Sie den ListChangeSets API-Vorgang mit einem Entitätsfilter auf.

Anforderungssyntax


POST /ListChangeSets HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "FilterList": [
    {
      "Name": "EntityId",
      "ValueList": [
        "soln-abc123456"
      ]
    }
  ]
}

Taggen Sie Lösungen und Änderungssätze

Sie können Lösungen während der Erstellung Tags hinzufügen und Sets ändern oder sie später aktualisieren.

Kennzeichnen Sie während der Erstellung

Sie können Änderungen EntityTags nur zum CreateSolution Änderungstyp hinzufügen, nicht zu anderen Lösungsänderungstypen. Sie können ChangeSetTags zu jeder StartChangeSet Payload etwas hinzufügen.


POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "Test solution resource name"
      },
      "EntityTags": [
        {
          "Key": "Team",
          "Value": "Solutions"
        }
      ]
    }
  ],
  "ChangeSetTags": [
    {
      "Key": "Environment",
      "Value": "Production"
    }
  ]
}

Verwalte Tags auf vorhandenen Ressourcen

Verwenden Sie die TagResource und UntagResource API-Operationen, um Tags in vorhandenen Lösungen und Änderungssätzen zu verwalten. Wird verwendetListTagsForResource, um aktuelle Tags anzuzeigen.

Weitere Informationen finden Sie unter Verwaltung von Tags auf Ressourcen und Hinzufügen von Tags zu einer Entität und einem Änderungssatz während der Erstellung.

Erstellen Sie eine Lösung

Sie können den CreateSolution Änderungstyp verwenden, um ein neues Lösungsdokument zu erstellen, das nur eine Lösungs-ID und einen Namen enthält. Andere Werte sind noch nicht ausgefüllt.

Wenn Ihre Anfrage erfolgreich bearbeitet wurde, erstellt AWS Marketplace eine Lösung im Draft Status für Sie. Diese unvollständige Lösung ist für Käufer auf dem AWS Marketplace nicht sichtbar.

Anschließend verwenden Sie andere Änderungstypen, um die Lösung abzuschließen: UpdateInformationUpdateRelatedProducts,, UpdateBuyerEngagementOptions (optional für die Erstellung einer Limited Lösung) undReleaseSolution. Der ReleaseSolution Änderungstyp überprüft, ob alle für eine Limited Lösung erforderlichen Felder in der Lösung vorhanden sind, und verschiebt sie dann in den Bereich Limited Sichtbarkeit.

Anmerkung

Um eine Lösung in den Status Öffentlich zu versetzen oder den Status einer Lösung zu ändern, verwenden Sie den UpdateVisibility Änderungstyp, nachdem Sie die erforderlichen Werte angegeben haben.

Anforderungssyntax


POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "solution_for_customerX_en",
        "Title": "New Partner Solution"
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, um den CreateSolution Änderungstyp hinzuzufügen:

Entity(Objekt) (erforderlich) — Der benannte Typ der Lösungsentität, die erstellt wird.
- Type(string) (erforderlich) — Das Type muss seinSolution@1.0.
DetailsDocument(object) (erforderlich) — Die Details der Anfrage.
- Name(string) (erforderlich) — AWS-Ressourcenname nur als Referenz für den Verkäufer (für Käufer nicht sichtbar). Max. Länge: 100 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten. Sie können die Lösungskachel auch über den Änderungstyp aktualisieren. UpdateInformation
- Title(string) (optional) — Der Titel für Ihre Lösung. Max. Länge: 255 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten. Sie können den Lösungstitel auch über den Änderungstyp festlegen oder aktualisieren. UpdateInformation

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort gibt Ihnen das ChangeSetId undChangeSetArn:


{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Sie können den Status über das AWS Marketplace Management Portal oder den DescribeChangeSet API-Vorgang überprüfen.

Wenn die Anfrage erfolgreich abgeschlossen wurde (falls Status jaSUCCEEDED), wird eine neue Lösungs-ID generiert.

Asynchrone Fehler

CreateSolutionAktionen geben zusätzlich zu häufigen asynchronen Fehlern spezifische Fehler zurück. Diese Fehler treten auf, wenn die Verarbeitung eines Änderungssatzes abgeschlossen ist. DescribeChangeSet Informationen zum Abrufen des Status eines Änderungsantrags finden Sie unter Mit Änderungssätzen arbeiten.

Fehlercode	Fehlermeldung
UNGÜLTIGER NAME	Die Länge des Lösungsnamens ist nicht gültig. Geben Sie einen Namen ein, der zwischen 1 und 100 Zeichen lang ist, und versuchen Sie es erneut.
FEHLENDER NAME	Ein Name-Wert ist erforderlich. Geben Sie einen Name-Wert an, und versuchen Sie es erneut.
UNGÜLTIGER TITEL	Die Länge des Lösungstitels ist nicht gültig. Geben Sie einen Titel ein, der zwischen 1 und 255 Zeichen lang ist, und versuchen Sie es erneut.

Aktualisieren Sie die Lösungsinformationen

Wenn Sie bereits über eine Lösung im AWS Marketplace verfügen, können Sie die Katalog-API verwenden, um die Lösungsinformationen zu aktualisieren.

Um die Lösungsinformationen zu aktualisieren, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateInformation Änderungstyp und Ihren aktualisierten Details auf. Sehen Sie sich das folgende Beispiel an.

Anmerkung

Die UpdateInformation Änderungstypen verhalten sich wie HTTP-PATCH-Operationen für Attribute der obersten Ebene. So werden Felder aktualisiert:

Wenn ein Attribut der obersten Ebene in vorhanden istDetailsDocument, validiert der Workflow Ihre Eingabe und überschreibt vorhandene Werte.
Wenn in der kein Feld der obersten Ebene vorhanden istDetailsDocument, wird der vorhandene Wert beibehalten.
Um ein optionales Feld zu deaktivieren, senden Sie eine explizite JSON-Datei null für dieses Feld.

AWS Marketplace verifiziert Logos und Werbemedien und nimmt sie in einen Marketplace-owned AWS-Standort auf. DescribeEntity gibt eine zugängliche URL für die aufgenommenen Dateien zurück, nicht Ihre ursprüngliche Eingabe von. StartChangeSet Verwenden Sie die DescribeChangeSet API, um Ihre ursprünglich eingereichten URLs zu sehen.

Anmerkung

Wenn Sie PromotionalMedia Asset-Dateien (durch Angabe neuer URLs) in einer Public Lösung ändern, ist eine manuelle Überprüfung durch das AWS Marketplace Seller Operations Team UpdateInformation erforderlich. Dies erhöht die Ausführungszeit. Verwenden Sie es in diesem Szenario UpdateInformation separat in einem eigenen Änderungssatz.

Anforderungssyntax


POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Identifier": "soln-1234abcd",
        "Type": "Solution@1.0"
      },
      "DetailsDocument": {
        "Name": "project_cold_harbor",
        "Title": "My Awesome Solution",
        "ShortDescription": "Solution value proposition",
        "LongDescription": "Detailed solution description explaining how this addresses customer needs",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/logo.jpg",
        "PromotionalMedia": [
          {
            "Type": "Image",
            "Url": "https://s3.amazonaws.com/awsmp-media/image.jpg",
            "Title": "Sample image",
            "Description": "Sample image description"
          },
          {
            "Type": "Video",
            "Url": "https://s3.amazonaws.com/awsmp-media/video.mp4",
            "Title": "Sample video",
            "PreviewUrl": "https://s3.amazonaws.com/awsmp-media/preview.png",
            "Description": "Sample video description"
          }
        ],
        "AdditionalResources": [
          {
            "Text": "Troubleshooting guide",
            "Url": "https://example.com/troubleshooting"
          }
        ],
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Highlight description of this use case"
          }
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, um den UpdateInformation Änderungstyp hinzuzufügen:

Entity(Objekt) (erforderlich) — Der benannte Typ der Entität, die aktualisiert wird.
- Identifier(string) (erforderlich) — Die Lösungs-ID.
- Type(string) (erforderlich) — Muss seinSolution@1.0.
DetailsDocument(object) (erforderlich) — Die Details der Anfrage, einschließlich der Informationen, die Sie für Ihre Lösung aktualisieren möchten. Jedes Feld ist optional, aber Sie müssen mindestens eine Änderung angeben, um es zu aktualisieren.
- Name(string) — Der Ressourcenname der Lösung, der nur für den Verkäufer über Leseoperationen der Katalog-API sichtbar ist, für Käufer nicht sichtbar. Max. Länge: 100 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
- Title(string) — Der Titel der Lösung, der Käufern angezeigt werden soll. Max. Länge: 255 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
- ShortDescription(string) — Die Beschreibung des Nutzenversprechens der wichtigsten Aspekte der Lösung, die den Käufern angezeigt werden soll. Das sind in der Regel 2—3 Sätze. Max. Länge: 1000 Zeichen. Darf keine führenden oder nachfolgenden Leerzeichen oder Steuerzeichen enthalten.
- LongDescription(string) — Die längere Beschreibung dieser Lösung, die Käufern angezeigt werden soll. Das sind in der Regel 1—3 Absätze. Max. Länge: 5000 Zeichen. Darf keine führenden oder nachfolgenden Leerzeichen oder Steuerzeichen enthalten.
- LogoUrl(string) — Die URL zu einem Bild in einem öffentlich zugänglichen Amazon S3 S3-Bucket oder eine vorsignierte S3-URL. Muss eine direkte S3-URL sein (nicht hinter CloudFront oder API Gateway). Max. Länge: 2048 Zeichen. Spezifikationen für Logos finden Sie unter Anforderungen an Unternehmens- und Produktlogos.
- PromotionalMedia(Reihe von Objekten) — Die Liste der Werbebilder und -videos. Maximal 15 Artikel (5 Videos und 10 Bilder). Spezifikationen für Werbemedien finden Sie unter Erweitern Sie Ihr AWS Marketplace Marketplace-Produkt mit Werbemedien.
  - Type(Zeichenfolge) (erforderlich) — Entweder Image oderVideo.
  - Url(string) (erforderlich) — Die URL zur Mediendatei. Muss eine direkte S3-URL oder eine vorsignierte S3-URL sein. Max. Länge: 2048 Zeichen. Muss eine HTTPS-URL sein.
  - Title(string) (erforderlich) — Der Titel des Mediums. Max. Länge: 100 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
  - Description(string) (erforderlich) — Die Beschreibung des Mediums. Maximale Länge: 200 Zeichen Darf keine führenden oder abschließenden Leerzeichen oder Steuerzeichen enthalten.
  - PreviewUrl(string) (optional) — Nur für Videos die URL zu einem Vorschaubild. Max. Länge: 2048 Zeichen. Muss eine HTTPS-URL sein.
- AdditionalResources(Array von Objekten) — Die Liste der Verweise auf zusätzliche Ressourcen. Maximal 8 Artikel.
  - Text(string) — Der Name oder Titel der Ressource. Max. Länge: 500 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
  - Url(string) — Die URL zur Ressource. Maximale Länge: 2048 Zeichen. Muss eine HTTPS-URL sein.
- UseCases(Array von Objekten) — Die Liste der Anwendungsfälle, die mit dieser Lösung behandelt werden. Max. 3 Artikel. Gültige Anwendungsfallkategorien (eine Kombination aus Gruppe SubGroup, und Element) finden Sie in der Liste der Anwendungsfallkategorien für aktive akzeptierte Werte und ihre Einführungsbezeichnungen. Die Kombination aus Gruppe SubGroup, und Element muss ein gültiges Element in der Liste der Anwendungsfallkategorien sein.
  - Group(Zeichenfolge) — Branchen- oder Technologiekategorie. Muss einer der Gruppenwerte in der Liste der Anwendungsfallkategorien sein.
  - SubGroup(string) — Anwendungsfallgruppe innerhalb der Kategorie. Muss einer der SubGroup Werte in der Liste der Anwendungsfallkategorien sein.
  - Item(string) — Spezifischer Anwendungsfall. Muss einer der Elementwerte in der Liste der Anwendungsfallkategorien sein.
  - Description(string) — Beschreibung, wie diese Lösung den Anwendungsfall behandelt. Max. Länge: 500 Zeichen. Darf keine führenden oder abschließenden Leerzeichen oder Steuerzeichen enthalten.

Informationen zu vorsignierten URLs finden Sie unter Objekte mit vorsignierten URLs gemeinsam nutzen.

Anmerkung

Beim Aufrufen von UpdateInformation ChangeType können Sie jederzeit eine Teilmenge von Feldern angeben, die im Objekt aktualisiert werden sollen. DetailsDocument Bevor Sie jedoch eine Lösung von Draft nach verschiebenLimited, müssen die folgenden Felder korrekt festgelegt werden:Title, ShortDescriptionLongDescription, undLogoUrl.

Wenn Sie jedoch vorhandene Felder in der Lösung aktualisieren, können Sie nur die Attribute in das DetailsDocument Objekt des Änderungstyps aufnehmen, die UpdateInformation geändert werden müssen.

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.


{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Um den Status der Anfrage zu überprüfen, verwenden Sie das AWS Marketplace Management Portal oder rufen Sie die DescribeChangeSet API auf.

Nach dem Auslösen dieses Änderungstyps mit PromotionalMedia Ressourcen, die für eine Public Lösung geändert wurden, kann es bis zu 37 Tage dauern, bis der Vorgang abgeschlossen ist. Dies beinhaltet die Zeit, die das AWS Marketplace Seller Operations Team zur Überprüfung, Prüfung und Genehmigung benötigt.

Asynchrone Fehler

Zusätzlich zu den häufigen asynchronen Fehlern sind die folgenden Fehler spezifisch für UpdateInformation Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter Mit Änderungssätzen arbeiten. DescribeChangeSet

Fehlercode	Fehlermeldung
INVALID_SHORT_DESCRIPTION	Die ShortDescription Länge der Lösung ist nicht gültig. Geben Sie einen ShortDescription Wert zwischen 1 und 1000 Zeichen ein, und versuchen Sie es erneut.
INVALID_LONG_DESCRIPTION	Die LongDescription Länge der Lösung ist nicht gültig. Geben Sie ein Zeichen ein LongDescription , das zwischen 1 und 5000 Zeichen lang ist, und versuchen Sie es erneut.
UNGÜLTIGER_NAME	Die Länge des Lösungsnamens ist nicht gültig. Geben Sie einen Namen ein, der zwischen 1 und 100 Zeichen lang ist, und versuchen Sie es erneut.
UNGÜLTIGER TITEL	Die Länge des Lösungstitels ist nicht gültig. Geben Sie einen Titel ein, der zwischen 1 und 255 Zeichen lang ist, und versuchen Sie es erneut.
INVALID_ADDITIONAL_RESOURCES	Die Lösung AdditionalResources [%d] .Die Textlänge ist nicht gültig. Geben Sie einen Text ein, der zwischen 1 und 500 Zeichen lang ist, und versuchen Sie es erneut.
INVALID_ADDITIONAL_RESOURCES	Auf die folgenden URLs in den bereitgestellten zusätzlichen Ressourcen kann nicht zugegriffen werden: [%s]. Geben Sie gültige und zugängliche URLs an
UNGÜLTIGE_ZUSÄTZLICHE_RESSOURCEN	Ein URL-Wert ist erforderlich. Geben Sie einen URL-Wert an und versuchen Sie es erneut.
UNGÜLTIGE_ZUSÄTZLICHE_RESSOURCEN	Text darf nicht fehlen. Geben Sie einen Text ein
UNGÜLTIGER_USE_CASE	Die Lösung UseCases [%d]. Die Länge der Beschreibung ist nicht gültig. Geben Sie eine Beschreibung ein, die zwischen 1 und 500 Zeichen lang ist, und versuchen Sie es erneut.
INVALID_USE_CASE	UseCases[%d] .Group: Die angegebene Gruppe (%s) ist ungültig. Geben Sie eine gültige Gruppe an.
INVALID_USE_CASE	UseCases[%d]. SubGroup: Die angegebene Gruppe (%s) ist ungültig. Geben Sie eine gültige an SubGroup.
INVALID_USE_CASE	UseCases[%d] .Item: Der angegebene Artikel (%s) ist ungültig. Geben Sie einen gültigen Artikel an.
INVALID_USE_CASE	UseCases[%d] .Item: Der angegebene Anwendungsfall ist inaktiv. Geben Sie einen aktiven Anwendungsfall an
INVALID_USE_CASE	UseCases[%d] .Group: Gruppe darf nicht fehlen. Geben Sie eine Gruppe an.
INVALID_USE_CASE	UseCases[%d]. SubGroup: SubGroup darf nicht fehlen. Geben Sie eine an SubGroup.
INVALID_USE_CASE	UseCases[%d] .Artikel: darf nicht fehlen. SubGroup Geben Sie einen Artikel an.
INVALID_MEDIA	Die Lösung PromotionalMedia [%d] .Titellänge ist nicht gültig. Geben Sie einen Titel ein, der zwischen 1 und 100 Zeichen lang ist, und versuchen Sie es erneut.
INVALID_MEDIA	Die Lösung PromotionalMedia [%d]. Die Länge der Beschreibung ist nicht gültig. Geben Sie eine Beschreibung ein, die zwischen 1 und 200 Zeichen lang ist, und versuchen Sie es erneut.
INVALID_MEDIA	Ungültige URL: %s Geben Sie eine neue URL für in S3 gespeicherte Medien an.
INVALID_MEDIA	Auf den Medienstandort kann nicht zugegriffen werden: %s Geben Sie eine neue, zugängliche URL für Medien ein, die an einem der folgenden Speicherorte gespeichert sind: [S3].
INVALID_MEDIA	Die Bildgröße überschreitet %s. Geben Sie ein Bild an, das unter %s liegt.
INVALID_MEDIA	Die Videogröße überschreitet %s. Geben Sie ein Video an, das unter %s liegt.
INVALID_MEDIA	Die Größe des Logos überschreitet %s. Geben Sie ein Logo an, das unter %s liegt.
INVALID_MEDIA	In %s wurde Malware entdeckt. Stellen Sie Medien ohne Malware bereit.
INVALID_MEDIA	Unangemessener Inhalt: %s erkannt. Stellen Sie Medien ohne unangemessenen Inhalt bereit
INVALID_MEDIA	Expliziter Inhalt in %s: '{ExplicitContent}' erkannt. Stellen Sie Medien ohne expliziten Inhalt bereit.
INVALID_MEDIA	PromotionalMedia[%s] .Url: %s hat kein unterstütztes Format (%s). Verwenden Sie ein wohlgeformtes Bild in einem unterstützten Format: [JPEG, PNG].
INVALID_MEDIA	PromotionalMedia[%s] .Url: %s hat kein unterstütztes Format (%s). Verwenden Sie ein wohlgeformtes Video in einem unterstützten Format: [MP4, MOV].
INVALID_MEDIA	LogoUrl hat bei %s ein ungültiges Seitenverhältnis. Stellen Sie ein Bild mit einem Seitenverhältnis von 1:1 (quadratisch) oder 2:1 (breit) bereit.
INVALID_MEDIA	Das Logo: %s hat ungültige Abmessungen. Stellen Sie ein Bild zwischen 120x120 und 1080x1080 Pixeln bereit.
INVALID_MEDIA	PromotionalMedia[%d] .Type wird nicht unterstützt. Geben Sie PromotionalMedia einen unterstützten Typ an: %s
DUPLICATE_MEDIA	Doppelte Medien erkannt: [%s] Stellt Medienelemente ohne Duplikate bereit.
INVALID_MEDIA	PromotionalMedia[%d] .Url: In %s wurde Malware entdeckt. Stellen Sie Medien ohne Malware bereit.
ZU VIELE_ARTIKEL	Geben Sie nicht mehr als %d %s an.

Sie können die Catalog API verwenden, um die in Ihrer Lösung enthaltenen Produkte und Services zu aktualisieren, einschließlich AWS Marketplace Marketplace-Produkte und Produkte, die nicht von AWS Marketplace stammen.

Um verwandte Produkte zu aktualisieren, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateRelatedProducts Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anmerkung

Der UpdateRelatedProducts Änderungstyp verhält sich wie ein HTTP-PATCH-Vorgang für Attribute der obersten Ebene. Sie können alle aktuellen AWS Marketplace Marketplace-Produkttypen wie folgt AwsMarketplaceProducts bereitstellenUpdateRelatedProducts.

Anforderungssyntax


POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-123456"
      },
      "DetailsDocument": {
        "IntegrationDescription": "How to use the products in this solution (usage guide)",
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          },
          {
            "ProductId": "prod-456"
          }
        ],
        "NonAwsMarketplaceProducts": [
          {
            "Type": "Hardware",
            "Title": "Diamond engine",
            "Description": "Hardware details",
            "Url": "https://example.com/hardware-product-specs.html"
          }
        ]
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, um den UpdateRelatedProducts Änderungstyp hinzuzufügen:

Entity(Objekt) (erforderlich) — Der benannte Typ der Entität, die aktualisiert wird.
- Identifier(string) (erforderlich) — Die Lösungs-ID.
- Type(string) (erforderlich) — Muss seinSolution@1.0.
DetailsDocument(object) (erforderlich) — Die Details der Anfrage. Jedes Feld ist optional, aber Sie müssen mindestens eine Änderung vornehmen, um es zu aktualisieren.
- IntegrationDescription(string) — Beschreibung, wie die Produkte in dieser Lösung zusammenarbeiten. Max. Länge: 5000 Zeichen. Darf keine führenden oder nachfolgenden Leerzeichen oder Steuerzeichen enthalten.
- AwsMarketplaceProducts(Reihe von Objekten) — AWS Marketplace Marketplace-Produkte, die in dieser Lösung enthalten sind. Max. 5 Artikel
  - ProductId(string) — AWS Marketplace Marketplace-Produkt-ID (eine UUID oder eine Zeichenfolge, die mit prod- beginnt). Max. Länge: 50 Zeichen.
- NonAwsMarketplaceProducts(Array von Objekten) — Produkte, die nicht auf AWS Marketplace verfügbar sind. Maximal 5 Artikel.
  - Type(string) (erforderlich) — Typ des Produkts. Mögliche Werte:Software,Consulting,Hardware,Communication,Professional Service,Managed Service,Value-Added Resale, Training
  - Title(string) (erforderlich) — Titel des Produkts. Max. Länge: 255 Zeichen. Darf keine führenden oder abschließenden Leerzeichen, Zeilenumbrüche oder Steuerzeichen enthalten.
  - Description(string) (optional) — Beschreibung des Produkts. Max. Länge: 220 Zeichen. Darf keine führenden oder nachfolgenden Leerzeichen oder Steuerzeichen enthalten.
  - Url(string) (optional) — URL zu weiteren Informationen über das Produkt. Max. Länge: 2048 Zeichen. Muss eine HTTPS-URL sein.

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.


{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet.

Um den Status der Anfrage zu überprüfen, verwenden Sie das AWS Marketplace Management Portal oder rufen Sie die DescribeChangeSet API auf.

Asynchrone Fehler

Zusätzlich zu den häufigen asynchronen Fehlern sind die folgenden Fehler spezifisch für UpdateRelatedProducts Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter Mit Änderungssätzen arbeiten. DescribeChangeSet

Fehlercode	Fehlermeldung
INCOMPATIBLE_OPERATION_UPDATE_RELATED_PRODUCTS_SOLUTION	Der Vorgang zum Aktualisieren verwandter Produkte wird für öffentliche Lösungen nicht unterstützt. Um diese Änderung vorzunehmen, setzen Sie zunächst die Sichtbarkeit der Lösung auf Eingeschränkt und versuchen Sie es erneut.
UNGÜLTIG_ AWS_MARKETPLACE_PRODUCTS	Das AWS Marketplace Marketplace-Produkt '%s' ist für Ihr Konto nicht verfügbar. Wählen Sie ein öffentliches Produkt oder ein limitiertes Produkt, für das Sie Zugriff auf die Zulassungsliste haben, oder wenden Sie sich an den Verkäufer, um Zugriff zu beantragen.
UNGÜLTIG_ AWS_MARKETPLACE_PRODUCTS	Der angegebene Produkttyp '%s' wird nicht unterstützt. Geben Sie einen der folgenden gültigen Produkttypen an: [AmiProduct, SaasProduct,,, ContainerProduct MachineLearningProduct ProfessionalServicesProduct, DataProduct] und versuchen Sie es erneut.
UNGÜLTIG_ AWS_MARKETPLACE_PRODUCTS	Produkt '%s' wurde nicht gefunden. Geben Sie eine gültige Produkt-ID im selben Katalog ein.
UNGÜLTIG_NON_ AWS_MARKETPLACE_PRODUCTS	Auf die angegebenen Non-AWS Marketplace-Produkt-URLs kann nicht zugegriffen werden: [%s]. Stellen Sie sicher, dass die URLs gültig und öffentlich zugänglich sind, und versuchen Sie es erneut.
INVALID_INTEGRATION_DESCRIPTION	Geben Sie eine Lösung mit einer Länge IntegrationDescription zwischen 1 und 5000 Zeichen an.
UNGÜLTIG_NON_ AWS_MARKETPLACE_PRODUCTS	Die Lösung NonAwsMarketplaceProduct [%d] .Titellänge ist nicht gültig. Geben Sie eine Beschreibung ein, die zwischen 1 und 255 Zeichen lang ist, und versuchen Sie es erneut.
UNGÜLTIG_NON_ AWS_MARKETPLACE_PRODUCTS	Die Lösung NonAwsMarketplaceProduct [%d]. Die Länge der Beschreibung ist nicht gültig. Geben Sie eine Beschreibung ein, die zwischen 1 und 220 Zeichen lang ist, und versuchen Sie es erneut.
UNGÜLTIG_NON_ AWS_MARKETPLACE_PRODUCTS	Die Lösung NonAwsMarketplaceProduct [%d]. Die Länge des Typs ist nicht gültig. Geben Sie einen Typ ein, der zwischen 1 und 50 Zeichen lang ist, und versuchen Sie es erneut.
UNGÜLTIG_NON_ AWS_MARKETPLACE_PRODUCTS	NonAwsMarketplaceProduct[%d] .Type ist kein gültiger Produkttyp, der nicht von AWS Marketplace stammt. Stellen Sie einen der folgenden Nicht-AWS-Marketplace-Produkttypen bereit: [%s]
UNGÜLTIG_NON_ AWS_MARKETPLACE_PRODUCTS	Ein Wert von NonAwsMarketplaceProduct [%d] .Title ist erforderlich. Geben Sie einen Titelwert an und versuchen Sie es erneut.
UNGÜLTIG_NON_ AWS_MARKETPLACE_PRODUCTS	Ein Wert vom NonAwsMarketplaceProduct Typ [%d] .Type ist erforderlich. Geben Sie einen Type-Wert an und versuchen Sie es erneut.
ZU VIELE_PRODUKTE	Die maximale Anzahl von AWS Marketplace Marketplace-Produkten, die Sie verknüpfen können, ist %d. Entfernen Sie vorhandene verknüpfte Produkte, bevor Sie neue hinzufügen.
ZU VIELE_PRODUKTE	Die maximale Anzahl von Produkten ohne AWS Marketplace, die Sie hinzufügen können, ist %d. Entfernen Sie vorhandene Produkte ohne AWS Marketplace, bevor Sie neue hinzufügen.
UNGÜLTIG_ AWS_MARKETPLACE_PRODUCTS	Doppelte AWS Marketplace Marketplace-Produkt-IDs sind nicht zulässig. Jede Produkt-ID muss in Ihrer Lösung einzigartig sein.
INVALID_REMOVE_OPERATION	Ungültiger Vorgang. Sie können nicht alle Produkte entfernen.

Eine Lösung veröffentlichen

Sie können die Catalog API verwenden, um eine Draft Lösung Limited sichtbar im AWS Marketplace zu veröffentlichen.

Der ReleaseSolution Änderungstyp bestätigt, dass alle erforderlichen Felder für eine Limited Lösung vorhanden sind. Anschließend wird die Lösung aus dem Bereich Limited Sichtbarkeit Draft verschoben. Sobald eine Lösung Limited sichtbar ist, können Sie sie nicht wieder Draft sichtbar machen.

Um eine Lösung freizugeben, rufen Sie den StartChangeSet API-Vorgang mit dem ReleaseSolution Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax


POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {}
    }
  ]
}

Geben Sie Informationen für die Felder an, um den ReleaseSolution Änderungstyp hinzuzufügen:

Entity(Objekt) (erforderlich) — Der benannte Entitätstyp, der veröffentlicht wird.
- Identifier(string) (erforderlich) — Die Lösungs-ID.
- Type(string) (erforderlich) — Muss seinSolution@1.0.
DetailsDocument(object) (erforderlich) — Muss ein leeres Objekt sein. Der Änderungstyp ReleaseSolution akzeptiert keine Details.

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.


{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet. Sie können den Status der Anfrage über das AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Asynchrone Fehler

Zusätzlich zu den häufigen asynchronen Fehlern sind die folgenden Fehler spezifisch für ReleaseSolution Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter Mit Änderungssätzen arbeiten. DescribeChangeSet

Fehlercode	Fehlermeldung
MISSING_REQUIRED_FIELDS	In der Anfrage fehlen die erforderlichen Parameter: [%s]. Geben Sie Werte für alle erforderlichen Parameter an, und versuchen Sie es erneut.
INCOMPATIBLE_OPERATION_RELEASE_SOLUTION	Der Änderungstyp kann nur für Lösungen im Status Entwurf aufgerufen werden. Ändern Sie die Sichtbarkeit der Lösung auf Entwurf und versuchen Sie es erneut.

Aktualisieren Sie die Optionen zur Käuferbindung

Sie können die Katalog-API verwenden, um zu konfigurieren, wie Käufer mit Ihnen über Ihre Lösung sprechen.

Anmerkung

Um diesen Änderungstyp verwenden zu können, müssen Sie sich aktiv für das APN Customer Engagements (ACE) -Programm angemeldet haben. Sie müssen Ihr AWS-Konto auch mit Ihrem AWS Partner Central-Konto verknüpfen, das bei ACE registriert ist. Anweisungen finden Sie unter Verknüpfen von AWS Partner Central- und AWS-Konten.

Um die Optionen für die Kundenbindung zu aktualisieren, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateBuyerEngagementOptions Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax


POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": [
        {
          "EngagementOption": "RequestProductDemo"
        },
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    }
  ]
}

Geben Sie Informationen für die Felder an, um den UpdateBuyerEngagementOptions Änderungstyp hinzuzufügen:

Entity(Objekt) (erforderlich) — Der benannte Typ der Entität, die aktualisiert wird.
- Identifier(string) (erforderlich) — Die Lösungs-ID.
- Type(string) (erforderlich) — Muss seinSolution@1.0.
DetailsDocument(Reihe von Objekten) (erforderlich) — Die Optionen zur Kundenbindung, die aktiviert werden sollen.
- EngagementOption(string) (erforderlich) — Die Art der Interaktionsoption. Zulässige Werte: RequestPrivateOffer, RequestProductDemo.

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.


{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet.

Um den Status der Anfrage zu überprüfen, verwenden Sie das AWS Marketplace Management Portal oder rufen Sie die DescribeChangeSet API auf.

Asynchrone Fehler

Zusätzlich zu den häufigen asynchronen Fehlern sind die folgenden Fehler spezifisch für UpdateBuyerEngagementOptions Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter Mit Änderungssätzen arbeiten. DescribeChangeSet

Fehlercode	Fehlermeldung
INELIGIBLE_SELLER	Die Überprüfung der ACE-Eignung ist nicht abgeschlossen. Um fortzufahren: 1) Verknüpfen Sie Ihr AWS Marketplace Marketplace-Konto mit Ihrem APN-Konto, 2) Erfüllen Sie die ACE-Zulassungsvoraussetzungen.

Aktualisieren Sie die Sichtbarkeit der Lösung

Sie können die Catalog API verwenden, um die Sichtbarkeit einer Lösung im AWS Marketplace zu aktualisieren.

Sie können die Zielsichtbarkeit auf LimitedPublic, oder Restricted festlegen.

Limited— Die Lösung ist abgeschlossen und der ReleaseSolution Änderungstyp wurde erfolgreich abgeschlossen. In dieser Ansicht können Sie eine Vorschau der Informationen zur Lösung auf der Website des Käufers anzeigen. Auf der AWS Marketplace-Käuferwebsite ist die Lösung nur für das Eigentümerkonto, die Eigentümer der einzelnen AWS Marketplace Marketplace-Produkte, die in der Lösung enthalten sind, und das AWS Marketplace Seller Operations Team sichtbar.
Public— Die Lösung ist auf dem AWS Marketplace sichtbar. Käufer können sich die Lösung ansehen und mit ihr interagieren.
Restricted— Die Lösung ist auf der Käuferwebsite von AWS Marketplace nicht mehr öffentlich sichtbar.

Anmerkung

Um eine Lösung Public sichtbar zu machen, müssen Sie die folgenden Anforderungen erfüllen:

Sie müssen über ein öffentliches Profil auf AWS Marketplace verfügen.
Die Lösung darf keine Produkte enthalten, die keine Public Produkte sind.
Die Lösung muss mindestens 2 Public AWS Marketplace Marketplace-Produkte enthalten.
Die Lösung muss mindestens ein AWS Marketplace Marketplace-Produkt aus demselben AWS-Konto enthalten.
Für die Lösung muss die Option RequestPrivateOffer zur Kundenbindung aktiviert sein.
Das AWS Marketplace Seller Operations Team prüft alle Anfragen, um eine Lösung Public sichtbar zu machen. Support finden Sie unter Support für AWS Marketplace erhalten.

Wenn Sie TargetVisibility diese Option wählenPublic, muss der UpdateVisibility Änderungstyp manuell vom AWS Marketplace Seller Operations Team überprüft werden. Dies erhöht die Ausführungszeit. Wird UpdateVisibility separat in einem eigenen Änderungssatz verwendet.

Um die Sichtbarkeit Ihrer Lösung zu aktualisieren, rufen Sie den StartChangeSet API-Vorgang mit dem UpdateVisibility Änderungstyp auf, wie im folgenden Beispiel gezeigt.

Anforderungssyntax

Für wann TargetVisibility ist Public oderLimited.


POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Public"
      }
    }
  ]
}

Für wann TargetVisibility istRestricted.


POST /StartChangeSet HTTP/1.1
Content-type: application/json

{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "UpdateVisibility",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "soln-1234abcd"
      },
      "DetailsDocument": {
        "TargetVisibility": "Restricted"
      }
    }
  ]
}

Geben Sie Informationen für die Felder an, um den UpdateVisibility Änderungstyp hinzuzufügen:

Entity(Objekt) (erforderlich) — Der benannte Typ der Entität, die aktualisiert wird.
- Identifier(string) (erforderlich) — Die Lösungs-ID.
- Type(string) (erforderlich) — Muss seinSolution@1.0.
DetailsDocument(object) (erforderlich) — Die Details, die zur Ausführung des Änderungssatzes erforderlich sind.
- TargetVisibility(string) (erforderlich) — Die beabsichtigte neue Sichtbarkeit der Lösung. Die möglichen Werte lauten: Public, Limited und Restricted.

Syntax der Antwort

Für Ihre Anfrage wird ein Änderungssatz erstellt. Die Antwort auf diese Anfrage gibt Ihnen das ChangeSetId und ChangeSetArn für den Änderungssatz und sieht wie folgt aus.


{
  "ChangeSetId": "example123456789012abcdef",
  "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef"
}

Die Änderungsanforderung wird einer Warteschlange hinzugefügt und verarbeitet.

Sie können den Status der Anfrage über das AWS Marketplace Management Portal oder direkt über die Catalog API mithilfe des DescribeChangeSet API-Vorgangs überprüfen.

Nachdem Sie diesen Änderungstyp mit TargetVisibility as ausgelöst habenPublic, kann es bis zu 37 Tage dauern, bis der Vorgang abgeschlossen ist. Dies beinhaltet die Zeit, die das AWS Marketplace Seller Operations Team zur Überprüfung, Prüfung und Genehmigung benötigt.

Asynchrone Fehler

Die folgenden Fehler beziehen sich spezifisch auf UpdateVisibility Aktionen in der AWS Marketplace Catalog API. Diese Fehler werden zurückgegeben, wenn Sie aufrufen, DescribeChangeSet nachdem ein Änderungssatz verarbeitet wurde. Weitere Informationen zum Abrufen des Status einer Änderungsanforderung finden Sie unter Mit Änderungssätzen arbeiten. DescribeChangeSet

Fehlercode	Fehlermeldung
INVALID_VISIBILITY_TRANSITION	Die Lösung kann nicht in den Status Entwurf zurückversetzt werden. Nach der Veröffentlichung können Lösungen nur zwischen dem Status „Eingeschränkt“, „Öffentlich“ und „Eingeschränkt“ wechseln.
ZU WENIGE ANWENDUNGSFÄLLE	Mindestens ein Anwendungsfall ist erforderlich, um eine Lösung zu veröffentlichen. Fügen Sie einen Anwendungsfall hinzu und versuchen Sie es erneut.
ZU WENIGE ÖFFENTLICHE PRODUKTE	Es sind mindestens 2 öffentliche AWS Marketplace Marketplace-Produkte erforderlich, um eine Lösung zu veröffentlichen. Fügen Sie die erforderlichen Produkte hinzu und versuchen Sie es erneut.
INKOMPATIBLE_PRODUCTS	Die Lösung enthält ein oder mehrere nicht öffentliche AWS Marketplace Marketplace-Produkte. Um die Lösung zu veröffentlichen, entfernen Sie alle nicht öffentlichen Produkte und versuchen Sie es erneut.
ZU WENIGE PRODUKTE, DIE SICH SELBST GEHÖREN	Für die Lösung ist mindestens ein AWS Marketplace Marketplace-Produkt erforderlich, das dem Eigentümer der Lösung gehört. Fügen Sie ein AWS Marketplace Marketplace-Produkt aus Ihrem Konto hinzu und versuchen Sie es erneut.
INCOMPATIBLE_BUYER_ENGAGEMENT_OPTIONS	Die Option zur Kundenbindung muss aktiviert sein, um RequestPrivateOffer diese Lösung öffentlich zugänglich zu machen. Aktivieren Sie RequestPrivateOffer und versuchen Sie es erneut.
INCOMPATIBLE_OPERATION_UPDATE_VISIBILITY	UpdateVisibility wird für Lösungen im Status Entwurf nicht unterstützt. Veröffentlichen Sie die Lösung zuerst von „Entwurf“ in „Eingeschränkt“ und verwenden Sie sie dann ReleaseSolution, UpdateVisibility um zu „Öffentlich“ oder „Eingeschränkt“ zu wechseln.
LIMIT_EXCEEDED_TOO_MANY_PUBLIC_SOLUTIONS	Dieses Konto hat sein Limit von 5 öffentlichen Lösungen erreicht. Aktualisieren Sie eine bestehende öffentliche Lösung auf Eingeschränkte oder Eingeschränkte Sichtbarkeit und versuchen Sie es erneut.
FEHLENDE ANGABEN ZUM VERKÄUFERPROFIL	Ein öffentliches Verkäuferprofil ist erforderlich, um Lösungen zu veröffentlichen. Erstellen Sie in Ihrem Verkäuferkonto ein öffentliches Profil und versuchen Sie es erneut.

Häufige asynchrone Fehlercodes

Es gibt einige asynchrone Validierungen, die für alle Arten von Lösungsänderungen gelten, z. B. Prüfungen auf URL-Gültigkeit und nicht unterstützte Zeichen. Die zugehörigen Fehlercodes und Fehlermeldungen sind hier aufgeführt.

Jedes bereitgestellte URL-Feld muss das HTTPS-Protokoll verwenden und den Standards RFC2396 oder RFC 2732 entsprechen.

Fehlercode	Fehlermeldung
UNGÜLTIGE_EINGABE	Ungültiges Feld '%s' Nicht unterstützte Zeichen %s entfernen.
UNGÜLTIGE_EINGABE	Unangemessener Inhalt '%s' wurde im Feld %s gefunden. Geben Sie %s ohne unangemessenen Inhalt ein.
UNSUPPORTED_CATALOG	Der angeforderte Katalog %s wird von diesem Änderungstyp nicht unterstützt.
INVALID_REMOVE_OPERATION	Ungültiger Vorgang, Sie können %s nicht entfernen
AUDIT_ERROR	(variiert je nach Prüfungsergebnis des AWS Marketplace Seller Operations Teams)

Lebenszyklus der Lösung

Lösungen werden anhand der folgenden Sichtbarkeitswerte weiterentwickelt:

Draft- Erste Sichtbarkeit nach der Erstellung. Mithilfe anderer Änderungstypen können Sie schrittweise Informationen hinzufügen.
Limited- Die Lösung ist vollständig und kann von Ihnen und den Produktbesitzern als Vorschau angesehen werden. Dies erreichen Sie durch die Verwendung vonReleaseSolution.
Public- Die Lösung ist für alle Käufer sichtbar, die die AWS Marketplace Marketplace-Website besuchen. Dies erfordert eine zusätzliche Validierung.
Restricted- Die Lösung ist für neue Käufer nicht mehr sichtbar.

Wichtig

Sobald eine Lösung von Draft der Limited Sichtbarkeit zurückgegangen ist, können Sie sie nicht wieder in den Bereich „Sichtbarkeit“ verschiebenDraft. ReleaseSolutionüberprüft vor dem Übergang zur Limited Sichtbarkeit, ob alle erforderlichen Felder für eine Limited Lösung vorhanden sind.

Mindestanforderungen für eine Komplettlösung

Um eine vollständige Lösung zu erstellen und sie über den Status Entwurf hinaus zu veröffentlichen, benötigen Sie die folgenden Änderungstypen und Attribute:

CreateSolution: Name
UpdateInformation: Title, ShortDescription, LongDescription, LogoUrl
UpdateRelatedProducts:IntegrationDescription, mindestens ein Element quer durch AwsMarketplaceProducts und NonAwsMarketplaceProducts
ReleaseSolution

Das folgende Beispiel zeigt Ihnen, wie Sie eine vollständige Lösung mit Limited Sichtbarkeit in einem einzigen Änderungssatz erstellen:


{
  "Catalog": "AWSMarketplace",
  "ChangeSet": [
    {
      "ChangeType": "CreateSolution",
      "Entity": {
        "Type": "Solution@1.0"
      },
      "ChangeName": "CreateSolutionChange",
      "DetailsDocument": {
        "Name": "complete_solution_example",
        "Title": "Complete Solution Example"
      }
    },
    {
      "ChangeType": "UpdateInformation",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateInformationChange",
      "DetailsDocument": {
        "ShortDescription": "A comprehensive solution for customer needs",
        "LongDescription": "This solution combines multiple products to address specific customer requirements in the advertising and marketing space.",
        "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/solution-logo.jpg",
        "UseCases": [
          {
            "Group": "advertising_and_marketing",
            "SubGroup": "ad_intelligence_and_measurement",
            "Item": "amazon_ads_insights",
            "Description": "Provides comprehensive advertising insights and measurement capabilities"
          }
        ]
      }
    },
    {
      "ChangeType": "UpdateRelatedProducts",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateRelatedProductsChange",
      "DetailsDocument": {
        "AwsMarketplaceProducts": [
          {
            "ProductId": "prod-123"
          }
        ],
        "IntegrationDescription": "These products work together to provide end-to-end advertising analytics and optimization capabilities."
      }
    },
    {
      "ChangeType": "UpdateBuyerEngagementOptions",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "UpdateBuyerEngagementChange",
      "DetailsDocument": [
        {
          "EngagementOption": "RequestPrivateOffer"
        }
      ]
    },
    {
      "ChangeType": "ReleaseSolution",
      "Entity": {
        "Type": "Solution@1.0",
        "Identifier": "$CreateSolutionChange.Entity.Identifier"
      },
      "ChangeName": "ReleaseSolutionChange",
      "DetailsDocument": {}
    }
  ]
}

IAM-Berechtigungen für Lösungen

Die AWS Marketplace Catalog API verwendet Standard-IAM-Berechtigungen. Weitere Informationen finden Sie unter Zugriffskontrolle für die AWS Marketplace Catalog API.

Sie können AWSMarketplaceSellerProductFullAccess damit alle Vorgänge ausführen, die für den Zugriff auf die Lösung über die Catalog API und Partner Central 3.0 in der AWS-Managementkonsole erforderlich sind.

Beispiel für eine IAM-Richtlinie für Lösungen

Die folgende Beispiel-IAM-Richtlinie ermöglicht bestimmte Aktionen (DescribeEntityListEntities, undStartChangeSet) für die Entität. Solution@1.0 Sie können sie weiter eingrenzen, um den Zugriff eines Prinzipals auf bestimmte Änderungstypen für bestimmte Entitäts-IDs einzuschränken, oder sie erweitern, sodass ein Principal auch mit einem anderen Entitätstyp arbeiten kann, der von der Catalog API unterstützt wird.


{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "CreateSolution",
            "UpdateInformation",
            "UpdateRelatedProducts",
            "ReleaseSolution",
            "UpdateBuyerEngagementOptions",
            "UpdateVisibility"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ListEntities",
        "aws-marketplace:DescribeEntity"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeChangeSet",
        "aws-marketplace:ListChangeSets",
        "aws-marketplace:CancelChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:TagResource",
        "aws-marketplace:UntagResource",
        "aws-marketplace:ListTagsForResource"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*",
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*"
      ]
    }
  ]
}

Beschränken Sie den Zugriff auf bestimmte Lösungen

Sie können den Zugriff auf bestimmte Lösungen einschränken, indem Sie die Lösungs-ID im Ressourcen-ARN verwenden:


{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:DescribeEntity",
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-specific123"
      ]
    }
  ]
}

Beschränken Sie den Zugriff auf bestimmte Änderungstypen

Sie können den Zugriff auf bestimmte Änderungstypen mithilfe von Bedingungsschlüsseln einschränken:


{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartChangeSet"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*"
      ],
      "Condition": {
        "StringEquals": {
          "catalog:ChangeType": [
            "UpdateInformation",
            "UpdateRelatedProducts"
          ]
        }
      }
    }
  ]
}

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Arbeiten Sie mit Mehrproduktlösungen

Mit Angebotssets arbeiten