Udostępnij za pośrednictwem

Zasoby subskrypcji

  • Artykuł

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

Uwaga

Zasób Subskrypcja ma limit szybkości wynoszący 500 żądań na minutę na identyfikator dzierżawy.

Zasób Subskrypcja reprezentuje cykl życia subskrypcji i zawiera właściwości definiujące stany w całym cyklu życia subskrypcji.

Właściwość Type Opis
IDENTYFIKATOR string Identyfikator subskrypcji.
offerId string Identyfikator oferty.
entitlementId string Identyfikator uprawnień (identyfikator subskrypcji platformy Azure).
offerName string Nazwa oferty.
Friendlyname string Przyjazna nazwa subskrypcji zdefiniowanej przez partnera w celu ułatwienia uściślania.
ilość Liczba Ilość. Ta właściwość jest ustawiona na liczbę licencji na potrzeby rozliczeń opartych na licencjach.
Unittype string Jednostki definiujące ilość subskrypcji: "Licencje", "Oparte na użyciu" lub "Korzyść".
parentSubscriptionId string Pobiera lub ustawia identyfikator subskrypcji nadrzędnej.
Creationdate string Pobiera lub ustawia datę utworzenia w formacie daty i godziny.
effectiveStartDate 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 daty wykonania zmigrowanej subskrypcji lub dostosowania jej do innej.
commitmentEndDate 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.
commitmentEndDateTime 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.
status string Stan subskrypcji: "none", "active", "pending", "suspended", "expired", "disabled" lub "deleted".
autoRenewEnabled boolean Pobiera wartość wskazującą, czy subskrypcja jest odnawiana automatycznie.
typ rozliczeń string Określa sposób naliczania opłat za subskrypcję: "none", "usage", "license" lub "benefit".
billingCycle string Wskazuje częstotliwość, z jaką partner jest rozliczany za to zamówienie. Obsługiwane wartości to nazwy elementów członkowskich znajdujące się w obszarze BillingCycleType.
hasPurchasableAddons 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 boolean Wartość wskazująca, czy subskrypcja jest produktem firmy Microsoft.
publisherName string Nazwa wydawcy.
akcje tablica ciągów Pobiera lub ustawia dozwolone akcje. Możliwe wartości: "edit", "cancel"
partnerId string PartnerID odsprzedawcy rekordu używanego w modelu partnera pośredniego.
suspensionReasons tablica ciągów Tylko do odczytu. Jeśli subskrypcja została zawieszona, wskazuje, dlaczego.
Contracttype string Tylko do odczytu. Typ kontraktu: "subskrypcja", "productKey" lub "redemptionCode".
refundOptions tablica zasobów RefundOption Tylko do odczytu. Zestaw opcji zwrotu dostępnych dla tej subskrypcji.
scheduledNextTermInstructions scheduledNextTermInstructions Pobiera lub ustawia zaplanowane instrukcje wykonywane po rozpoczęciu następnego terminu.
nextChargeInstructions nextChargeInstructions Pobiera szczegółowe informacje dotyczące kolejnych instrukcji rozliczeniowych dotyczących oczekujących zmian w okresie rozliczeniowym na końcu bieżącego okresu.
połączenia SubskrypcjaLinki Pobiera lub ustawia łącza subskrypcji.
orderId string Identyfikator zamówienia, który został złożony w celu rozpoczęcia subskrypcji.
termDuration string Reprezentacja iso 8601 czasu trwania terminu. Bieżące obsługiwane wartości to P1M (1 miesiąc), P1Y (1 rok) i P3Y (3 lata).
atrybuty Atrybuty zasobów Atrybuty metadanych odpowiadające subskrypcji.
renewalTermDuration string Reprezentacja iso 8601 czasu trwania terminu. Bieżące obsługiwane wartości to P1M (1 miesiąc) i P1Y (1 rok).
Producttype Itemtype Tylko do odczytu. Typ produktu, dla których jest subskrypcja.
consumptionType tablica zasobów nadwyżkowych Pobiera lub ustawia nadwyżkę dla danego klienta.
identyfikator promocji string Identyfikator podwyższania poziomu, jeśli zostanie zastosowany do subskrypcji. Przykład formatu: "39NFJQT1PJQB:0001:39NFJQT1Q5KN"
CancellationAllowedUntilDate DateTime Data ostatniego anulowania.
BillingCycleEndDate DateTime Pobiera lub ustawia datę zakończenia cyklu rozliczeniowego dla tej subskrypcji w formacie daty i godziny.
BillingCycleEndDateTime DateTime Pobiera godzinę zakończenia cyklu rozliczeniowego dla tej subskrypcji w formacie daty i godziny.
productOrderId string 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.

