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
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. |
SubskrypcjaLinki
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. |