Produktresurser
Resurser som representerar köpbara varor eller tjänster. Innehåller resurser för att beskriva produkttyp och form (SKU) och för att kontrollera produktens tillgänglighet i en inventering.
Produkt
Representerar en köpbar vara eller tjänst. En produkt i sig är inte en köpbar artikel.
Property | Type | Beskrivning |
---|---|---|
id | String | ID:t för en produkt. |
rubrik | String | Produkttiteln. |
description | String | Produktbeskrivningen. |
productType | ItemType | Ett objekt som beskriver typkategorisering(er) för den här produkten. |
isMicrosoftProduct | Bool | Anger om produkten är en Microsoft-produkt. |
publisherName | String | Namnet på produktens utgivare om det är tillgängligt. |
länkar | ProductLinks | Resurslänkarna som finns i produkten. |
ItemType
Representerar typen av produkt.
Property | Type | Beskrivning |
---|---|---|
id | String | Typidentifieraren. |
displayName | String | Visningsnamnet för en objekttyp. |
subType | ItemType | Valfritt. Ett objekt som beskriver en kategorisering av undertyper för en objekttyp. |
ProductLinks
Innehåller en lista med länkar för en produkt.
Property | Type | Beskrivning |
---|---|---|
sku:er | Länk | Länken för att komma åt underliggande SKU:er. |
länkar | ResourceLinks | Resurslänkarna som finns i en resurs. |
Sku
Representerar en köpbar lagerhållningsenhet (SKU) under en produkt.
Property | Type | Beskrivning |
---|---|---|
id | String | ID:t för SKU:n. ID:t är endast unikt inom ramen för den överordnade produkten. |
rubrik | String | SKU:ns rubrik. |
description | String | Beskrivningen av SKU:n. |
productId | String | ID:t för den överordnade produkten som innehåller en SKU. |
minimumQuantity | Int | Den minsta kvantitet som tillåts för inköp. |
maximumQuantity | Int | Den maximala kvantitet som tillåts för inköp. |
isTrial | Bool | Anger om en SKU är ett utvärderingsobjekt. |
supportedBillingCycles | Strängmatris | Listan över faktureringscykler som stöds för en SKU. Värden som stöds är medlemsnamnen som finns i BillingCycleType. |
purchasePrerequisites | Strängmatris | Listan över nödvändiga steg eller åtgärder som behövs innan du köper ett objekt. De värden som stöds är: "InventoryCheck" – anger att objektets lager ska utvärderas innan du försöker köpa en artikel. "AzureSubscriptionRegistration" – Anger att en Azure-prenumeration behövs och måste registreras innan du försöker köpa en artikel. |
inventoryVariables | Strängmatris | Listan över variabler som behövs för att köra en inventeringskontroll på ett objekt. De värden som stöds är: "CustomerId" – ID för kunden som köpet skulle vara för. "AzureSubscriptionId" – ID:t för den Azure-prenumeration som skulle användas för ett Azure-reservationsköp. "ArmRegionName" – den region som inventeringen ska verifieras för. Det här värdet måste matcha "ArmRegionName" från SKU:n DynamicAttributes. |
provisioningVariables | Strängmatris | Listan över variabler som måste anges i etableringskontexten för ett kundvagnsobjekt när du köper ett objekt. De värden som stöds är: Omfång – omfånget för ett Azure-reservationsköp: "Single", "Shared". "SubscriptionId" – ID:t för den Azure-prenumeration som skulle användas för ett Azure-reservationsköp. "Varaktighet" – Varaktigheten för Azure-reservationen: "1Year", "3Year". |
dynamicAttributes | nyckel/värde-par | Ordlistan med dynamiska egenskaper som gäller för ett objekt. Egenskaperna i en ordlista är dynamiska och kan ändras utan föregående meddelande. Partner bör undvika att skapa starka beroenden för vissa nycklar som finns i värdet för en egenskap. |
länkar | ResourceLinks | Resurslänkarna som finns i SKU:n. |
AttesteringEgenskaper | AttesteringEgenskaper | Attesteringsegenskaperna för en SKU. |
consumptionType | String | Är endast tillgängligt om sku:n stöder förbrukning, till exempel överförbrukning. |
specializedOfferProperties | Lista över specialiseradeOfferProperties | Är endast tillgängligt om produkten är underTyp av SpecializedOffer. |
minimumPurchaseCommitment | MinimumPurchaseCommitment | Det fasta beloppet som har checkats in för beräkningstjänster. |
Dynamiska SKU-attribut
Viktiga egenskaper som är relevanta för nya handelslicensbaserade produkter och tjänster.
Kommentar
De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Dobavljač rešenja u oblaku (CSP:er). Mer information finns i översikten över nya handelsupplevelser.
Property | Type | Beskrivning |
---|---|---|
hasConstraints | Booleskt | Beskriver om SKU:n innehåller assetContraints |
isAddon | Booleskt | Beskriver om SKU:n är ett tillägg |
prerequisiteSkus | strängmatris | Beskriver produkter och sku:er som tillägget kan arbeta med |
upgradeTargetOffers | strängmatris | En lista över produkter och sku:er som objektet kan uppgradera till |
conversionInstructions | Lista över konverteringInstruktioner | Lista över instruktioner som gäller för konverteringsåtgärder |
specializedOfferProperties
Kommentar
De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Dobavljač rešenja u oblaku (CSP:er). Mer information finns i översikten över nya handelsupplevelser.
Gäller endast för produktundertyper "SpecializedOffers"
Property | Type | Beskrivning |
---|---|---|
startDate | String | Term-ID:t som instruktionerna gäller för |
endDate | String | Alternativ som definierar förnyelser |
pricingPolicies | Lista över priserPrinciper | En lista över principer som definierar kampanjrabatttyper och -värden. |
MinimumPurchaseCommitment
Attribut för det minsta belopp som kan checkas in för beräkningstjänster.
Property | Type | Beskrivning |
---|---|---|
korn | String | Perioden för det minsta inköpsåtagandet. |
currencyCode | Ordlistesträng<, sträng> | "Valuta" och "symbol" för det minsta belopp som kan checkas in. |
belopp | Int | Det minsta belopp som kan checkas in för beräkningstjänster. |
PricingPolicies
Beskriv kampanjrabattens typer och värden.
Property | Type | Beskrivning |
---|---|---|
type | String | Beskriv om rabatten baseras på procentsatser eller schablonrabatter. |
värde | String | Definierar beloppet för den tillämpade rabatten. |
Tillgänglighet
Representerar en konfiguration där en SKU är tillgänglig för köp (till exempel land/region, valuta och branschsegment).
Property | Type | Beskrivning |
---|---|---|
id | String | ID:t för den här tillgängligheten. Det här ID:t är endast unikt inom ramen för dess överordnade produkt och SKU. Observera att tillgänglighets-ID:t kan ändras över tid. Partner bör bara förlita sig på det här värdet inom en kort tid efter att de har hämtat det. |
productId | String | ID för den produkt som innehåller den här tillgängligheten. |
skuId | String | ID:t för den SKU som innehåller den här tillgängligheten. |
catalogItemId | String | Den unika identifieraren för det här objektet i katalogen. Det här ID:t måste fyllas i i egenskaperna OrderLineItem.OfferId eller CartLineItem.CatalogItemId när du köper den överordnade SKU:n. Obs! Det här ID:t kan ändras över tid. Du bör bara förlita dig på det här värdet inom en kort tid efter att du har hämtat det. Den bör endast nås och användas vid tidpunkten för köpet. |
defaultCurrency | String | Standardvalutan som stöds för den här tillgängligheten. |
segment | String | Branschsegmentet för den här tillgängligheten. Värden som stöds är: Commercial, Education, Government, NonProfit. |
land | String | Det land eller den region (i ISO-landskodformat) där den här tillgängligheten gäller. |
isPurchasable | Bool | Anger om den här tillgängligheten kan köpas. |
isRenewable | Bool | Anger om den här tillgängligheten kan förnyas. |
RenewalInstructions | RenewalInstruction | Representerar förnyelseinstruktioner för en viss tillgänglighet. |
produkt | Produkt | Den produkt som den här tillgängligheten motsvarar. |
sku | Sku | Den SKU som den här tillgängligheten motsvarar. |
villkor | Matris med termresurser | Den samling villkor som gäller för den här tillgängligheten. |
länkar | ResourceLinks | Resurslänkarna som finns i tillgängligheten. |
Förnyelseinstruktion
Kommentar
De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Dobavljač rešenja u oblaku (CSP:er). Mer information finns i översikten över nya handelsupplevelser.
Representerar förnyelseinstruktioner för en viss tillgänglighet.
Property | Type | Beskrivning |
---|---|---|
applicableTermIds | Strängmatris | Term-ID:t som instruktionerna gäller för |
RenewalOptions | Matris med RenewalOption | Alternativ som definierar förnyelser |
RenewalOption
Kommentar
De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Dobavljač rešenja u oblaku (CSP:er). Mer information finns i översikten över nya handelsupplevelser.
Representerar förnyelseinstruktioner för en viss tillgänglighet.
Property | Type | Beskrivning |
---|---|---|
renewToId | String | Representerar den produkt och sku som ska förnyas till |
isAutoRenewable | Bool | Om tillgängligheten kan förnyas automatiskt |
Period
Representerar en term som tillgängligheten kan köpas för.
Property | Type | Beskrivning |
---|---|---|
varaktighet | String | En ISO 8601-representation av termens varaktighet. De aktuella värdena som stöds är P1M (en månad), P1Y (ett år) och P3Y (tre år). |
description | String | Beskrivningen av termen. |
InventoryCheckRequest
Representerar en begäran om att kontrollera inventeringen mot vissa katalogobjekt.
Property | Type | Beskrivning |
---|---|---|
targetItems | Matris med InventoryItem | Listan över katalogobjekt som inventeringskontrollen ska utvärdera. |
inventoryContext | Nyckel/värde-par | Ordlistan med kontextvärden som behövs för att utföra inventeringskontrollerna. Varje SKU för produkterna definierar vilka värden (om några) som behövs för att utföra den här åtgärden. |
länkar | ResourceLinks | Resurslänkarna som finns i begäran om inventeringskontroll. |
InventoryItem
Representerar en enskild artikel i en inventeringskontrollåtgärd. Den här resursen används för att ange målobjekten i en indatabegäran och används även för att representera resultatet av inventeringskontrollen.
Property | Type | Beskrivning |
---|---|---|
productId | String | (Krävs) Produktens ID. |
skuId | String | ID:t för SKU:n. När du använder den här resursen som indata till en inventeringsbegäran är det här värdet valfritt. Om det här värdet inte anges betraktas alla SKU:er under produkten som målobjekt för inventeringskontrollen. |
isRestricted | Bool | Anger om objektet visade sig ha en begränsad inventering. |
inskränkningar | Matris med inventoryRestriction | Information om eventuella begränsningar som finns för det här objektet. Den här egenskapen fylls endast i om isRestricted = "true". |
InventoryRestriction
Representerar information om en inventeringsbegränsning. Den här informationen gäller endast för utdataresultat för inventeringskontroller, inte för indatabegäranden.
Property | Type | Beskrivning |
---|---|---|
reasonCode | String | Koden som identifierar orsaken till begränsningen. |
description | String | Beskrivningen av inventeringsbegränsningen. |
egenskaper | Nyckel/värde-par | Ordlistan med egenskaper som kan ge ytterligare information om begränsningen. |
BillingCycleType
En [Uppräkning/dotnet/api/system.enum) med värden som anger en typ av faktureringsperiod.
Värde | Position | beskrivning |
---|---|---|
Okänt | 0 | Uppräkningsinitierare. |
Månadsvis | 1 | Anger att partnern debiteras varje månad. |
Årlig | 2 | Anger att partnern debiteras årligen. |
Ingen | 3 | Anger att partnern inte kommer att debiteras. Det här värdet kan användas för utvärderingsobjekt. |
OneTime | 4 | Anger att partnern debiteras en gång. |
Treenial | 5 | Anger att partnern debiteras vart tredje år. |
AttesteringEgenskaper
Representerar en attesteringstyp och om den krävs för inköp.
Property | Type | Beskrivning |
---|---|---|
attestationType | String | Anger attesteringstypen. Windows 365-produkter har värdet Windows 365. Windows 365-attesteringstexten är "Jag förstår att varje person som använder Windows 365 Business med Windows Hybrid Benefit också måste ha en giltig kopia av Windows 10/11 Pro installerad på sin primära arbetsenhet." |
enforceAttestation | Booleskt | Anger om attestering krävs för inköp. |