Udostępnij za pośrednictwem

Zasoby produktów

  • Artykuł

Zasoby reprezentujące towary lub usługi do wykupu. Zawiera zasoby do opisywania typu i kształtu produktu (SKU) oraz sprawdzania dostępności produktu w spisie.

Rezultat

Reprezentuje możliwe do przeczyszczania dobre lub usługi. Produkt sam w sobie nie jest elementem do przeczyszczania.

Właściwość Type Opis
identyfikator String Identyfikator produktu.
title String Tytuł produktu.
opis String Opis produktu.
productType Typ elementu Obiekt opisujący kategoryzacja typów tego produktu.
isMicrosoftProduct Bool Wskazuje, czy produkt jest produktem firmy Microsoft.
publisherName String Nazwa wydawcy produktu, jeśli jest dostępna.
połączenia ProductLinks Linki do zasobów zawarte w produkcie.

ItemType

Reprezentuje typ produktu.

Właściwość Type Opis
identyfikator String Identyfikator typu.
displayName String Nazwa wyświetlana typu elementu.
subType Typ elementu Opcjonalny. Obiekt, który opisuje podtyp kategoryzacji dla typu elementu.

Zawiera listę linków dla produktu.

Właściwość Type Opis
sku Link Link umożliwiający uzyskanie dostępu do bazowych jednostek SKU.
połączenia ResourceLinks Łącza zasobów zawarte w zasobie.

SKU

Reprezentuje dostępny do przeczyszczania jednostkę magazynową (SKU) w ramach produktu.

Właściwość Type Opis
identyfikator String Identyfikator jednostki SKU. Identyfikator jest unikatowy tylko w kontekście jego produktu nadrzędnego.
title String Tytuł jednostki SKU.
opis String Opis jednostki SKU.
productId String Identyfikator produktu nadrzędnego, który zawiera jednostkę SKU.
minimumQuantity Int Minimalna dozwolona ilość do zakupu.
maximumQuantity Int Maksymalna dozwolona ilość do zakupu.
isTrial Bool Wskazuje, czy jednostka SKU jest elementem wersji próbnej.
supportedBillingCycles Tablica ciągów Lista obsługiwanych cykli rozliczeniowych dla jednostki SKU. Obsługiwane wartości to nazwy elementów członkowskich znajdujące się w obszarze BillingCycleType.
purchasePrerequisites Tablica ciągów Lista kroków wymagań wstępnych lub akcji, które są wymagane przed zakupem elementu. Obsługiwane wartości to:
"InventoryCheck" — wskazuje, że spis elementu powinien zostać oceniony przed podjęciem próby zakupu elementu.
"AzureSubscriptionRegistration" — wskazuje, że wymagana jest subskrypcja platformy Azure i musi zostać zarejestrowana przed podjęciem próby zakupu elementu.
inventoryVariables Tablica ciągów Lista zmiennych potrzebnych do wykonania sprawdzania spisu w elemencie. Obsługiwane wartości to:
"CustomerId" — identyfikator klienta, dla którego zostanie zakupiony.
"AzureSubscriptionId" — identyfikator subskrypcji platformy Azure, która będzie używana do zakupu rezerwacji platformy Azure.
"ArmRegionName" — region, dla którego należy zweryfikować spis. Ta wartość musi być zgodna z wartością "ArmRegionName" z atrybutów DynamicAttributes jednostki SKU.
provisioningVariables Tablica ciągów Lista zmiennych, które należy podać w kontekście aprowizacji elementu wiersza koszyka podczas zakupu elementu. Obsługiwane wartości to:
Zakres — zakres zakupu rezerwacji platformy Azure: "Pojedynczy", "Udostępniony".
"SubscriptionId" — identyfikator subskrypcji platformy Azure, która będzie używana do zakupu rezerwacji platformy Azure.
"Czas trwania" — czas trwania rezerwacji platformy Azure: "1Rr", "3Rr".
dynamicAttributes pary klucz/wartość Słownik właściwości dynamicznych, które mają zastosowanie do elementu. Właściwości w słowniku są dynamiczne i mogą ulec zmianie bez powiadomienia. Partnerzy powinni unikać tworzenia silnych zależności od określonych kluczy istniejących w wartości właściwości.
połączenia ResourceLinks Łącza zasobów zawarte w jednostce SKU.
ZaświadczenieWłaściwości ZaświadczenieWłaściwości Właściwości zaświadczania dla jednostki SKU.
consumptionType String Jest dostępny tylko wtedy, gdy jednostka SKU obsługuje użycie, takie jak nadwyżka.
specializedOfferProperties Lista wyspecjalizowanychOfferProperties Jest dostępny tylko wtedy, gdy produkt jest podtypem SpecializedOffer.
minimumPurchaseCommitment MinimumPurchaseCommitment Stała kwota zatwierdzona w usługach obliczeniowych.