Zasób SubscriptionLinks opisuje kolekcję łączy dołączonych do zasobu subskrypcji.

Właściwość Type Opis
offer Link Pobiera lub ustawia ofertę.
parentSubscription Link Pobiera lub ustawia subskrypcję nadrzędną.
product Link Pobiera produkt skojarzony z subskrypcją.
sku Link Pobiera jednostkę SKU produktu skojarzona z subskrypcją.
availability Link Pobiera dostępność jednostki SKU produktu skojarzonej z subskrypcją.
activationLinks Link Pobiera listę linków aktywacji skojarzonych z subskrypcją.
Własny Link Własny identyfikator URI.
next Link Następna strona elementów.
Poprzednich Link Poprzednia strona elementów.

SubscriptionProvisioningStatus

Zasób SubscriptionProvisioningStatus zawiera informacje o stanie aprowizacji subskrypcji.

Właściwość Type Opis
skuId string Ciąg identyfikujący jednostkę SKU produktu.
status string Wskazuje stan aprowizacji: "success", "pending" lub "failed".
ilość Liczba Udostępnia ilość subskrypcji po aprowizacji.
endDate ciąg w formacie daty i godziny UTC Data zakończenia subskrypcji.
atrybuty Atrybuty zasobów Atrybuty metadanych.

scheduledNextTermInstructions

Zasób scheduledNextTermInstructions definiuje instrukcje, które mają być stosowane na początku następnego okresu subskrypcji. Występuje tylko wtedy, gdy zaplanowane zmiany są ustawione lub dla wszystkich subskrypcji wersji próbnej.

Właściwość Type Opis
product Produktu Identyfikator GUID sformatowany ciąg identyfikujący jednostkę 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

Rezultat

Zasób scheduledNextTermInstructions.product i atrybuty zaplanowane zmiany zostaną zastosowane w następnym okresie.

Właściwość Type Opis
productId String Identyfikator produktu.
skuId String Udostępnia ilość subskrypcji po aprowizacji.
availabilityId 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.
billingCycle String Wskazuje częstotliwość, z jaką partner jest rozliczany za to zamówienie. Obsługiwane wartości to nazwy elementów członkowskich znajdujące się w obszarze BillingCycleType.
termDuration String Reprezentacja iso 8601 czasu trwania terminu. Bieżące obsługiwane wartości to P1M (1 miesiąc) i P1Y (1 rok).
identyfikator promocji String Identyfikator promocji, który ma zostać zastosowany do następnego zaplanowanego terminu. Przykład formatu: "39NFJQT1PJQB:0001:39NFJQT1Q5KN".

nextChargeInstructions

Zasób NextChargeInstructions definiuje instrukcje dotyczące cyklu rozliczeniowego zastosowane na początku następnego okresu subskrypcji. Występuje tylko wtedy, gdy oczekujące zmiany w cyklu rozliczeniowym są oczekujące.

Właściwość Type Opis
product Produktu Identyfikator GUID sformatowany ciąg identyfikujący jednostkę SKU produktu.
ilość Liczba Udostępnia ilość subskrypcji po aprowizacji.

SubscriptionRegistrationStatus

Zasób SubscriptionRegistrationStatus opisuje kolekcję łączy dołączonych do zasobu subskrypcji.

Właściwość Type Opis
subscriptionId string Identyfikator subskrypcji.
status string Wskazuje stan rejestracji: "zarejestrowane", "rejestrowanie" lub "niezarejestrowane".

SupportContact

Zasób SupportContact reprezentuje kontakt pomocy technicznej dla subskrypcji klienta.

