Ressourcen für Produkte

Ressourcen, die bearbeitbare Waren oder Dienstleistungen darstellen. Enthält Ressourcen zum Beschreiben des Produkttyps und der Form (SKU) und zur Überprüfung der Verfügbarkeit des Produkts in einem Bestand.

Produkt

Stellt einen bearbeitbaren Guten oder Dienst dar. Ein Produkt selbst ist kein bearbeitbarer Artikel.

Eigenschaft	Typ	Beschreibung
id	String	Die ID für ein Produkt.
title	String	Der Produkttitel.
Beschreibung	String	Die Produktbeschreibung.
productType	Elementtyp	Ein Objekt, das die Typkategorisierung(en) dieses Produkts beschreibt.
isMicrosoftProduct	Bool	Gibt an, ob das Produkt ein Microsoft-Produkt ist.
publisherName	String	Der Name des Herausgebers des Produkts, falls verfügbar.
Verknüpfungen	ProductLinks	Die Im Produkt enthaltenen Ressourcenverknüpfungen.

ItemType

Stellt den Typ eines Produkts dar.

Eigenschaft	Typ	Beschreibung
id	String	Der Typbezeichner.
displayName	String	Der Anzeigename für einen Elementtyp.
subType	Elementtyp	Optional. Ein Objekt, das eine Untertypkategorisierung für einen Elementtyp beschreibt.

ProductLinks

Enthält eine Liste von Links für ein Produkt.

Eigenschaft	Typ	Beschreibung
skus	Link	Der Link für den Zugriff auf die zugrunde liegenden SKUs.
Verknüpfungen	ResourceLinks	Die In einer Ressource enthaltenen Ressourcenverknüpfungslinien.

Sku

Stellt eine bearbeitbare Lagerhaltungseinheit (SKU) unter einem Produkt dar.

Eigenschaft	Typ	Beschreibung
id	String	Die ID für die SKU. Die ID ist nur im Kontext des übergeordneten Produkts eindeutig.
title	String	Der Titel der SKU.
Beschreibung	String	Die Beschreibung der SKU.
productId	String	Die ID des übergeordneten Produkts , das eine SKU enthält.
Mindestmenge	Int	Die Mindestmenge, die für den Kauf zulässig ist.
maximale Menge	Int	Die maximal zulässige Menge für den Kauf.
isTrial	Bool	Gibt an, ob eine SKU ein Testelement ist.
supportedBillingCycles	Array aus Zeichenfolgen	Die Liste der unterstützten Abrechnungszeitraum für eine SKU. Die unterstützten Werte sind die in BillingCycleType angegebenen Elementnamen.
purchasePrerequisites	Array aus Zeichenfolgen	Die Liste der erforderlichen Schritte oder Aktionen, die vor dem Kauf eines Artikels erforderlich sind. Die unterstützten Werte sind: "InventoryCheck" – Gibt an, dass das Inventar des Artikels ausgewertet werden soll, bevor versucht wird, einen Artikel zu kaufen. "AzureSubscriptionRegistration" – Gibt an, dass ein Azure-Abonnement erforderlich ist und vor dem Kauf eines Artikels registriert werden muss.
inventoryVariables	Array aus Zeichenfolgen	Die Liste der Variablen, die zum Ausführen einer Bestandsüberprüfung für ein Element erforderlich sind. Die unterstützten Werte sind: "CustomerId" – Die ID des Kunden, für den der Kauf vorgesehen wäre. "AzureSubscriptionId" – Die ID des Azure-Abonnements, das für einen Azure-Reservierungskauf verwendet würde. "ArmRegionName" – Die Region, für die der Bestand überprüft werden soll. Dieser Wert muss mit dem "ArmRegionName" aus den DynamicAttributes der SKU übereinstimmen.
provisioningVariables	Array aus Zeichenfolgen	Die Liste der Variablen, die beim Kauf eines Artikels im Bereitstellungskontext eines Einkaufswagenartikels bereitgestellt werden müssen. Die unterstützten Werte sind: Bereich – Der Bereich für einen Azure-Reservierungskauf: "Single", "Shared". "SubscriptionId" – Die ID des Azure-Abonnements, das für einen Azure-Reservierungskauf verwendet würde. "Duration" – Die Dauer der Azure-Reservierung: "1Year", "3Year".
dynamicAttributes	Schlüssel/Wert-Paare	Das Wörterbuch der dynamischen Eigenschaften, die für ein Element gelten. Die Eigenschaften in einem Wörterbuch sind dynamisch und können ohne Vorheriges geändert werden. Partner sollten keine starken Abhängigkeiten von bestimmten Schlüsseln erstellen, die im Wert einer Eigenschaft vorhanden sind.
Verknüpfungen	ResourceLinks	Die In der SKU enthaltenen Ressourcenverknüpfungslinien.
AttestationProperties	AttestationProperties	Die Nachweiseigenschaften für eine SKU.
consumptionType	String	Ist nur verfügbar, wenn die SKU den Verbrauch wie z . B. Überlastung unterstützt.
specializedOfferProperties	Liste der spezialisiertenOfferProperties	Ist nur verfügbar, wenn das Produkt untertyp "SpecializedOffer" ist.
minimumPurchaseCommitment	MinimumPurchaseCommitment	Der feste Betrag, der für Computedienste zugesichert wurde.