Atrybuty jednostki SKU dynamicznej

Istotne właściwości dotyczące nowych produktów i usług opartych na licencjach handlowych.

Uwaga

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich Dostawca rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych środowisk handlowych.

Właściwość Type Opis
hasConstraints Wartość logiczna Opisuje, czy jednostka SKU zawiera element assetContraints
isAddon Wartość logiczna Opisuje, czy jednostka SKU jest dodatkiem
prerequisiteSkus tablica ciągów Opisuje produkty i jednostki SKU, z których dodatek może pracować
upgradeTargetOffers tablica ciągów Lista produktów i jednostek SKU, do których można uaktualnić element
conversionInstructions Lista konwersjiInstrukcje Lista instrukcji dotyczących konwertowania operacji

specializedOfferProperties

Uwaga

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich Dostawca rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych środowisk handlowych.

Dotyczy tylko podtypów produktów "SpecializedOffers"

Właściwość Type Opis
startDate String Identyfikatory terminów, do których mają zastosowanie instrukcje
endDate String Opcje definiujące odnowienia
pricingPolicies Lista cenZasady Lista zasad definiujących typy rabatów i wartości promocji.

MinimumPurchaseCommitment

Atrybuty minimalnej ilości, która może zostać zatwierdzona w usługach obliczeniowych.

Właściwość Type Opis
zboże String Okres minimalnego zobowiązania zakupu.
currencyCode Ciąg słownika<, ciąg> "waluta" i "symbol" minimalnej kwoty, którą można zadeklarować.
kwota Int Minimalna kwota, która może zostać zatwierdzona w usługach obliczeniowych.

CennikZasady

Opisz typy rabatów i wartości promocji.

Właściwość Type Opis
type String Opisz, czy rabat jest oparty na procentach, czy rabatach na stawkę płaską.
wartość String Definiuje ilość zastosowanego rabatu.

Dostępność

Reprezentuje konfigurację, w której jednostka SKU jest dostępna do zakupu (na przykład kraj/region, waluta i segment branżowy).

Właściwość Type Opis
identyfikator String Identyfikator tej dostępności. Ten identyfikator jest unikatowy tylko w kontekście produktu nadrzędnego i jednostki SKU. Uwaga Identyfikatory dostępności mogą ulec zmianie w czasie. Partnerzy powinni polegać tylko na tej wartości w krótkim przedziale czasu po jego pobraniu.
productId String Identyfikator produktu , który zawiera tę dostępność.
skuId String Identyfikator jednostki SKU , która zawiera tę dostępność.
catalogItemId String Unikatowy identyfikator tego elementu w wykazie. Ten identyfikator należy wypełnić we właściwościach OrderLineItem.OfferId lub CartLineItem.CatalogItemId podczas zakupu nadrzędnej jednostki SKU. Uwaga Ten identyfikator może ulec zmianie w czasie. Po pobraniu tej wartości należy polegać tylko w krótkim czasie. Powinien on być dostępny i używany tylko w momencie zakupu.
defaultCurrency String Domyślna waluta obsługiwana dla tej dostępności.
segment String Segment branżowy dla tej dostępności. Obsługiwane wartości to: Commercial, Education, Government, NonProfit.
kraj String Kraj lub region (w formacie kodu kraju ISO), w którym ta dostępność ma zastosowanie.
isPurchasable Bool Wskazuje, czy ta dostępność jest dostępna do przeczyszczania.
isRenewable Bool Wskazuje, czy ta dostępność jest odnawialna.
RenewalInstructions RenewalInstruction Reprezentuje instrukcje dotyczące odnawiania dla danej dostępności.
product Produkt Produkt, który odpowiada tej dostępności.
sku Jednostka SKU Jednostka SKU, z tą dostępnością odpowiada.
Warunki Tablica zasobów terminów Kolekcja terminów, które mają zastosowanie do tej dostępności.
połączenia ResourceLinks Linki do zasobów zawarte w ramach dostępności.

Instrukcja odnawiania

Uwaga

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich Dostawca rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych środowisk handlowych.

