Zasoby produktów
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.
Produkt
Reprezentuje możliwy do zakupu towar lub usługę. Produkt sam w sobie nie jest przedmiotem do kupienia.
| Własność | Typ | Opis |
|---|---|---|
| id | Struna | Identyfikator produktu. |
| tytuł | Struna | Tytuł produktu. |
| opis | Struna | Opis produktu. |
| typ produktu | ItemType | Obiekt opisujący typy kategoryzacji tego produktu. |
| isMicrosoftProduct | bool | Wskazuje, czy produkt jest produktem firmy Microsoft. |
| nazwaWydawcy | Struna | Nazwa wydawcy produktu, jeśli jest dostępna. |
| Linki | ProductLinks | Linki do zasobów zawarte w produkcie. |
Typ elementu
Reprezentuje typ produktu.
| Własność | Typ | Opis |
|---|---|---|
| id | Struna | Identyfikator typu. |
| Nazwa wyświetlana | Struna | Nazwa wyświetlana dla typu elementu. |
| podtyp | ItemType | Fakultatywny. Obiekt, który opisuje podtyp kategoryzacji dla typu elementu. |
ProductLinks
Zawiera listę linków do produktu .
| Własność | Typ | Opis |
|---|---|---|
| sku | Link | Link umożliwiający uzyskanie dostępu do podstawowych SKU. |
| Linki | ResourceLinks | Łącza do zasobów znajdujące się w zasobie. |
SKU
Reprezentuje możliwą do zakupu jednostkę magazynową (SKU) w ramach produktu.
| Własność | Typ | Opis |
|---|---|---|
| id | Struna | Identyfikator dla SKU. Identyfikator jest unikatowy tylko w kontekście produktu, do którego należy. |
| tytuł | Struna | Tytuł SKU. |
| opis | Struna | Opis produktu oznaczonego jako SKU. |
| identyfikator produktu | Struna | Identyfikator nadrzędnego produktu zawierającego SKU. |
| minimalna ilość | Int | Minimalna dozwolona ilość do zakupu. |
| maksymalna ilość | Int | Maksymalna dozwolona ilość do zakupu. |
| isTrial | bool | Wskazuje, czy jednostka SKU jest elementem wersji próbnej. |
| obsługiwane cykle rozliczeniowe | Tablica ciągów | Lista obsługiwanych cykli rozliczeniowych dla jednostki SKU. Obsługiwane wartości to nazwy członków znalezione w BillingCycleType. |
| Wymagania wstępne zakupu | Tablica ciągów | Lista kroków lub działań warunków wstępnych, które są potrzebne przed zakupem przedmiotu. 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. |
| zmienne inwentarza | Tablica ciągów | Lista zmiennych potrzebnych do wykonania sprawdzenia inwentaryzacji na przedmiocie. Obsługiwane wartości to: "CustomerId" — identyfikator klienta, dla którego dokonywany jest zakup. "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. |
| zmienneProvisioning | Tablica ciągów | Lista zmiennych, które należy podać w kontekście konfiguracji elementu wiersza koszyka podczas zakupu produktu. Obsługiwane wartości to: Zakres — zakres zakupu rezerwacji na platformie 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 Azure: "1rok", "3lata". |
| 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 mocnych zależności od konkretnych kluczy istniejących w wartości właściwości. |
| Linki | ResourceLinks | Łącza zasobów zawarte w SKU. |
| ZaświadczenieWłaściwości | Właściwości Atestacji | Właściwości atestowe dla SKU. |
| typ konsumpcji | Struna | Jest dostępny tylko wtedy, gdy jednostka magazynowa (SKU) obsługuje konsumpcję, jak na przykład nadwyżka. |
| właściwości specjalnej oferty | Lista wyspecjalizowanych właściwości ofert | Jest dostępny tylko wtedy, gdy produkt jest podtypem oferty specjalistycznej (SpecializedOffer). |
| minimalne zobowiązanie zakupowe | MinimalneZobowiązanieZakupu | Stała kwota przeznaczona na usługi obliczeniowe. |
Atrybuty jednostki SKU dynamicznej
Istotne właściwości dotyczące nowych produktów i usług opartych na licencjach handlowych.
Notatka
Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, przejrzyj omówienie nowych środowisk handlowych.
| Własność | Typ | Opis |
|---|---|---|
| maOgraniczenia | Boolean | Opisuje, czy jednostka SKU zawiera element assetContraints |
| jestDodatkiem | Boolean | Opisuje, czy jednostka SKU jest dodatkiem |
| prerequisiteSkus | tablica ciągów | Opisuje produkty i jednostki SKU, z którymi może współpracować dodatek. |
| Modernizacja Ofert Docelowych | tablica ciągów | Lista produktów i jednostek SKU, na które można uaktualnić element |
| instrukcje konwersji | Lista instrukcji konwersji | Lista instrukcji dotyczących konwertowania operacji |
właściwości specjalnej oferty
Notatka
Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, przejrzyj omówienie nowych środowisk handlowych.
Dotyczy tylko podtypów produktów "SpecializedOffers"
| Własność | Typ | Opis |
|---|---|---|
| data rozpoczęcia | Struna | Identyfikatory terminów, do których mają zastosowanie instrukcje |
| data zakończenia | Struna | Opcje definiujące odnowienia |
| polityki cenowe | Lista cenZasady | Lista zasad definiujących typy rabatów i wartości promocji. |
Minimalne Zobowiązanie Zakupowe
Atrybuty minimalnej kwoty, która może zostać zarezerwowana w usługach obliczeniowych.
| Własność | Typ | Opis |
|---|---|---|
| zboże | Struna | Okres minimalnego zobowiązania zakupu. |
| kod waluty | Słownik<String, String> | "waluta" i "symbol" minimalnej kwoty, którą można zadeklarować. |
| kwota | Int | Minimalna kwota, która może zostać przeznaczona na usługi obliczeniowe. |
Zasady Cenowe
Opisz typy rabatów i wartości promocji.
| Własność | Typ | Opis |
|---|---|---|
| typ | Struna | Opisz, czy rabat jest oparty na procentach, czy rabatach na stawkę płaską. |
| wartość | Struna | 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łasność | Typ | Opis |
|---|---|---|
| id | Struna | Identyfikator tej dostępności. Ten identyfikator jest unikatowy tylko w kontekście produktu nadrzędnego i jednostki SKU . Zwróć uwagę, że 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. |
| identyfikator produktu | Struna | Identyfikator produktu, który zawiera tę dostępność. |
| skuId | Struna | Identyfikator SKU, który zawiera tę dostępność. |
| catalogItemId | Struna | Unikatowy identyfikator tego elementu w wykazie. Ten identyfikator należy umieścić we właściwościach OrderLineItem.OfferId lub CartLineItem.CatalogItemId podczas zakupu nadrzędnego SKU . Uwaga ten identyfikator może ulec zmianie w czasie. Należy polegać na tej wartości tylko zaraz po jej pobraniu. Powinien on być dostępny i używany tylko w momencie zakupu. |
| domyślna waluta | Struna | Domyślna waluta obsługiwana dla tej usługi. |
| część | Struna | Segment branżowy dla tej dostępności. Obsługiwane wartości to: Komercyjna, Edukacja, Rządowa, Organizacja Niedochodowa. |
| kraj | Struna | Kraj lub region (w formacie kodu kraju ISO), w którym ta dostępność ma zastosowanie. |
| Możliwy do zakupu | bool | Wskazuje, czy ten produkt lub usługa jest dostępna do kupienia. |
| jestOdnawialne | bool | Wskazuje, czy ta dostępność jest odnawialna. |
| Instrukcje dotyczące odnowienia | RenewalInstruction | Reprezentuje instrukcje dotyczące odnawiania dla danej dostępności. |
| produkt | produkt | Produkt, który odpowiada tej dostępności. |
| Jednostka magazynowa (SKU) | Sku | SKU, któremu odpowiada ta dostępność. |
| Warunki | Tablica zasobów terminów | Kolekcja terminów, które mają zastosowanie do tej dostępności. |
| Linki | ResourceLinks | Linki do zasobów zawarte w ramach dostępności. |
Instrukcja odnawiania
Notatka
Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, przejrzyj omówienie nowych środowisk handlowych.
Reprezentuje instrukcje dotyczące odnawiania dla danej dostępności.
| Własność | Typ | Opis |
|---|---|---|
| identyfikatoryTerminówZastosowalnych | Tablica ciągów | Identyfikatory terminów, do których mają zastosowanie instrukcje |
| OpcjeOdnowienia | Lista opcji odnawiania | Opcje definiujące odnowienia |
Opcja odnowienia
Notatka
Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, przejrzyj omówienie nowych środowisk handlowych.
Reprezentuje instrukcje dotyczące odnawiania dla danej dostępności.
| Własność | Typ | Opis |
|---|---|---|
| renewToId | Struna | Przedstawia produkt i SKU do odnowienia |
| czyAutomatycznieOdnawialne | bool | Określa, czy dostępność może być odnawiana automatycznie |
Termin
Reprezentuje określenie, dla którego można kupić prawo do korzystania.
| Własność | Typ | Opis |
|---|---|---|
| czas trwania | Struna | 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 | Struna | Opis terminu. |
ZapytanieDotycząceSprawdzeniaInwentarza
Reprezentuje prośbę o sprawdzenie inwentarza pod kątem niektórych pozycji katalogowych.
| Własność | Typ | Opis |
|---|---|---|
| elementy docelowe | Tablica InventoryItem | Lista elementów katalogu, które zostaną ocenione przez kontrolę stanu magazynowego. |
| kontekst magazynowy | Pary klucz/wartość | Słownik wartości kontekstowych potrzebnych do przeprowadzania kontroli spisu. Każda SKU produktów zdefiniuje, które wartości (jeśli jakieś) są potrzebne do przeprowadzenia tej operacji. |
| Linki | ResourceLinks | Linki do zasobów zawarte w żądaniu sprawdzania spisu. |
Przedmiot Inwentarza
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łasność | Typ | Opis |
|---|---|---|
| identyfikator produktu | Struna | (Wymagane) Identyfikator produktu . |
| skuId | Struna | 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. |
| jestOgraniczone | bool | Wskazuje, czy ten element został uznany za mający ograniczenia w zasobach. |
| Ograniczenia | Tablica OgraniczenieZasobów | Szczegóły wszelkich ograniczeń znalezionych dla tego elementu. Ta właściwość zostanie wypełniona tylko wtedy, gdy isRestricted = "true". |
Ograniczenie inwentaryzacji
Reprezentuje szczegóły ograniczenia inwentarza. Te szczegóły dotyczą tylko wyników kontroli zapasów, a nie dotyczą żądań wejściowych.
| Własność | Typ | Opis |
|---|---|---|
| kod przyczyny | Struna | Kod identyfikujący przyczynę ograniczenia. |
| opis | Struna | Opis ograniczenia inwentarza. |
| Właściwości | Pary klucz/wartość | Słownik właściwości, które mogą zawierać szczegółowe informacje na temat ograniczenia. |
Typ cyklu rozliczeniowego
[Enum/dotnet/api/system.enum) z wartościami wskazującymi typ cyklu rozliczeniowego.
| Wartość | Pozycja | Opis |
|---|---|---|
| Nieznany | 0 | Inicjalizator typu wyliczeniowego. |
| Miesięczny | 1 | Wskazuje, że partner będzie naliczany co miesiąc. |
| Roczny | 2 | Wskazuje, że partner będzie obciążany opłatą roczną. |
| Żaden | 3 | Wskazuje, że partner nie zostanie obciążony opłatą. Ta wartość może być używana dla elementów wersji próbnej. |
| OneTime | 4 | Wskazuje, że partner zostanie obciążony jednorazowo. |
| Triennale | 5 | Wskazuje, że partner zostanie obciążony co trzy lata. |
WłaściwościAtestacji
Reprezentuje typ zaświadczenia oraz informuje, czy jest wymagany do zakupu.
| Własność | Typ | Opis |
|---|---|---|
| typ poświadczenia | Struna | Wskazuje typ zaświadczania. Produkty Windows 365 będą mieć taką samą wartość jak Windows 365. Tekst zaświadczenia Windows 365 brzmi: "Rozumiem, że każda osoba korzystająca z Windows 365 Business z korzyścią hybrydową musi również mieć prawidłową kopię systemu Windows 10/11 Pro zainstalowaną na swoim podstawowym urządzeniu służbowym." |
| wymusić poświadczenie | Boolean | Wskazuje, czy zaświadczenie jest wymagane do zakupu. |