Abonnementressourcen
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. |
SubscriptionLinks
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. |