Abonnementressourcen

  • Artikel

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Mit einem Abonnement kann ein Kunde einen Dienst für einen bestimmten Zeitraum nutzen. Nicht alle Felder gelten für alle Abonnements. Viele Felder gelten nur an bestimmten Punkten des Lebenszyklus, z. B. wenn ein Abonnement ausgesetzt oder storniert wird.

Abonnement

Hinweis

Die Abonnementressource hat eine Rategrenze von 500 Anforderungen pro Minute pro Mandantenbezeichner.

Die Abonnementressource stellt den Lebenszyklus eines Abonnements dar und enthält Eigenschaften, die die Status während des gesamten Abonnementlebenszyklus definieren.

Eigenschaft Typ Beschreibung
id Zeichenfolge Die Abonnement-ID.
offerId Zeichenfolge Die Angebots-ID
entitlementId Zeichenfolge Der Berechtigungsbezeichner (eine Azure-Abonnement-ID).
offerName Zeichenfolge Der Angebotsname.
friendlyName Zeichenfolge Der Anzeigename für das vom Partner definierte Abonnement, um mehrdeutig zu sein.
Menge Zahl Die Menge. Diese Eigenschaft wird auf die Lizenzanzahl für die lizenzbasierte Abrechnung festgelegt.
unitType Zeichenfolge Die Einheiten, die die Menge für das Abonnement definieren: "Lizenzen", "Nutzungsbasiert" oder "Vorteil".
parentSubscriptionId Zeichenfolge Dient zum Abrufen oder Festlegen des übergeordneten Abonnementbezeichners.
creationDate Zeichenfolge Ruft das Erstellungsdatum im Datums-/Uhrzeitformat ab oder legt es fest.
effectiveStartDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Ruft ab oder legt das effektive Startdatum für dieses Abonnement im Datum-Uhrzeit-Format. Diese Eigenschaft wird verwendet, um ein migriertes Abonnement zurückzubekommen oder es an eine andere auszurichten.
commitmentEndDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das Enddatum der Verpflichtung für dieses Abonnement im Datums-/Uhrzeitformat. Für Abonnements, die nicht verwendbar sind, stellt diese Eigenschaft ein Datum dar, das in Zukunft weit entfernt ist. Neue Handelsendtermine sind inklusive, was bedeutet, dass das Ende der Laufzeit am Ende des ganzen Tages liegt. Veraltete Enddaten sind nicht inklusive.
commitmentEndDateTime Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das Enddatum und die Uhrzeit der Verpflichtung für dieses Abonnement im Datums-/Uhrzeitformat. Für Abonnements, die nicht verwendbar sind, stellt diese Eigenschaft ein Datum dar, das in Zukunft weit entfernt ist.
status Zeichenfolge Der Abonnementstatus: "none", "active", "pending", "suspended", "expired", "disabled" oder "deleted".
autoRenewEnabled boolean Ruft einen Wert ab, der angibt, ob das Abonnement automatisch verlängert wird.
billingType Zeichenfolge Gibt an, wie das Abonnement abgerechnet wird: "none", "usage", "license" oder "benefit".
billingCycle Zeichenfolge Gibt die Häufigkeit an, mit der der Partner für diese Bestellung in Rechnung gestellt wird. Die unterstützten Werte sind die in BillingCycleType angegebenen Elementnamen.
hasPurchasableAddons boolean Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Abonnement über bearbeitbare Add-Ons verfügt.
isTrial boolean Ein Wert, der angibt, ob das Abonnement eine Testversion ist.
isMicrosoftProduct boolean Ein Wert, der angibt, ob das Abonnement ein Microsoft-Produkt ist.
publisherName Zeichenfolge Der Herausgebername.
Aktionen Zeichenfolgen-Arrays Ruft die zulässigen Aktionen ab oder legt sie fest. Mögliche Werte: "edit", "cancel"
partnerId Zeichenfolge Die PartnerID des Datensatzhändlers, der im indirekten Partnermodell verwendet wird.
suspensionReasons Zeichenfolgen-Arrays Schreibgeschützt. Wenn das Abonnement ausgesetzt wurde, gibt dies an, warum.
Contracttype Zeichenfolge Schreibgeschützt. Der Vertragstyp: "subscription", "productKey" oder "redemptionCode".
refundOptions Array von RefundOption-Ressourcen Schreibgeschützt. Die für dieses Abonnement verfügbaren Erstattungsoptionen.
scheduledNextTermInstructions scheduledNextTermInstructions Ruft die geplanten Anweisungen ab, die beim Starten des nächsten Ausdrucks ausgeführt werden, oder legt diese fest.
nextChargeInstructions nextChargeInstructions Ruft Details zu den nächsten Abrechnungsanweisungen für ausstehende Abrechnungszeitraum Änderungen am Ende des aktuellen Ausdrucks ab.
Verknüpfungen SubscriptionLinks Ruft die Abonnementlinks ab oder legt sie fest.
orderId Zeichenfolge Die ID der Bestellung, die zum Starten des Abonnements aufgegeben wurde.
termDuration Zeichenfolge Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (1 Monat), P1Y (1 Jahr) und P3Y (3 Jahre).
Attributen Resourceattributes Die Metadatenattribute, die dem Abonnement entsprechen.
renewalTermDuration Zeichenfolge Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (1 Monat) und P1Y (1 Jahr).
ProductType Elementtyp Schreibgeschützt. Der Typ des Produkts, für das das Abonnement gilt.
consumptionType Array von Überlastungsressourcen Ruft die Überlastung für einen bestimmten Kunden ab oder legt diese fest.
promotionId Zeichenfolge Die Heraufsufungs-ID, wenn sie auf das Abonnement angewendet wird. Formatbeispiel: "39NFJQT1PJQB:0001:39NFJQT1Q5KN"
CancellationAllowedUntilDate Datetime Das letzte Datum für die Stornierung.
BillingCycleEndDate Datetime Dient zum Abrufen oder Festlegen des Abrechnungszeitraum Enddatums für dieses Abonnement im Datums-/Uhrzeitformat.
BillingCycleEndDateTime Datetime Ruft Abrechnungszeitraum Enddatumszeit für dieses Abonnement im Datums-/Uhrzeitformat ab.
productOrderId Zeichenfolge Bezeichner für einen bestimmten Produktkauf (z. B. Reservierungen oder Azure-Sparplan).
lineItems SubscriptionLineItem Eine Position enthält die Kaufdetails eines bestimmten Abonnements.

