View a markdown version of this page

Verwendung der AWS Marketplace Vereinbarungs-API - AWS Marketplace
Die wichtigsten KonzepteEndpointBerechtigungen

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.

Verwendung der AWS Marketplace Vereinbarungs-API

AWS Marketplace ist ein kuratierter digitaler Katalog, mit dem Kunden Software, Daten und Dienste von Drittanbietern suchen, kaufen, bereitstellen und verwalten können, um Lösungen zu entwickeln und ihr Geschäft zu führen. Der AWS Marketplace Agreement Service bietet eine API-Schnittstelle, die AWS Marketplace Käufer und Verkäufer bei der Verwaltung ihrer Verträge unterstützt, einschließlich der Auflistung, Suche und Filterung von Verträgen.

Die wichtigsten Konzepte

In der folgenden Tabelle werden die wichtigsten Konzepte beschrieben, die in der AWS Marketplace Agreement API verwendet werden.

Konzept Description
Akzeptor Die Partei, die alle oder einen Teil der vom Antragsteller in einer Vereinbarung verlängerten Bedingungen akzeptiert. In den meisten Fällen handelt es sich bei den Akzeptoren um die Käufer des Produkts.
Vereinbarung Ein Dokument, das für zwei Parteien bindend ist, darunter den Anbieter (üblicherweise der seller/ISV Vertriebspartner) und den Abnehmer (üblicherweise der Käufer), und das die zwischen ihnen geltenden Bedingungen und Konditionen festlegt.
Antrag auf Kündigung des Vertrags Eine vom Verkäufer (Vorschlagenden) initiierte Anfrage zur Kündigung eines aktiven Vertrags. Der Käufer (Akzeptor) kann die Stornierungsanfrage annehmen oder ablehnen. Bei Annahme wird der Workflow zur Kündigung des Vertrags asynchron ausgeführt und der Status der Vereinbarung ändert sich in Storniert. Wenn der Vertrag abgelehnt wird, bleibt er aktiv und der Verkäufer kann eine neue Stornierungsanfrage stellen.
Vorschlag für eine Vereinbarung Entität, die sich auf die von der terms/offer vorgeschlagenen Gruppe bezieht seller/proposer.
Anfrage zur Vereinbarung Entität, die sich auf die Ressource bezieht, die als Ergebnis einer Kundenaktion erstellt wurde, und beschreibt die creation/modification Vereinbarungsparameter, den Lebenszyklus der Anfrage und das voraussichtliche Ergebnis nach Annahme der Anfrage.
Fakturierbare Dimension Elemente, die sich auf die Preisgestaltung des Produkts beziehen. Zum Beispiel Amazon Elastic Compute Cloud (Amazon EC2) -Instances für Amazon Machine Image (AMI) -Produkte oder Premium-Instances im Vergleich zu Benutzern mit Lesezugriff für SaaS-Produkte (Software as a Service).
Vertriebspartner (CP) Organizations, die vom Product Owner (ISV) autorisiert wurden, ihre Produkte in seinem Namen weiterzuverkaufen. AWS Marketplace
Unabhängige Softwareanbieter (ISVs) Verkäufer, die ihre eigenen Produkte in AWS Marketplace anbieten und verwalten.
Absicht Die Absicht steht für die Motivation, die der Käufer bei der Erstellung des Vertrags verfolgt hat. Derzeit werden bei der Vertragserstellung die Absichten „Neu“, „Änderung“ und „Ersetzen“ unterstützt.
Zahlungsanfrage Eine vom Verkäufer (Anbieter) initiierte Zahlungsaufforderung im Zusammenhang mit einer Vereinbarung. Der Käufer (Akzeptor) kann die Zahlungsaufforderung annehmen oder ablehnen.
Vorschlagender Die Partei, die die ursprünglichen Bedingungen einer Vereinbarung verlängert, am häufigsten durch ein Angebot.
Bestellungen Organizations verlangen von Käufern, dass sie Bestellungen verwenden, um bei zugelassenen Lieferanten einzukaufen, nachzuverfolgen, was sie kaufen, und sicherzustellen, dass die Ausgaben prognostiziert, budgetiert, genehmigt und den zuständigen Kostenstellen zugewiesen werden.
Ressource Eine Einheit oder Ressource, in der Verkäufer verkaufen möchten. AWS Marketplace Dies wird häufig als Basisprodukt bezeichnet. Ein Basisprodukt ist für Käufer erst dann vollständig, wenn Produktinformationen, Einsatzattribute und Rechnungsinformationen hinzugefügt wurden. Ein Produkt beschreibt die Produktinformationen, die Merkmale der Softwarebereitstellung und den Abrechnungsmechanismus des Angebots, das ein Verkäufer verkaufen möchte. Das Produkt muss mit einem Angebot kombiniert werden, um zu einer Transaktionseinheit zu werden, die verkauft und von Käufern verwendet werden kann. AWS Marketplace
Begriff Eine Einheit innerhalb einer Vereinbarung, die regelt, wie eine Vereinbarung durchgesetzt wird (z. B. die Preisgestaltung).