Dynamische SKU-Attribute

Wichtige Eigenschaften, die für neue handelslizenzbasierte Produkte und Dienste relevant sind.

Hinweis

Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.

Eigenschaft	Typ	Beschreibung
hasConstraints	Boolean	Beschreibt, ob die SKU assetContraints enthält.
isAddon	Boolean	Beschreibt, ob es sich bei der SKU um ein Add-On handelt.
prerequisiteSkus	Zeichenfolgen-Arrays	Beschreibt Produkte und Skus, mit denen das Add-On arbeiten kann
upgradeTargetOffers	Zeichenfolgen-Arrays	Eine Liste der Produkte und Skus, auf die das Element aktualisiert werden kann
conversionInstructions	Liste der conversionInstructions	Liste der Für Konvertierungsvorgänge zutreffenden Anweisungen

specializedOfferProperties

Hinweis

Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.

Gilt nur für Produktuntertypen "SpecializedOffers"

Eigenschaft	Typ	BESCHREIBUNG
startDate	String	Ausdrucks-IDs, für die die Anweisungen gelten
endDate	String	Optionen zum Definieren von Verlängerungen
pricingPolicies	Liste der preisePolicies	Eine Liste der Richtlinien, die die Rabatttypen und -werte für Werbeaktionen definieren.

MinimumPurchaseCommitment

Attribute des Mindestbetrags, der für Computedienste zugesichert werden kann.

Eigenschaft	Typ	Beschreibung
Korn	String	Der Zeitraum der Mindestkaufverpflichtung.
currencyCode	Wörterbuchzeichenfolge<, Zeichenfolge>	Die "Währung" und das "Symbol" des Mindestbetrags, der zugesichert werden kann.
amount	Int	Der Mindestbetrag, der für Computedienste zugesichert werden kann.

PricingPolicies

Beschreiben Sie die Rabatttypen und -werte der Werbeaktion.

Eigenschaft	Typ	Beschreibung
type	String	Beschreiben Sie, ob der Rabatt auf Prozentsätze oder Pauschalrabatte basiert.
value	String	Definiert den Betrag des angewendeten Rabatts.

Verfügbarkeit

Stellt eine Konfiguration dar, in der eine SKU zum Kauf verfügbar ist (z. B. Land/Region, Währung und Industriesegment).

Eigenschaft	Typ	Beschreibung
id	String	Die ID für diese Verfügbarkeit. Diese ID ist nur innerhalb des Kontexts des übergeordneten Produkts und der SKU eindeutig. Hinweis: Verfügbarkeits-IDs können sich im Laufe der Zeit ändern. Partner sollten sich nur innerhalb kurzer Zeit auf diesen Wert verlassen, nachdem er abgerufen wurde.
productId	String	Die ID des Produkts , das diese Verfügbarkeit enthält.
skuId	String	Die ID der SKU, die diese Verfügbarkeit enthält.
catalogItemId	String	Der eindeutige Bezeichner für dieses Element im Katalog. Diese ID muss beim Kauf der übergeordneten SKU in die Eigenschaften OrderLineItem.OfferId oder CartLineItem.CatalogItemId aufgefüllt werden. Hinweis : Diese ID kann sich im Laufe der Zeit ändern. Sie sollten sich nur innerhalb kurzer Zeit nach dem Abrufen auf diesen Wert verlassen. Es sollte nur zum Zeitpunkt des Kaufs aufgerufen und verwendet werden.
defaultCurrency	String	Die für diese Verfügbarkeit unterstützte Standardwährung.
segment	String	Das Branchensegment für diese Verfügbarkeit. Unterstützte Werte sind: Commercial, Education, Government, NonProfit.
country	String	Das Land oder die Region (im ISO-Ländercodeformat), in dem diese Verfügbarkeit gilt.
isPurchasable	Bool	Gibt an, ob diese Verfügbarkeit bearbeitbar ist.
isRenewable	Bool	Gibt an, ob diese Verfügbarkeit verwendbar ist.
RenewalInstructions	RenewalInstruction	Stellt Verlängerungsanweisungen für eine bestimmte Verfügbarkeit dar.
product	Produkt	Das Produkt, dem diese Verfügbarkeit entspricht.
sku	sku	Die SKU, der diese Verfügbarkeit entspricht.
terms	Array von Ausdrucksressourcen	Die Sammlung von Bedingungen, die für diese Verfügbarkeit gelten.
Verknüpfungen	ResourceLinks	Die Ressourcenverknüpfungen, die in der Verfügbarkeit enthalten sind.

