Zasoby subskrypcji
Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA
Subskrypcja umożliwia klientowi korzystanie z usługi przez określony czas. Nie wszystkie pola mają zastosowanie do wszystkich subskrypcji. Wiele pól ma zastosowanie tylko w niektórych punktach cyklu życia, na przykład jeśli subskrypcja jest zawieszona lub anulowana.
Subskrypcja
Notatka
Zasób subskrypcji ma limit szybkości wynoszący 500 żądań na minutę na identyfikator dzierżawy.
Zasób subskrypcji reprezentuje cykl życia subskrypcji i zawiera właściwości definiujące stany w całym cyklu jej życia.
| Własność | Typ | Opis |
|---|---|---|
| ID | struna | Identyfikator subskrypcji. |
| identyfikator oferty | struna | Identyfikator oferty. |
| identyfikatorUprawnieńId | struna | Identyfikator uprawnień (identyfikator subskrypcji platformy Azure). |
| nazwa oferty | struna | Nazwa oferty. |
| przyjaznaNazwa | struna | Przyjazna nazwa subskrypcji, zdefiniowana przez partnera w celu ułatwienia identyfikacji. |
| ilość | numer | Ilość. Ta właściwość jest ustawiona na liczbę licencji na potrzeby rozliczeń opartych na licencjach. |
| typ jednostki | struna | Jednostki definiujące ilość subskrypcji: "Licencje", "Oparte na użyciu" lub "Korzyść". |
| IdentyfikatorSubskrypcjiRodzica | struna | Pobiera lub ustawia identyfikator subskrypcji nadrzędnej. |
| creationDate (data utworzenia) | struna | Pobiera lub ustawia datę utworzenia w formacie daty i godziny. |
| dataRozpoczęcia | ciąg w formacie daty i godziny UTC | Pobiera lub ustawia datę rozpoczęcia obowiązywania dla tej subskrypcji w formacie daty i godziny. Ta właściwość jest używana do przypisania wcześniejszej daty zmigrowanej subskrypcji lub dopasowania jej do innej. |
| data zakończenia zobowiązania | ciąg w formacie daty i godziny UTC | Data zakończenia zobowiązania dla tej subskrypcji w formacie daty i godziny. W przypadku subskrypcji, które nie są autorenewowalne, ta właściwość reprezentuje datę daleko w przyszłości. Nowe daty zakończenia handlu są włącznie, co oznacza, że koniec okresu przypada na koniec pełnego dnia. Starsze daty zakończenia nie są uwzględniane. |
| data i godzina zakończenia zaangażowania | ciąg w formacie daty i godziny UTC | Data i godzina zakończenia zobowiązania dla tej subskrypcji w formacie daty i godziny. W przypadku subskrypcji, które nie są autorenewowalne, ta właściwość reprezentuje datę daleko w przyszłości. |
| stan | struna | Stan subskrypcji: "brak", "aktywna", "oczekująca", "zawieszona", "wygasła", "wyłączona" lub "usunięta". |
| auto-odnawianie włączone | boolean | Pobiera wartość wskazującą, czy subskrypcja jest odnawiana automatycznie. |
| Typ fakturowania | struna | Określa sposób, w jaki naliczane są opłaty za subskrypcję: "brak", "użytkowanie", "licencja" lub "korzyść". |
| billingCycle | struna | Wskazuje częstotliwość, z jaką partner jest rozliczany za to zamówienie. Obsługiwane wartości to nazwy członków znalezione w BillingCycleType. |
| maDostępneDoZakupuDodatki | boolean | Pobiera lub ustawia wartość wskazującą, czy subskrypcja ma możliwe do przekupu dodatki. |
| isTrial | boolean | Wartość wskazująca, czy subskrypcja jest wersją próbną. |
| isMicrosoftProduct | typ logiczny | Wartość wskazująca, czy subskrypcja jest produktem firmy Microsoft. |
| nazwa wydawcy | struna | Nazwa wydawcy. |
| działania | tablica ciągów | Pobiera lub ustawia dopuszczone działania. Możliwe wartości: "edit", "cancel" |
| partnerId | struna | PartnerID zarejestrowanego odsprzedawcy używanego w modelu pośrednictwa partnerskiego. |
| powody zawieszenia | tablica łańcuchów znaków | Tylko do odczytu. Jeśli subskrypcja została zawieszona, wskazuje, dlaczego. |
| typUmowy | struna | Tylko do odczytu. Typ kontraktu: "subskrypcja", "productKey" lub "redemptionCode". |
| opcje zwrotu | zbiór zasobów RefundOption | Tylko do odczytu. Zestaw opcji zwrotu dostępnych dla tej subskrypcji. |
| instrukcje dotyczące zaplanowania kolejnego okresu | scheduledNextTermInstructions | Pobiera lub ustawia zaplanowane instrukcje wykonywane w momencie rozpoczęcia kolejnego terminu. |
| następneInstrukcjeŁadowania | nextChargeInstructions | Pobiera szczegółowe informacje dotyczące kolejnych instrukcji rozliczeniowych dotyczących oczekujących zmian w okresie rozliczeniowym na końcu bieżącego okresu. |
| Linki | SubscriptionLinks | Pobiera lub ustawia łącza subskrypcji. |
| identyfikator zamówienia | struna | Identyfikator zamówienia, który został złożony w celu rozpoczęcia subskrypcji. |
| okres trwania | struna | Reprezentacja ISO 8601 czasu trwania okresu. Bieżące obsługiwane wartości to P1M (1 miesiąc), P1Y (1 rok) i P3Y (3 lata). |
| Atrybuty | ResourceAttributes | Atrybuty metadanych odpowiadające subskrypcji. |
| czas trwania okresu odnowienia | struna | Reprezentacja czasu trwania terminu w formacie ISO 8601. Bieżące obsługiwane wartości to P1M (1 miesiąc) i P1Y (1 rok). |
| Typ Produktu | TypElementu | Tylko do odczytu. Typ produktu, dla których jest subskrypcja. |
| typ konsumpcji | tablica zasobów nadwyżkowych | Pobiera lub ustawia nadwyżkę dla danego klienta. |
| identyfikator promocji | struna | Identyfikator promocji, jeśli zostanie zastosowany do subskrypcji. Przykład formatu: "39NFJQT1PJQB:0001:39NFJQT1Q5KN" |
| Data do której odwołanie jest dozwolone | Data/godzina | Ostateczny termin na anulowanie. |
| Data zakończenia cyklu rozliczeniowego | Data i czas | Pobiera lub ustawia datę zakończenia cyklu rozliczeniowego dla tej subskrypcji w formacie daty i godziny. |
| DataCzasKońcaCykluRozliczeniowego | DateTime | Pobiera godzinę zakończenia cyklu rozliczeniowego dla tej subskrypcji w formacie daty i godziny. |
| IdZamówieniaProduktu | struna | Identyfikator określonego zakupu produktu (na przykład rezerwacje lub plan oszczędności platformy Azure). |
| lineItems | SubscriptionLineItem | Element wiersza zawiera szczegóły zakupu konkretnej subskrypcji. |
Linki subskrypcyjne
Zasób SubscriptionLinks opisuje kolekcję łączy dołączonych do zasobu subskrypcji.
| Własność | Typ | Opis |
|---|---|---|
| oferta | Łącze | Pobiera lub ustawia ofertę. |
| subskrypcja nadrzędna | Link | Pobiera lub ustawia subskrypcję nadrzędną. |
| produkt | Link | Pobiera produkt skojarzony z subskrypcją. |
| SKU (jednostka magazynowa) | Link | Pobiera SKU produktu skojarzone z subskrypcją. |
| dostępność | Link | Pobiera dostępność SKU produktu skojarzonego z subskrypcją. |
| linki aktywacyjne | Link | Pobiera listę linków aktywacji skojarzonych z subskrypcją. |
| jaźń | Link | Własny identyfikator URI. |
| następny | Link | Następna strona elementów. |
| poprzedni | Łącze | Poprzednia strona elementów. |
Status Provisioningu Subskrypcji
Zasób SubscriptionProvisioningStatus zawiera informacje o stanie aprowizacji subskrypcji.
| Własność | Typ | Opis |
|---|---|---|
| skuId | struna | Ciąg identyfikujący SKU produktu. |
| stan | struna | Wskazuje stan dostarczania: "sukces", "oczekujący" lub "niepowodzenie". |
| ilość | liczba | Udostępnia liczbę subskrypcji po udostępnieniu. |
| data końcowa | ciąg w formacie daty i godziny UTC | Data zakończenia subskrypcji. |
| Atrybuty | ResourceAttributes | Atrybuty metadanych. |
instrukcje dotyczące zaplanowanego następnego okresu
Zasób scheduledNextTermInstructions definiuje instrukcje, które mają być stosowane na początku następnego okresu subskrypcji. Występuje tylko wtedy, gdy są zaplanowane zmiany lub dla wszystkich subskrypcji wersji próbnej.
| Własność | Typ | Opis |
|---|---|---|
| produkt | produkt | Ciąg sformatowany jako GUID, identyfikujący SKU produktu. |
| ilość | liczba | Udostępnia ilość subskrypcji po aprowizacji. |
| customTermEndDate | ciąg w formacie daty i godziny UTC | Niestandardowa data zakończenia subskrypcji, gdy jest zgodna z datą zakończenia innej subskrypcji |
Produkt
Zasób scheduledNextTermInstructions.product i atrybuty zaplanowane zmiany zostaną zastosowane w następnym okresie.
| Własność | Typ | Opis |
|---|---|---|
| productId | Struna | Identyfikator produktu. |
| skuId | Struna | Podaje liczbę subskrypcji po udostępnieniu. |
| identyfikatorDostępności | 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. |
| billingCycle | Struna | Wskazuje częstotliwość, z jaką partner jest rozliczany za to zamówienie. Obsługiwane wartości to nazwy członków znalezione w BillingCycleType. |
| czas trwania umowy | Struna | Reprezentacja ISO 8601 okresu trwania. Bieżące obsługiwane wartości to P1M (1 miesiąc) i P1Y (1 rok). |
| identyfikator promocji | Struna | Identyfikator promocji, który ma zostać zastosowany dla następnego zaplanowanego terminu. Przykład formatu: "39NFJQT1PJQB:0001:39NFJQT1Q5KN". |
instrukcje dotyczące kolejnego ładowania
Zasób nextChargeInstructions definiuje instrukcje dotyczące cyklu rozliczeniowego zastosowane na początku następnego okresu subskrypcji. Występuje tylko wtedy, gdy planowane są zmiany w cyklu rozliczeniowym.
| Własność | Typ | Opis |
|---|---|---|
| produkt | produkt | Ciąg znaków w formacie GUID identyfikujący kod SKU produktu. |
| ilość | liczba | Udostępnia liczbę subskrypcji po udostępnieniu. |
StatusRejestracjiSubskrypcji
Zasób SubscriptionRegistrationStatus opisuje kolekcję łączy dołączonych do zasobu subskrypcji.
| Własność | Typ | Opis |
|---|---|---|
| identyfikator subskrypcji | struna | Identyfikator subskrypcji. |
| stan | struna | Wskazuje stan rejestracji: "zarejestrowane", "rejestrowanie" lub "niezarejestrowane". |
SupportContact
Zasób SupportContact reprezentuje kontakt pomocy technicznej dla subskrypcji klienta.
| Własność | Typ | Opis |
|---|---|---|
| supportTenantId | struna | Identyfikator typu GUID, który wskazuje identyfikator dzierżawcy dla kontaktu pomocy technicznej. |
| supportMpnId | struna | Identyfikator partnera danego kontaktu. |
| nazwa | struna | Nazwa kontaktu z pomocą techniczną. |
| Linki | ResourceLinks | Linki związane z kontaktem do pomocy technicznej. |
| Atrybuty | ResourceAttributes | Atrybuty metadanych. Zawiera wartość "objectType": " SupportContact". |
Przekroczenie
Zasób nadwyżkowy oznacza nadwyżkę użycia subskrypcji, która może zostać przypisana, czy jest przypisana i do którego odsprzedawcy.
| Własność | Typ | Opis |
|---|---|---|
| azureEntitlementId | struna | Identyfikator subskrypcji zużycia w formacie ciągu GUID. |
| partnerId | struna | Identyfikator partnera odsprzedawcy skojarzonego z subskrypcją. |
| typ | struna | Typ nadwyżki może mieć wartość "UsługiTelefoniczne" |
| Przekroczenie limitu | logiczny | Wartość wskazująca, czy nadwyżka jest włączona. |
| Linki | ResourceLinks | Linki dotyczące nadmiernych opłat. |
| Atrybuty | ResourceAttributes | Atrybuty metadanych. Zawiera wartość "objectType": "Overage". |
ZarejestrujSubskrypcję
Zasób RegisterSubscription zwraca link, którego można użyć do wykonywania zapytań dotyczących stanu rejestracji subskrypcji. Stan rejestracji jest zwracany w treści odpowiedzi pomyślnie zaakceptowanego żądania zarejestrowania subskrypcji platformy Azure.
| Własność | Typ | Opis |
|---|---|---|
| wiadomość odpowiedzi HTTP | obiekt | Zwraca kod stanu HTTP 202 "Zaakceptowano" z nagłówkiem Lokalizacja zawierającym link do zapytania o stan rejestracji. Na przykład "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus" |
Opcja zwrotu
Zasób RefundOption reprezentuje możliwość zwrotu kosztów dla subskrypcji.
| Własność | Typ | Opis |
|---|---|---|
| typ | struna | Typ zwrotu. Obsługiwane wartości to "Częściowy" i "Pełny" |
| wygasa po | ciąg w formacie daty i godziny UTC | Sygnatura czasowa, kiedy ta opcja wygasa. Jeśli wartość null, operacja zwrotu pieniędzy nie wygaśnie. |
AzureEntitlement
Zasób AzureEntitlement reprezentuje uprawnienia platformy Azure dla subskrypcji.
| Własność | Typ | Opis |
|---|---|---|
| Identyfikator | struna | Identyfikator uprawnień |
| przyjaznaNazwa | struna | Przyjazna nazwa uprawnienia. |
| stan | struna | Stan uprawnień. |
| identyfikator subskrypcji | struna | Identyfikator subskrypcji, do którego przypisane jest uprawnienie. |
ElementSubskrypcji
Element wiersza zawiera szczegóły zakupu konkretnej subskrypcji.
| właściwości | typu | opis |
|---|---|---|
| ID | struna | Identyfikator pozycji subskrypcyjnej. |
| przyjaznaNazwa | struna | Łatwa do zapamiętania nazwa pozycji subskrypcji zdefiniowana przez partnera, aby pomóc w rozróżnieniu. |
| zakres | zakresu | Zakres wskazuje, gdzie mają zastosowanie korzyści. |
| auto-odnowienie włączone | Boolean | Pobiera wartość wskazującą, czy subskrypcja jest odnawiana automatycznie. |
| stan | struna | Stan subskrypcji: "brak", "aktywny", "oczekujący", "zawieszony", "wygasły", "wyłączony" lub "usunięty". |
| zobowiązanie zakupu | zobowiązanie zakupu | Ustalona kwota przeznaczona na usługi obliczeniowe. |
Zakres
Zakres wskazuje, gdzie mają zastosowanie korzyści.
| właściwości | typu | opis |
|---|---|---|
| typ | struna | Typ zakresu zakupu: "Single", "Shared", "Resource group" lub "Management group". |
| identyfikator subskrypcji | struna | Identyfikator planu platformy Azure, który będzie używany do zakupu. Wymagany dla zakresu udostępnionego. |
| identyfikatorUprawnienia | struna | Identyfikator subskrypcji platformy Azure, która będzie używana do zakupu. Wymagane dla pojedynczego zakresu. |
| IdentyfikatorGrupyZarządzającej | struna | Identyfikator grupy zarządzania, który będzie używany przy zakupie. Ten zakres można wybrać tylko za pośrednictwem portalu Azure dzisiaj, ale aktualizacje są widoczne na komputerze. |
| IdentyfikatorGrupyZasobów | struna | Identyfikator grupy zasobów, która będzie używana do zakupu. Ten zakres można wybrać tylko za pośrednictwem portalu Azure dzisiaj, ale aktualizacje pojawiają się na komputerze. |
Zobowiązanie zakupu
Stała kwota zadeklarowana na usługi obliczeniowe.
| właściwości | typu | opis |
|---|---|---|
| kwota | struna | Zobowiązanie stałej kwoty. |
| zboże | struna | Okres zobowiązania. |
| waluta | struna | Waluta zobowiązania. |