Freigeben über


Abonnementressourcen

anwendbar auf: Partnerzentrum | Partnerzentrum betrieben von 21Vianet | Partnerzentrum für die Microsoft-Cloud für die US-Regierung

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 Ratenbegrenzung von 500 Anforderungen pro Minute pro Mandanten-ID.

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

Eigentum Typ BESCHREIBUNG
Identifikationsnummer Schnur Die Abonnement-ID.
Angebots-ID Schnur Die Angebots-ID
Berechtigungs-ID Schnur Der Berechtigungsbezeichner (eine Azure-Abonnement-ID).
angebotName Schnur Der Angebotsname.
benutzerfreundlicher Name Schnur Der Anzeigename für das vom Partner festgelegte Abonnement, um Klarheit zu schaffen.
Menge Zahl Die Menge. Diese Eigenschaft wird auf die Lizenzanzahl für die lizenzbasierte Abrechnung festgelegt.
Einheitstyp Schnur Die Einheiten, die die Menge für das Abonnement definieren: "Lizenzen", "Nutzungsbasiert" oder "Vorteil".
übergeordnete Abonnement-ID Schnur Dient zum Abrufen oder Festlegen des übergeordneten Abonnementkennzeichens.
Erstellungsdatum Schnur Ruft das Erstellungsdatum im Datums-/Uhrzeitformat ab oder legt es fest.
wirksames Anfangsdatum 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 nachträglich zu datieren oder es an ein anderes Abonnement anzupassen.
Verpflichtungsenddatum Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das Enddatum der Verpflichtung für dieses Abonnement im Datums-/Uhrzeitformat. Für Abonnements, die nicht automatisch verlängert werden, stellt diese Eigenschaft ein Datum dar, das weit in der Zukunft liegt. Neue Handelsendtermine sind inklusive, was bedeutet, dass das Ende der Laufzeit am Ende des ganzen Tages liegt. Veraltete Enddaten sind nicht inklusive.
Verpflichtungsenddatum 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 automatisch verlängert werden, stellt diese Eigenschaft ein Datum dar, das weit in der Zukunft liegt.
Status Schnur Der Abonnementstatus: "keiner", "aktiv", "ausstehend", "ausgesetzt", "abgelaufen", "deaktiviert" oder "gelöscht".
automatische Verlängerung aktiviert Boolescher Wert Ruft einen Wert ab, der angibt, ob das Abonnement automatisch verlängert wird.
Abrechnungstyp Schnur Gibt an, wie das Abonnement abgerechnet wird: "keiner", "Nutzung", "Lizenz" oder "Vorteil".
billingCycle Schnur Gibt die Häufigkeit an, mit der der Partner diesen Auftrag in Rechnung stellt. Unterstützte Werte sind die in BillingCycleType gefundenen Mitgliedsnamen.
hat käufliche Add-ons Boolescher Wert Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Abonnement kaufbare Add-Ons hat.
isTrial Boolescher Wert Ein Wert, der angibt, ob das Abonnement eine Testversion ist.
isMicrosoftProdukt Boolescher Wert Ein Wert, der angibt, ob das Abonnement ein Microsoft-Produkt ist.
VerlegerName Schnur Der Name des Herausgebers.
Handlungen Feld von Zeichenfolgen Ruft die zulässigen Aktionen ab oder legt sie fest. Mögliche Werte: "edit", "cancel"
partnerId Schnur Die PartnerID des Vertragshändlers, die im indirekten Partnermodell verwendet wird.
ZusätzlichePartnerkennungen Feld von Zeichenfolgen Eine Sammlung von PartnerIDs, die ausschließlich von Distributoren in den EU/EFTA-Märkten verwendet werden.
Aussetzungsgründe Feld von Zeichenfolgen Schreibgeschützt. Wenn das Abonnement ausgesetzt wurde, gibt dies an, warum.
Vertragsart Schnur Schreibgeschützt. Der Vertragstyp: "Abonnement", "Produktschlüssel" oder "Einlösungscode".
Rückerstattungsoptionen Anordnung von RefundOption-Ressourcen Schreibgeschützt. Die für dieses Abonnement verfügbaren Erstattungsoptionen.
Anweisungen für den nächsten geplanten Zeitraum Anweisungen für den nächsten geplanten Termin Ruft die geplanten Anweisungen ab, die beim Starten des nächsten Zeitraums ausgeführt werden, oder legt diese fest.
nächste Ladeanweisungen nextChargeInstructions Ruft Details zu den Abrechnungsanweisungen für den nächsten Zeitraum für ausstehende Änderungen des Abrechnungszyklus am Ende der aktuellen Vertragslaufzeit ab.
Links SubscriptionLinks Ruft die Abonnementlinks ab oder legt sie fest.
Bestell-ID Schnur Die ID der Bestellung, die zum Starten des Abonnements aufgegeben wurde.
Laufzeit Schnur Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuell unterstützten Werte sind P1M (1 Monat), P1Y (1 Jahr) und P3Y (3 Jahre).
termLifeCycleState Schnur Eine Darstellung des Ausdruckslebenszyklusstatus des Subscriptoins. Die aktuellen unterstützten Werte sind GA (allgemein verfügbar), EndOfSale und EndOfSaleWithConversions (kann umgewandelt werden).
Attributen Ressourcen-Attribute Die Metadatenattribute, die dem Abonnement entsprechen.
Verlängerungslaufzeit Schnur Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (1 Monat) und P1Y (1 Jahr).
Produkttyp Artikeltyp Schreibgeschützt. Der Typ des Produkts, für das das Abonnement gilt.
Verbrauchstyp Array von Überlastungsressourcen Ruft die Überlastung für einen bestimmten Kunden ab oder legt diese fest.
promotionId Schnur Die Aktions-ID, falls sie auf das Abonnement angewendet wird. Formatbeispiel: "39NFJQT1PJQB:0001:39NFJQT1Q5KN"
StornierungBisDatumErlaubt Datum/Uhrzeit Das letzte Datum für die Stornierung.
EnddatumDesAbrechnungszyklus Datum/Uhrzeit Ruft das Enddatum des Abrechnungszyklus für dieses Abonnement im Datum-Uhrzeit-Format ab oder legt es fest.
AbrechnungszyklusEndDatumZeit Datum/Uhrzeit Ruft das Enddatum des Abrechnungszyklus für dieses Abonnement im Datums-/Uhrzeitformat ab.
Produktbestell-ID Schnur 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.