Verlängerungsanweisung

Hinweis

Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.

Stellt Verlängerungsanweisungen für eine bestimmte Verfügbarkeit dar.

Eigenschaft	Typ	Beschreibung
applicableTermIds	Array aus Zeichenfolgen	Ausdrucks-IDs, für die die Anweisungen gelten
RenewalOptions	Array von RenewalOption	Optionen zum Definieren von Verlängerungen

RenewalOption

Hinweis

Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.

Stellt Verlängerungsanweisungen für eine bestimmte Verfügbarkeit dar.

Eigenschaft	Typ	Beschreibung
renewToId	String	Stellt das Produkt und die SKU dar, auf das verlängert werden soll
isAutoRenewable	Bool	Gibt an, ob die Verfügbarkeit automatisch verlängert werden kann.

Begriff

Stellt einen Begriff dar, für den die Verfügbarkeit erworben werden kann.

Eigenschaft	Typ	Beschreibung
duration	String	Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (ein Monat), P1Y (ein Jahr) und P3Y (drei Jahre).
Beschreibung	String	Die Beschreibung des Begriffs.

InventoryCheckRequest

Stellt eine Anforderung zum Überprüfen des Inventars für bestimmte Katalogelemente dar.

Eigenschaft	Typ	Beschreibung
targetItems	Array von InventoryItem	Die Liste der Katalogelemente, die von der Bestandsüberprüfung ausgewertet werden.
inventoryContext	Schlüssel-Werte-Paare	Das Wörterbuch der Kontextwerte, die für die Durchführung der Bestandsüberprüfungen erforderlich sind. Jede SKU der Produkte definiert, welche Werte (falls vorhanden) erforderlich sind, um diesen Vorgang auszuführen.
Verknüpfungen	ResourceLinks	Die Ressourcenverknüpfung, die in der Bestandsüberprüfungsanforderung enthalten ist.

InventoryItem

Stellt ein einzelnes Element in einem Bestandsüberprüfungsvorgang dar. Diese Ressource wird verwendet, um die Zielelemente in einer Eingabeanforderung anzugeben und wird auch verwendet, um die Ausgabeergebnisse des Bestandsüberprüfungsvorgangs darzustellen.

Eigenschaft	Typ	Beschreibung
productId	String	(Erforderlich) Die ID des Produkts.
skuId	String	Die ID der SKU. Wenn Sie diese Ressource als Eingabe für eine Bestandsanforderung verwenden, ist dieser Wert optional. Wenn dieser Wert nicht angegeben wird, werden alle SKUs unter dem Produkt als Zielelemente des Bestandsüberprüfungsvorgangs betrachtet.
Isrestricted	Bool	Gibt an, ob dieses Element über einen eingeschränkten Bestand verfügt.
Einschränkungen	Array von InventoryRestriction	Die Details aller Einschränkungen, die für dieses Element gefunden werden. Diese Eigenschaft wird nur ausgefüllt, wenn isRestricted = "true" ist.

InventoryRestriction

Stellt die Details einer Bestandseinschränkung dar. Diese Details gelten nur für Die Ausgabeergebnisse der Bestandsüberprüfung, nicht für Eingabeanforderungen.

Eigenschaft	Typ	Beschreibung
reasonCode	String	Der Code, der den Grund für die Einschränkung identifiziert.
Beschreibung	String	Die Beschreibung der Bestandsbeschränkung.
properties	Schlüssel-Werte-Paare	Das Wörterbuch der Eigenschaften, das weitere Details zur Einschränkung bereitstellen kann.

BillingCycleType

Eine [Enum/dotnet/api/system.enum) mit Werten, die einen Typ von Abrechnungszeitraum angeben.

Wert	Position	Beschreibung
Unbekannt	0	Enumerationsinitialisierer.
Monatlich	1	Gibt an, dass der Partner monatlich belastet wird.
Jährlich	2	Gibt an, dass der Partner jährlich belastet wird.
Keine	3	Gibt an, dass der Partner nicht belastet wird. Dieser Wert kann für Testelemente verwendet werden.
OneTime	4	Gibt an, dass der Partner einmal in Rechnung gestellt wird.
Triennale	5	Gibt an, dass der Partner alle drei Jahre in Rechnung gestellt wird.

AttestationProperties

Stellt einen Nachweistyp dar und wenn er zum Kauf erforderlich ist.

Eigenschaft	Typ	Beschreibung
attestationType	String	Gibt den Nachweistyp an. Windows 365-Produkte haben den Wert von Windows 365. Der Nachweistext von Windows 365 lautet "Ich verstehe, dass jede Person, die Windows 365 Business mit Windows-Hybridvorteil verwendet, auch eine gültige Kopie von Windows 10/11 Pro auf ihrem primären Arbeitsgerät installiert haben muss."
enforceAttestation	Boolean	Gibt an, ob der Nachweis für den Kauf erforderlich ist.