Endpoint

Sie können über die folgenden Endpunkte auf den AWS Marketplace Agreement Service zugreifen:

Endpoint Region Unterstützte IP-Protokolle
agreement-marketplace.us-east-1.api.aws USA Ost (Nord-Virginia) IPv4, IPv6

Berechtigungen

Die Agreements API verwendet die AWS Standardauthentifizierung mit Signature Version 4 (Sigv4). Sie benötigen gültige AWS Anmeldeinformationen und die entsprechenden IAM-Berechtigungen, um die API aufrufen zu können. Details hierzu finden Sie unter Zugriffskontrolle für die AWS Marketplace Vereinbarungs-API.

Fehlercodes

Die folgenden Fehlercodes gelten für AWS Marketplace Agreement Service-Aktionen. Ein einziger Fehlercode kann für mehrere Anwendungsfälle zurückgegeben werden. Anhand der folgenden Beschreibungen können Sie das spezifische Szenario identifizieren, in dem die einzelnen Fehlercodes auftreten. Diese Liste erhebt keinen Anspruch auf Vollständigkeit und kann aktualisiert werden, sobald neue Funktionen veröffentlicht werden.

ValidationException

Fehlercode Description
INVALID_SOURCE_AGREEMENT_IDENTIFIER Wird zurückgegeben, wenn die Kennung der Quellvereinbarung nicht dem erwarteten Format entspricht oder wenn eine Kennung der Quellvereinbarung für eine Absicht angegeben wurde, für die keine Kennung erforderlich ist (z. B. NEU).
MISSING_SOURCE_AGREEMENT_IDENTIFIER Wird zurückgegeben, wenn die Kennung der Quellvereinbarung nicht für eine Absicht angegeben wird, für die eine solche erforderlich ist (wie REPLACE oder AMEND).
INVALID_REQUESTED_TERM_CONFIGURATION

Wird zurückgegeben, wenn die angeforderte Begriffskonfiguration nicht gültig ist. Mögliche Szenarien:

  • Es wird eine Konfiguration für einen Begriff bereitgestellt, für den kein Begriff zulässig ist.

  • Eine erforderliche Konfiguration fehlt.

  • Der Selektorwert gehört nicht zum Vereinbarungsvorschlag.

  • Die Dimensionen können nur eine Dimension enthalten, wenn die Auswahl mehrerer Dimensionen nicht zulässig ist.

  • Ein Dimensionsschlüssel wird im Vereinbarungsvorschlag oder in den akzeptierten Bedingungen nicht berücksichtigt.

  • Ein Dimensionswert kann nur 1 sein, wenn die Mengenkonfiguration für die Dimension nicht aktiviert ist.

  • Die Konfiguration enthält doppelte Dimensionsschlüssel.

  • Die Konfiguration unterscheidet sich nicht von der Quellvereinbarung.