Die SubscriptionLinks-Ressource beschreibt die Sammlung von Verknüpfungen, die an eine Abonnementressource angefügt sind.

Eigenschaft Typ Beschreibung
offer Link Ruft das Angebot ab oder legt es fest.
parentSubscription Link Ruft ab oder legt das übergeordnete Abonnement fest.
product Link Ruft das Produkt ab, das dem Abonnement zugeordnet ist.
sku Link Ruft die dem Abonnement zugeordnete Produktsku ab.
Verfügbarkeit Link Ruft die Produkt-SKU-Verfügbarkeit ab, die dem Abonnement zugeordnet ist.
activationLinks Link Ruft die Liste der Aktivierungslinks ab, die dem Abonnement zugeordnet sind.
self Link Der Self-URI.
next Link Die nächste Seite mit Elementen.
previous Link Die vorherige Seite mit Elementen.

SubscriptionProvisioningStatus

Die SubscriptionProvisioningStatus-Ressource enthält Informationen zum Bereitstellungsstatus eines Abonnements.

Eigenschaft Typ Beschreibung
skuId Zeichenfolge Eine Zeichenfolge, die die Produkt-SKU identifiziert.
status Zeichenfolge Gibt den Bereitstellungsstatus an: "Erfolg", "Ausstehend" oder "fehlgeschlagen".
Menge Zahl Stellt die Abonnementmenge nach der Bereitstellung bereit.
endDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das Enddatum des Abonnements.
Attributen Resourceattributes Die Metadatenattribute.

scheduledNextTermInstructions