Eigentum Typ BESCHREIBUNG
Angebot Verbinden Ruft das Angebot ab oder legt es fest.
Hauptabonnement Verbinden Ruft ab oder legt das übergeordnete Abonnement fest.
Produkt Verbinden Ruft das Produkt ab, das dem Abonnement zugeordnet ist.
Sku Verbinden Ruft die dem Abonnement zugeordnete Produkt-SKU ab.
Verfügbarkeit Verbinden Ruft die Produkt-SKU-Verfügbarkeit ab, die dem Abonnement zugeordnet ist.
Aktivierungslinks Verbinden Ruft die Liste der Aktivierungslinks ab, die dem Abonnement zugeordnet sind.
selbst Verbinden Die Selbst-URI.
Weiter Verbinden Die nächste Seite mit Elementen.
vorherige Verbinden Die vorherige Seite mit Elementen.

Status der Abonnementbereitstellung

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

Eigentum Typ BESCHREIBUNG
SKU-Nummer Schnur Eine Zeichenfolge, die die Produkt-SKU identifiziert.
Status Schnur Gibt den Bereitstellungsstatus an: "Erfolg", "Ausstehend" oder "fehlgeschlagen".
Menge Zahl Stellt die Abonnementmenge nach der Bereitstellung bereit.
Enddatum Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das Enddatum des Abonnements.
Attributen Ressourcen-Attribute Die Metadatenattribute.

Anweisungen für den nächsten geplanten Zeitraum

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

Eigentum Typ BESCHREIBUNG
Produkt Produkt Eine GUID-formatierte Zeichenfolge, die die Produkt-SKU identifiziert.
Menge Zahl Stellt die Abonnementmenge nach der Bereitstellung bereit.
benutzerdefiniertesVertragsenddatum 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 ihre Attribute werden im nächsten Zeitraum auf eine geplante Änderung angewendet.

Eigentum Typ BESCHREIBUNG
Produkt-ID Schnur Die ID für ein Produkt.
SKU-Nummer Schnur Stellt die Abonnementmenge nach der Bereitstellung bereit.
Verfügbarkeits-ID Schnur Die ID für diese Verfügbarkeit. Diese ID ist nur innerhalb des Kontexts des übergeordneten Produkts und der SKU eindeutig. Anmerkung 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 Schnur Gibt die Häufigkeit an, mit der der Partner diesen Auftrag in Rechnung stellt. Unterstützte Werte sind die in BillingCycleType gefundenen Mitgliedsnamen.
Laufzeit Schnur Eine ISO 8601-Darstellung der Dauer des Begriffs. Die aktuellen unterstützten Werte sind P1M (1 Monat) und P1Y (1 Jahr).
promotionId Schnur Der Aktionskennzeichnung, der für den nächsten geplanten Zeitraum angewendet werden soll. Formatbeispiel: "39NFJQT1PJQB:0001:39NFJQT1Q5KN."

nächste Ladeanweisungen

Die nextChargeInstructions-Ressource definiert die Abrechnungszyklusanweisungen, die zu Beginn der nächsten Laufzeit des Abonnements angewendet werden. Nur vorhanden, wenn ausstehende Abrechnungszyklusänderungen ausstehen.

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