Właściwość Type Opis
supportTenantId string Identyfikator GUID sformatowany ciąg wskazujący identyfikator dzierżawy kontaktu pomocy technicznej.
supportMpnId string Identyfikator partnera kontaktu.
nazwa string Nazwa kontaktu z pomocą techniczną.
połączenia ResourceLinks Linki powiązane z pomocą techniczną.
atrybuty Atrybuty zasobów Atrybuty metadanych. Zawiera wartość "objectType": " SupportContact".

Nadwyżka

Zasób nadwyżkowy reprezentuje nadwyżkę użycia subskrypcji, do której można przypisać, niezależnie od tego, czy jest przypisany, i przypisany odsprzedawca.

Właściwość Type Opis
azureEntitlementId string Identyfikator GUID sformatowany ciąg wskazujący identyfikator subskrypcji użycia.
partnerId string Identyfikator partnera odsprzedawcy skojarzonego z subskrypcją.
type string Typ nadwyżki może mieć wartość "Telefon Services"
Nadmiar boolean Wartość wskazująca, czy nadwyżka jest włączona.
połączenia ResourceLinks Linki związane z nadwyżką.
atrybuty Atrybuty zasobów Atrybuty metadanych. Zawiera wartość "objectType": "Overage".

RegisterSubscription

Zasób RegisterSubscription zwraca link, który może sł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łaściwość Type Opis
httpResponseMessage 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"

Zwrot kosztów

Zasób RefundOption reprezentuje możliwą opcję zwrotu kosztów dla subskrypcji.

Właściwość Type Opis
type string Typ zwrotu. Obsługiwane wartości to "Partial" i "Full"
wygasa po ciąg w formacie daty i godziny UTC Sygnatura czasowa po wygaśnięciu tej opcji. Jeśli wartość null, operacja zwrotu pieniędzy nie wygaśnie.

AzureEntitlement

Zasób AzureEntitlement reprezentuje uprawnienia platformy Azure dla subskrypcji.

Właściwość Type Opis
IDENTYFIKATOR string Identyfikator uprawnień
Friendlyname string Przyjazna nazwa uprawnienia.
status string Stan uprawnień.
subscriptionId string Identyfikator subskrypcji, do którego należy uprawnienie.

SubscriptionLineItem

Element wiersza zawiera szczegóły zakupu konkretnej subskrypcji.

Właściwości Type Opis
IDENTYFIKATOR string Identyfikator elementu wiersza subskrypcji.
Friendlyname string Przyjazna nazwa elementu wiersza subskrypcji zdefiniowana przez partnera w celu ułatwienia uściślania.
zakres Scope Zakres wskazuje, gdzie mają zastosowanie korzyści.
autoRenewEnabled Wartość logiczna Pobiera wartość wskazującą, czy subskrypcja jest odnawiana automatycznie.
status string Stan subskrypcji: "none", "active", "pending", "suspended", "expired", "disabled" lub "deleted".
purchaseCommitment Zobowiązanie zakupu Stała kwota zatwierdzona w usługach obliczeniowych.

Scope

Zakres wskazuje, gdzie mają zastosowanie korzyści.

Właściwości Type Opis
type string Typ zakresu zakupu: "Single", "Shared", "Resource group" lub "Management group".
subscriptionId string Identyfikator planu platformy Azure, który będzie używany do zakupu. Wymagany dla zakresu udostępnionego.
entitlementId string Identyfikator subskrypcji platformy Azure, która będzie używana do zakupu. Wymagane dla pojedynczego zakresu.
managementGroupId string Identyfikator grupy zarządzania, która będzie używana do zakupu. Ten zakres można wybrać tylko za pośrednictwem witryny Azure Portal dzisiaj, ale aktualizacje odzwierciedlają się na komputerze.
resourceGroupId string Identyfikator grupy zasobów, która będzie używana do zakupu. Ten zakres można wybrać tylko za pośrednictwem witryny Azure Portal dzisiaj, ale aktualizacje odzwierciedlają się na komputerze.

Zobowiązanie zakupu

Stała kwota zatwierdzona w usługach obliczeniowych.

Właściwości Type Opis
kwota string Zobowiązanie stałej kwoty.
Ziarna string Okres zobowiązania.
currency string Waluta zobowiązania.