Reprezentuje instrukcje dotyczące odnawiania dla danej dostępności.

Właściwość Type Opis
applicableTermIds Tablica ciągów Identyfikatory terminów, do których mają zastosowanie instrukcje
OdnawianieOpcje Tablica odnawianiaOption Opcje definiujące odnowienia

OdnawianieOpcje

Uwaga

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich Dostawca rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych środowisk handlowych.

Reprezentuje instrukcje dotyczące odnawiania dla danej dostępności.

Właściwość Type Opis
renewToId String Reprezentuje produkt i jednostkę SKU do odnowienia
isAutoRenewable Bool Określa, czy dostępność może być odnawiana automatycznie

Termin

Reprezentuje termin, dla którego można kupić dostępność.

Właściwość Type Opis
czas trwania String Reprezentacja iso 8601 czasu trwania terminu. Bieżące obsługiwane wartości to P1M (jeden miesiąc), P1Y (jeden rok) i P3Y (trzy lata).
opis String Opis terminu.

InventoryCheckRequest

Reprezentuje żądanie sprawdzenia spisu względem niektórych elementów wykazu.

Właściwość Type Opis
targetItems Tablica elementów InventoryItem Lista elementów wykazu, które zostaną ocenione przez sprawdzanie spisu.
inventoryContext Pary klucz/wartość Słownik wartości kontekstowych potrzebnych do przeprowadzenia kontroli spisu. Każda jednostka SKU produktów określi, które wartości (jeśli istnieją) będą potrzebne do przeprowadzenia tej operacji.
połączenia ResourceLinks Linki do zasobów zawarte w żądaniu sprawdzania spisu.

InventoryItem

Reprezentuje pojedynczy element w operacji sprawdzania spisu. Ten zasób służy do określania elementów docelowych w żądaniu wejściowym, a także służy do reprezentowania wyników wyjściowych operacji sprawdzania spisu.

Właściwość Type Opis
productId String (Wymagane) Identyfikator produktu.
skuId String Identyfikator jednostki SKU. Jeśli używasz tego zasobu jako danych wejściowych do żądania spisu, ta wartość jest opcjonalna. Jeśli ta wartość nie zostanie podana, wszystkie jednostki SKU w ramach produktu będą traktowane jako elementy docelowe operacji sprawdzania zapasów.
isRestricted Bool Wskazuje, czy ten element został znaleziony z ograniczeniami spisu.
Ograniczenia Tablica spisuRestriction Szczegóły wszelkich ograniczeń znalezionych dla tego elementu. Ta właściwość zostanie wypełniona tylko wtedy, gdy isRestricted = "true".

InventoryRestriction

Reprezentuje szczegóły ograniczenia spisu. Te szczegóły dotyczą tylko wyników sprawdzania danych wyjściowych spisu, a nie dla żądań wejściowych.

Właściwość Type Opis
reasonCode String Kod identyfikujący przyczynę ograniczenia.
opis String Opis ograniczenia spisu.
właściwości Pary klucz/wartość Słownik właściwości, które mogą zawierać szczegółowe informacje na temat ograniczenia.

Typ rozliczeń

[Enum/dotnet/api/system.enum) z wartościami wskazującymi typ cyklu rozliczeniowego.

Wartość Position opis
Nieznane 0 Inicjator wyliczenia.
Miesięczny 1 Wskazuje, że partner będzie naliczany co miesiąc.
Roczny 2 Wskazuje, że partner będzie naliczany rocznie.
Brak 3 Wskazuje, że partner nie zostanie obciążony opłatą. Ta wartość może być używana dla elementów wersji próbnej.
Jednorazowe 100 Wskazuje, że partner zostanie obciążony jednorazowo.
Co trzy lata 5 Wskazuje, że partner zostanie obciążony co trzy lata.

ZaświadczenieWłaściwości

Reprezentuje typ zaświadczania i jeśli jest wymagany do zakupu.

Właściwość Type Opis
attestationType String Wskazuje typ zaświadczania. Produkty z systemem Windows 365 będą miały wartość Windows 365. Tekst zaświadczania systemu Windows 365 to "Rozumiem, że każda osoba korzystająca z systemu Windows 365 Business z Korzyść użycia hybrydowego platformy Windows również musi mieć prawidłową kopię systemu Windows 10/11 Pro zainstalowaną na podstawowym urządzeniu służbowym".
enforceAttestation Wartość logiczna Wskazuje, czy zaświadczenie jest wymagane do zakupu.