INVALID_AGREEMENT_PROPOSAL_IDENTIFIER Wird zurückgegeben, wenn die ID des Vereinbarungsvorschlags nicht dem erwarteten Format entspricht oder wenn eine Kennung für einen Vorschlag angegeben wurde, für den keine Vereinbarung erforderlich ist (z. B. AMEND).
MISSING_AGREEMENT_PROPOSAL_IDENTIFIER Wird zurückgegeben, wenn die ID des Vereinbarungsvorschlags nicht für eine Absicht angegeben wird, für die eine solche erforderlich ist (wie NEW oder REPLACE).
INVALID_FILTER_NAME Wird zurückgegeben, wenn der angegebene Filtername kein anerkannter Filter ist oder wenn doppelte Filternamen in der Anforderung enthalten sind.
INVALID_FILTER_VALUES Wird zurückgegeben, wenn Filterwerte ungültig, dupliziert oder leer sind, die maximal zulässige Anzahl überschreiten oder wenn ein Datumsbereichsfilter einen BeforeEndTime Wert angibt, der AfterEndTime dem Wert vorausgeht.
INVALID_NEXT_TOKEN Wird zurückgegeben, wenn das Paginierungstoken falsch formatiert ist, abgelaufen ist, nicht entschlüsselt werden kann oder wenn sich die Anforderungsparameter zwischen paginierten Aufrufen geändert haben.
DUPLICATE_CHARGES Wird zurückgegeben, wenn die Anfrage doppelte Gebührenkennungen enthält oder wenn unterschiedliche Bestellwerte für dieselbe Gebührenkennung angegeben wurden.
UNSUPPORTED_FILTERS Wird zurückgegeben, wenn die angegebene Filterkombination nicht unterstützt wird. Die unterstützten Filterkombinationen variieren je nach Partytyp. Die unterstützten Kombinationen finden Sie in der öffentlichen Dokumentation.
INVALID_PURCHASE_ORDER_REFERENCE Wird zurückgegeben, wenn die Bestellreferenz nicht den Formatanforderungen entspricht oder wenn eine erforderliche Bestellung nicht so bereitgestellt wurde, wie sie vom Kontoadministrator konfiguriert wurde.
INVALID_CHARGE_AMOUNT

Wird zurückgegeben, wenn der Abbuchungsbetrag nicht gültig ist. Mögliche Szenarien:

  • Der Gebührenbetrag übersteigt den maximalen Gesamtgebührenbetrag für die Laufzeit.

  • Das Format des Gebührenbetrags entspricht nicht den Währungsanforderungen (z. B. zu viele Dezimalstellen).

  • Es ist kein Restbetrag verfügbar, da die Vereinbarung den maximalen Gesamtbetrag der Gebühren erreicht hat.
UNSUPPORTED_ACTION

Wird zurückgegeben, wenn der angeforderte Vorgang für den aktuellen Status der Ressource nicht unterstützt wird. Die spezifischen Szenarien variieren je nach API:

  • UpdatePurchaseOrders— Das Abbuchungsdatum liegt in der Vergangenheit und die auto Verlängerung ist deaktiviert, das Abbuchungsdatum liegt innerhalb von 3 Stunden, die Gebühr ist eine Rückerstattungsgebühr, die Änderung ist nicht die letzte, die Bestellungen gehören nicht alle zu derselben Vereinbarung oder die Vereinbarung ist nicht aktiv.

  • CreateAgreementRequest— Die Änderung einer zukünftigen Vereinbarung wird nicht unterstützt, die Kombination aus Ressourcentyp und Laufzeitart unterstützt die angeforderte Absicht nicht, das Ersetzen einer aktiven Vereinbarung durch eine zukünftige Vereinbarung ist nicht zulässig, die Vertragsdauer kann während der Änderung nicht geändert werden, die Vereinbarung kann zu diesem Zeitpunkt nicht aktualisiert werden (z. B. bestehen ausstehende Ansprüche), der Vereinbarungsvorschlag muss sich auf dieselbe Ressource beziehen wie die Quellvereinbarung, der Vereinbarungsvorschlag muss sich von der Quellvereinbarung unterscheiden, oder die Vereinbarungsart unterstützt nicht diese Aktion.

  • AcceptAgreementRequest— Die Kombination aus Ressourcentyp und Begriffstyp unterstützt diese Aktion nicht, die Vereinbarungsart unterstützt diese Aktion nicht, für dieselbe Ressource ist bereits eine aktive Vereinbarung vorhanden, oder die Vereinbarung kann derzeit nicht aktualisiert werden.

  • CancelAgreement— Die Vereinbarung hat ausstehende Ansprüche, der Vertragstyp unterstützt keine Kündigung, eine Vereinbarung, die nicht gekündigt werden UsageBasedPricingTerm kann, solange eine Vereinbarung mit derselben Ressource PaymentScheduleTerm besteht ConfigurableUpfrontPricingTerm oder noch aktiv ist, oder die Kombination aus Ressourcentyp und Laufzeittyp unterstützt die Kündigung nicht.

  • GetBillingAdjustmentRequest— Es handelt sich um eine Vereinbarung, bei der es sich nicht um einen Kaufvertrag handelt, oder der Anrufer ist der Akzeptor der Vereinbarung.

  • SendAgreementCancellationRequest— Der Vertragstyp unterstützt diese Aktion nicht.

  • AcceptAgreementCancellationRequest— Die Art der Vereinbarung unterstützt diese Aktion nicht.

  • RejectAgreementCancellationRequest— Die Art der Vereinbarung unterstützt diese Aktion nicht.

  • CancelAgreementCancellationRequest— Die Art der Vereinbarung unterstützt diese Aktion nicht.

  • GetAgreementCancellationRequest— Bei dem Vertrag handelt es sich nicht um einen Kaufvertrag.