Die scheduledNextTermInstructions-Ressource definiert die Anweisungen, die zu Beginn der nächsten Laufzeit des Abonnements angewendet werden sollen. Nur vorhanden, wenn geplante Änderungen festgelegt oder für alle Testabonnements festgelegt sind.

Eigenschaft Typ BESCHREIBUNG
product product Eine GUID-formatierte Zeichenfolge, die die Produkt-SKU identifiziert.
Menge Zahl Stellt die Abonnementmenge nach der Bereitstellung bereit.
customTermEndDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das benutzerdefinierte Enddatum für das Abonnement, wenn es am Enddatum eines anderen Abonnements ausgerichtet ist

Produkt

Die scheduledNextTermInstructions.product-Ressource und Attribute einer geplanten Änderung werden beim nächsten Ausdruck angewendet.

Eigenschaft Typ Beschreibung
productId String Die ID für ein Produkt.
skuId String Stellt die Abonnementmenge nach der Bereitstellung bereit.
availabilityId String Die ID für diese Verfügbarkeit. Diese ID ist nur innerhalb des Kontexts des übergeordneten Produkts und der SKU eindeutig. Hinweis: Verfügbarkeits-IDs können sich im Laufe der Zeit ändern. Partner sollten sich nur innerhalb kurzer Zeit auf diesen Wert verlassen, nachdem er abgerufen wurde.
billingCycle String Gibt die Häufigkeit an, mit der der Partner für diese Bestellung in Rechnung gestellt wird. Die unterstützten Werte sind die in BillingCycleType angegebenen Elementnamen.
termDuration String Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (1 Monat) und P1Y (1 Jahr).
promotionId String Der Heraufsufungsbezeichner, der für den nächsten geplanten Ausdruck angewendet werden soll. Formatbeispiel: "39NFJQT1PJQB:0001:39NFJQT1Q5KN."

nextChargeInstructions

Die nextChargeInstructions-Ressource definiert die Abrechnungszeitraum Anweisungen, die zu Beginn des nächsten Ausdrucks des Abonnements angewendet werden. Nur vorhanden, wenn ausstehende Abrechnungszeitraum Änderungen ausstehen.

Eigenschaft Typ BESCHREIBUNG
product product Eine GUID-formatierte Zeichenfolge, die die Produkt-SKU identifiziert.
Menge Zahl Stellt die Abonnementmenge nach der Bereitstellung bereit.

SubscriptionRegistrationStatus

Die SubscriptionRegistrationStatus-Ressource beschreibt die Sammlung von Verknüpfungen, die an eine Abonnementressource angefügt sind.

Eigenschaft Typ BESCHREIBUNG
subscriptionId Zeichenfolge Die Abonnement-ID.
status Zeichenfolge Gibt den Registrierungsstatus an: "registriert", "registrieren" oder "nicht registriert".

SupportContact

Die SupportContact-Ressource stellt einen Supportkontakt für das Abonnement eines Kunden dar.

Eigenschaft Typ Beschreibung
supportTenantId Zeichenfolge Eine formatierte GUID-Zeichenfolge, die den Mandantenbezeichner des Supportkontakts angibt.
supportMpnId Zeichenfolge Der Partnerbezeichner des Kontakts.
name Zeichenfolge Der Name des Supportkontakts.
Verknüpfungen ResourceLinks Der Supportkontakt zu verwandten Links.
Attributen Resourceattributes Die Metadatenattribute. Enthält "objectType": " SupportContact".

Überschreitung

Die Überlastungsressource stellt die Überschreitung des Verbrauchsabonnements möglicherweise zugewiesen, ob sie zugewiesen ist und dem Vertriebspartner zugewiesen ist.

Eigenschaft Typ Beschreibung
azureEntitlementId Zeichenfolge Eine guid formatierte Zeichenfolge, die den Verbrauchsabonnementbezeichner angibt.
partnerId Zeichenfolge Der Partnerbezeichner des Vertriebspartners, der dem Abonnement zugeordnet ist.
Typ Zeichenfolge Der Typ der Überlastung kann "Telefon Services" sein.
Überdosierung boolean Ein Wert, der angibt, ob die Überlastung aktiviert ist.
Verknüpfungen ResourceLinks Die Überlastungsverknüpfung.
Attributen Resourceattributes Die Metadatenattribute. Enthält "objectType": "Overage".

