Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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. |
AbonnementLinks
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. |