ResourceNotFoundException

Die ResourceNotFoundException Inhalte resourceType und resourceId Felder, die die Ressource identifizieren, die nicht gefunden werden konnte. In der folgenden Tabelle werden die Szenarien beschrieben, die diese Ausnahme für jeden Ressourcentyp verursachen können.

Anmerkung

Aus Sicherheitsgründen wird derselbe Fehler zurückgegeben, unabhängig davon, ob eine Ressource nicht existiert oder der Aufrufer keinen Zugriff darauf hat. Dadurch wird die Aufzählung gültiger Ressourcenbezeichner verhindert.

Ressourcentyp Mögliche Szenarien
AgreementProposal

  • Für den angegebenen Bezeichner wurde kein Einigungsvorschlag gefunden.

  • Das Angebot richtet sich nicht an den Antragsteller.

  • Das Angebot ist im Land des Akzeptors nicht verfügbar.
Agreement

  • Für die angegebene Kennung wurde keine Vereinbarung gefunden.

  • Der Anrufer ist weder der Akzeptor noch der Vorschlagende der Vereinbarung.
AgreementRequest

  • Für die angegebene Kennung wurde keine Vereinbarungsanfrage gefunden.

  • Die Vereinbarungsanfrage gehört einem anderen Anrufer.

  • Die Vereinbarungsanfrage ist abgelaufen.

  • Die Vertragsanfrage wurde durch eine nachfolgende angenommene Anfrage für dasselbe Produkt oder Angebot ersetzt.

  • Der Vertragsvorschlag wurde zwischen CreateAgreementRequest den AcceptAgreementRequest Ausschreibungen inaktiv, da das Angebot erneut veröffentlicht wurde oder das Angebot auslief.
Charge

  • Für die angegebene Kennung wurde keine Gebühr gefunden.

  • Die Gebühr ist nicht Teil der angegebenen Vereinbarung.
BillingAdjustmentRequest

  • Für die angegebene ID wurde keine Anfrage zur Abrechnungsanpassung gefunden.

  • Der Anrufer ist weder der Antragsteller noch der Antragsteller der Vereinbarung, die mit der Anpassung verbunden ist.
AgreementCancellationRequest

  • Für die angegebene Kennung wurde keine Anfrage zur Kündigung des Vertrags gefunden.

  • Der Anrufer ist weder der Antragsteller noch der Antragsteller der Vereinbarung, die mit der Stornierungsanfrage verknüpft ist.
PaymentRequest

  • Für die angegebene Kennung wurde keine Zahlungsanforderung gefunden.

  • Der Anrufer ist weder der Akzeptor noch der Antragsteller der Vereinbarung, die mit der Zahlungsanfrage verbunden ist.