Abonnementregistrierungsstatus

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

Eigentum Typ BESCHREIBUNG
Abonnement-ID Schnur Die Abonnement-ID.
Status Schnur Gibt den Registrierungsstatus an: "registriert", "registrieren" oder "nicht registriert".

SupportKontakt

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

Eigentum Typ BESCHREIBUNG
supportTenantId Schnur Eine formatierte GUID-Zeichenfolge, die den Mandantenbezeichner des Supportkontakts angibt.
supportMpnId Schnur Der Partnerbezeichner des Kontakts.
Name Schnur Der Name des Supportkontakts.
Links RessourcenLinks Die Links zum Supportkontakt.
Attributen Ressourcen-Attribute Die Metadatenattribute. Enthält "objectType": " SupportContact".

Überschreitung

Die Übernutzungsressource repräsentiert die Überschreitungen des Verbrauchsabonnements, denen sie möglicherweise zugewiesen wird, einschließlich der Zuordnung zu einem Vertriebspartner.

Eigentum Typ BESCHREIBUNG
azureEntitlementId Schnur Eine GUID-formatierte Zeichenfolge, die die Kennung des Verbrauchsabonnements angibt.
partnerId Schnur Der Partnerbezeichner des Vertriebspartners, der dem Abonnement zugeordnet ist.
Typ Schnur Der Typ der Überschreitung kann "Telefondienste" sein.
Überschuss Boolescher Wert Ein Wert, der angibt, ob die Überlastung aktiviert ist.
Links RessourcenLinks Die Überlastungsverknüpfung.
Attributen Ressourcen-Attribute Die Metadatenattribute. Enthält "objectType": "Overage".

RegistrierenAbonnement

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.

Eigentum Typ BESCHREIBUNG
HTTP-Antwortnachricht 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"

RückerstattungOption

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

Eigentum Typ BESCHREIBUNG
Typ Schnur Die Art der Rückerstattung. Die unterstützten Werte sind "Teilweise" und "Vollständig"
läuft ab nach 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.

Eigentum Typ BESCHREIBUNG
Identifikationsnummer Schnur Der Berechtigungsbezeichner
benutzerfreundlicher Name Schnur Der Anzeigename der Berechtigung.
Status Schnur Der Status der Berechtigung.
Abonnement-ID Schnur Der Abonnementbezeichner, zu dem die Berechtigung gehört.

Abonnement-Posten

Eine Position enthält die Kaufdetails eines bestimmten Abonnements.

Eigentum Typ Beschreibung
Identifikationsnummer Schnur Der Bezeichner des Abonnementpostenelements.
benutzerfreundlicher Name Schnur Die sprechende Bezeichnung für den vom Partner definierten Abonnement-Posten, um Missverständnisse zu vermeiden.
Umfang Bereich Der Bereich gibt an, wo Leistungen gelten.
automatische Verlängerung aktiviert Boolescher Typ (Boolean) Ruft einen Wert ab, der angibt, ob das Abonnement automatisch verlängert wird.
Status Schnur Der Abonnementstatus: "keiner", "aktiv", "ausstehend", "ausgesetzt", "abgelaufen", "deaktiviert" oder "gelöscht".
Kaufverpflichtung Kaufverpflichtung Der feste Betrag, der für Computing-Dienste festgelegt wurde.

Umfang

Der Bereich gibt an, wo Leistungen gelten.

Eigentum Typ Beschreibung
Typ Schnur Der Bereichstyp für einen Kauf: "Einzeln", "Geteilt", "Ressourcengruppe" oder "Verwaltungsgruppe".
Abonnement-ID Schnur Die ID des Azure-Plans, der für einen Kauf verwendet werden würde. Erforderlich für gemeinsamen Bereich.
Berechtigungs-ID Schnur Die ID des Azure-Abonnements, das für einen Kauf verwendet werden würde. Erforderlich für einen einzelnen Bereich.
ManagementGruppenId Schnur Die ID der Verwaltungsgruppe, die für einen Kauf verwendet werden würde. Dieser Bereich kann heute nur über das Azure-Portal ausgewählt werden, aber Updates spiegeln sich im PC wider.
resourceGroupId (resourceGroupId) Schnur Die ID der Ressourcengruppe, die für einen Kauf verwendet würde. Dieser Bereich kann heute nur über das Azure-Portal ausgewählt werden, aber Updates spiegeln sich im PC wider.

Kaufverpflichtung

Der feste Betrag, der für Computing-Dienste festgelegt wurde.

Eigentum Typ Beschreibung
Menge Schnur Die Festbetragsverpflichtung.
Korn Schnur Der Zeitraum für die Verpflichtung.
Währung Schnur Die Währung der Verpflichtung.