RegisterSubscription

Die RegisterSubscription-Ressource gibt einen Link zurück, der zum Abfragen des Registrierungsstatus eines Abonnements verwendet werden kann. Der Registrierungsstatus wird im Antworttext einer erfolgreich angenommenen Anforderung zum Registrieren eines Azure-Abonnements zurückgegeben.

Eigenschaft Typ Beschreibung
httpResponseMessage Objekt Gibt DEN HTTP-Statuscode 202 "Akzeptiert" zurück, wobei ein Location-Header mit einem Link zum Abfragen des Registrierungsstatus enthalten ist. Beispiel: "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus"

RefundOption

Die RefundOption-Ressource stellt eine mögliche Rückerstattungsoption für das Abonnement dar.

Eigenschaft Typ Beschreibung
type Zeichenfolge Die Art der Rückerstattung. Die unterstützten Werte sind "Partial" und "Full"
expiresAfter Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Der Zeitstempel, wenn diese Option abläuft. Wenn NULL, hat der Erstattungsvorgang keinen Ablauf.

AzureEntitlement

Die AzureEntitlement-Ressource stellt die Azure-Berechtigungen für das Abonnement dar.

Eigenschaft Typ Beschreibung
id Zeichenfolge Der Berechtigungsbezeichner
friendlyName Zeichenfolge Der Anzeigename der Berechtigung.
status Zeichenfolge Der Status der Berechtigung.
subscriptionId Zeichenfolge Der Abonnementbezeichner, zu dem die Berechtigung gehört.

SubscriptionLineItem

Eine Position enthält die Kaufdetails eines bestimmten Abonnements.

Eigenschaft Typ Beschreibung
id Zeichenfolge Der Bezeichner des Abonnementpostenelements.
friendlyName Zeichenfolge Der Anzeigename für das vom Partner definierte Abonnementpositionselement, um mehrdeutig zu sein.
scope Umfang Bereich gibt an, wo Vorteile gelten.
autoRenewEnabled Boolean Ruft einen Wert ab, der angibt, ob das Abonnement automatisch verlängert wird.
status Zeichenfolge Der Abonnementstatus: "none", "active", "pending", "suspended", "expired", "disabled" oder "deleted".
purchaseCommitment Kaufverpflichtung Der feste Betrag, der für Computedienste zugesichert wurde.

Umfang

Bereich gibt an, wo Vorteile gelten.

Eigenschaft Typ Beschreibung
type Zeichenfolge Der Bereichstyp für einen Kauf: "Single", "Shared", "Resource group" oder "Management group".
subscriptionId Zeichenfolge Die ID des Azure-Plans, der für einen Kauf verwendet werden würde. Erforderlich für freigegebenen Bereich.
entitlementId Zeichenfolge Die ID des Azure-Abonnements, das für einen Kauf verwendet werden würde. Erforderlich für einen einzelnen Bereich.
managementGroupId Zeichenfolge Die ID der Verwaltungsgruppe, die für einen Kauf verwendet werden würde. Dieser Bereich kann nur über Azure-Portal heute ausgewählt werden, aber Updates spiegeln sich auf dem PC wider.
resourceGroupId Zeichenfolge Die ID der Ressourcengruppe, die für einen Kauf verwendet würde. Dieser Bereich kann nur über Azure-Portal heute ausgewählt werden, aber Updates spiegeln sich auf dem PC wider.

Kaufverpflichtung

Der feste Betrag, der für Computedienste zugesichert wurde.

Eigenschaft Typ Beschreibung
amount Zeichenfolge Die Festbetragsverpflichtung.
Korn Zeichenfolge Der Zeitraum für die Verpflichtung.
Währung Zeichenfolge Die Währung der Verpflichtung.