Freigeben über


TransferEntity-Ressourcen

Ein Partner erstellt eine Übertragung an den aktuellen Partner eines Kunden. Der aktuelle Partner oder der Quellpartner akzeptiert die Übertragung und übermittelt sie, um die Übertragung abzuschließen.

TransferEntity

Beschreibt eine TransferEntity für neue Handelstransfers.

Eigenschaft Typ Beschreibung
id Zeichenfolge Ein transferEntity-Bezeichner, der bei erfolgreicher Erstellung der transferEntity bereitgestellt wird.
Status Zeichenfolge Der Status der transferEntity. Mögliche Werte sind "Aktiv" (kann gelöscht/übermittelt werden) und "Abgeschlossen" (wurde bereits abgeschlossen). Auf erfolgreiche Erstellung der transferEntity angewendet.
Transferart Zeichenfolge Eine Zahl, die den Übertragungstyp darstellt. 3 löst in ModernAzure und 5 wird in NewCommerce aufgelöst. Partner, die Partner für neue E-Commerce-Übertragungen ausführen, können entweder entweder verwenden, sollten aber auf 5 standardisieren.
Kunden-E-Mail-ID Zeichenfolge Identifiziert die für Benachrichtigungen verwendete Kunden-E-Mail.
createdTime Datum/Uhrzeit Das Datum, an dem die transferEntity erstellt wurde, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung der transferEntity angewendet.
lastModifiedTime Datum/Uhrzeit Das Datum, an dem die transferEntity zuletzt aktualisiert wurde, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung der transferEntity angewendet.
completedTime Datum/Uhrzeit Das Datum, an dem die transferEntity abgeschlossen wurde, im Datums-/Uhrzeitformat. Anwendung nach erfolgreichem Abschluss der transferEntity.
Kundenname Zeichenfolge Wahlfrei. Der Name des Kunden, dessen Abonnements übertragen werden.
Kundenmieter-ID Zeichenfolge Eine GUID-formatierte Kunden-ID, die den Kunden identifiziert. Auf erfolgreiche Erstellung der transferEntity angewendet.
partnertenantid Zeichenfolge Eine GUID-formatierte Partner-ID, die den Partner identifiziert.
QuellPartnerName Zeichenfolge Wahlfrei. Der Name der Organisation des Partners, die die Übertragung initiiert.
targetPartnerName Zeichenfolge Wahlfrei. Der Name der Organisation des Partners, an die die Übertragung gerichtet ist.
partnerOnRecord Zeichenfolge Wahlfrei. Die indirekten Anbieter registrierter Abonnementberater weisen den übertragenen Positionen zu.
targetProductTypes Zeichenfolge Wahlfrei. Eine Sammlung von Zeichenfolgen, die die Typen von Abonnements festlegen, die für eine Übertragung eingereicht werden können. Null wird von allen Typen angenommen. Werte können AzureSubscription, AzureReservation, AzureSavingsPlan und OnlineServicesNCE enthalten.
targetPartnerTenantId Zeichenfolge Eine GUID-formatierte Partner-ID, die den Partner identifiziert, an den die Übertragung gerichtet ist.
Zielpartner-E-Mail-ID Zeichenfolge Eine GUID-formatierte Partner-ID, die den Partner identifiziert, an den die Übertragung gerichtet ist. Diese ID ist identisch mit der targetPartnerTenantId
transferDirection Zeichenfolge Eine Zahl, die die Richtung der Übertragung darstellt. 1 stellt eine eingehende Übertragung für den Partner dar, der die Übertragung akzeptiert. 2 stellt ausgehende Übertragung für den Partner dar, der die Übertragung erstellt.
ignoreEligibilityCheck Zeichenfolge Dieser Wert sollte falsch sein.
lastModifiedUser Zeichenfolge Eine GUID-formatierte Benutzer-ID, die den letzten Benutzer identifiziert, um die Übertragung zu ändern.
lineItems Array von Objekten Ein Array von TransferLineItem-Ressourcen .

TransferLineItem

Stellt ein Element dar, das in einer neuen Commerce transferEntity enthalten ist. Quellpartner sehen Positionen für die Übertragung von Elementen, die sie übertragen möchten. Zielpartner sehen neu erstellte Zeilenelemente, nachdem sie abgeschlossen wurden. Zielpartner können die Zeilenelement-IDs verwenden, um neu erstellte Abonnements zu verstehen, die sich aus der Übertragung ergeben.

Eigenschaft Typ Beschreibung
id Zeichenfolge Ein eindeutiger Bezeichner für ein Übertragungszeilenelement. Auf erfolgreiche Erstellung der transferEntity angewendet.
benutzerfreundlicher Name Zeichenfolge Der Name des Abonnements.
Abonnement-ID Zeichenfolge Die Abonnement-ID.
Menge INT Die Anzahl der Lizenzen oder Instanzen.
billingCycle Objekt Der Typ der Abrechnungszeitraum für den aktuellen Zeitraum festgelegt.
Produkttyp Zeichenfolge Eine Zeichenfolge, die den Typ des übertragenen Produkts darstellt.
Status Zeichenfolge Der Status des Zeilenelements in der transferEntity.
Quellabonnementslaufzeitstartdatum Datum und Uhrzeit Dieser Wert stellt das Erstellungsdatum und die Uhrzeit (in UTC) des Quellabonnements dar, das an den Zielpartner übertragen wird.
Preis Liste der Preise Eine Sammlung von Preiswerten für ein abgeschlossenes Transferpositionselement. Gilt nur für neue, lizenzbasierte Übertragungspositionen im Rahmen des neuen Handels.

Preis

Der Preis stellt Werte dar, die erläutern, wie viel die Positionen kosten. Es gibt vier Werte, die im Preis enthalten sind.

Eigenschaft Typ Beschreibung
listPrice Gleitkommazahl Der Einzelpreis für den nächsten Abrechnungszeitraum ohne Anwendung von Preismodifizierern. Dieser Betrag liegt vor steuern. In den inklusiven Steuerländern/Regionen umfasst dieser Preis die Steuer; andernfalls nicht. Einzelpreis pro Abrechnungszeitraum. Gilt nur für neue, lizenzbasierte Übertragungspositionen im Rahmen des neuen Handels.
Ermäßigter Preis Gleitkommazahl Der Listenpreis, nachdem alle anwendbaren Preismodifizierer angewendet wurden. Dieser Betrag liegt vor steuern. In den inklusiven Steuerländern/Regionen umfasst dieser Preis die Steuer; andernfalls nicht. Gilt nur für neue, lizenzbasierte Übertragungspositionen im Rahmen des neuen Handels.
Preis Gleitkommazahl Der anteilige Einheitsbetrag für den verbleibenden Abrechnungszyklus. Der Einzelpreis in der Zielrechnungswährung, nachdem alle Rabatte angewendet wurden und eine anteilige Berechnung durchgeführt wurde. Dieser Betrag liegt vor steuern. In den inklusiven Steuerländern/Regionen umfasst dieser Preis die Steuer; andernfalls nicht. Dies ist UnitPrice in der UX. Nächster Stückrechnungsbetrag. Gilt nur für neue, lizenzbasierte Übertragungspositionen im Rahmen des neuen Handels.
Gesamtpreis Gleitkommazahl Der Preis der Position mit angewendeter Menge, angewendeten Rabatten und anteiliger Berechnung in der Zielabrechnungswährung. Für den Rest des Zeitraums. Dieser Betrag liegt vor steuern. In den inklusiven Steuerländern/Regionen umfasst dieser Preis die Steuer; andernfalls nicht. Dies ist TotalPrice in der UX. Gilt nur für neue, lizenzbasierte Übertragungspositionen im Rahmen des neuen Handels.
Währungscode Zeichenfolge Die Abkürzung für die Preiswährung. Gilt nur für neue, lizenzbasierte Übertragungspositionen im Rahmen des neuen Handels.

TransferEntity für herkömmliche lizenzbasierte Übertragungen

Beschreibt eine transferEntity.

Eigenschaft Typ Beschreibung
id Zeichenfolge Ein transferEntity-Bezeichner, der bei erfolgreicher Erstellung der transferEntity bereitgestellt wird.
createdTime Datum/Uhrzeit Das Datum, an dem die transferEntity erstellt wurde, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung der transferEntity angewendet.
lastModifiedTime Datum/Uhrzeit Das Datum, an dem die transferEntity zuletzt aktualisiert wurde, im Datums-/Uhrzeitformat. Auf erfolgreiche Erstellung der transferEntity angewendet.
lastModifiedUser Zeichenfolge Der Benutzer, der die transferEntity zuletzt aktualisiert hat. Angewendet auf erfolgreiche Erstellung von transferEntity.
Kundenname Zeichenfolge Wahlfrei. Der Name des Kunden, dessen Abonnements übertragen werden.
Kundenmieter-ID Zeichenfolge Eine GUID-formatierte Kunden-ID, die den Kunden identifiziert. Auf erfolgreiche Erstellung der transferEntity angewendet.
partnertenantid Zeichenfolge Eine GUID-formatierte Partner-ID, die den Partner identifiziert.
QuellPartnerName Zeichenfolge Wahlfrei. Der Name der Organisation des Partners, die die Übertragung initiiert.
sourcePartnerTenantId Zeichenfolge Eine GUID-formatierte Partner-ID, die den Partner identifiziert, der die Übertragung initiiert.
targetPartnerName Zeichenfolge Wahlfrei. Der Name der Organisation des Partners, an die die Übertragung gerichtet ist.
targetPartnerTenantId Zeichenfolge Eine GUID-formatierte Partner-ID, die den Partner identifiziert, an den die Übertragung gerichtet ist.
lineItems Array von Objekten Ein Array von TransferLineItem-Ressourcen .
Status Zeichenfolge Der Status der transferEntity. Mögliche Werte sind "Aktiv" (kann gelöscht/übermittelt werden) und "Abgeschlossen" (wurde bereits abgeschlossen). Auf erfolgreiche Erstellung der transferEntity angewendet.

TransferLineItem für herkömmliche lizenzbasierte Übertragungen

Stellt ein Element dar, das in einer transferEntity enthalten ist.

Eigenschaft Typ Beschreibung
id Zeichenfolge Ein eindeutiger Bezeichner für ein Übertragungszeilenelement. Auf erfolgreiche Erstellung der transferEntity angewendet.
Abonnement-ID Zeichenfolge Die Abonnement-ID.
Menge INT Die Anzahl der Lizenzen oder Instanzen.
billingCycle Objekt Der Typ der Abrechnungszeitraum für den aktuellen Zeitraum festgelegt.
benutzerfreundlicher Name Zeichenfolge Wahlfrei. Der Anzeigename für das element, das vom Partner definiert wurde, um mehrdeutig zu sein.
partnerIdOnRecord Zeichenfolge Die aufgezeichnete Partner-ID für den Kauf, der erfolgt, wenn die Übertragung akzeptiert wird.
angebot-ID Zeichenfolge Die Angebots-ID
addonItems Liste der TransferLineItem-Objekte Eine Sammlung von transferEntity-Positionen für Addons, die zusammen mit dem übertragenen Basisabonnement übertragen werden. Auf erfolgreiche Erstellung der transferEntity angewendet.
Übertragungsfehler Zeichenfolge Wird angewendet, nachdem transferEntity akzeptiert wurde, falls ein Fehler auftritt.
Status Zeichenfolge Der Status des Zeilenelements in der transferEntity.

TransferSubmitResult

Stellt das Ergebnis einer Übertragung für herkömmliche lizenzbasierte Übertragungen dar.

Eigenschaft Typ Beschreibung
Aufträge Liste der Order-Objekte . Die Sammlung von Bestellungen.
Übertragungsfehler Liste der TransferError-Objekte . Die Sammlung von Übertragungsfehlern.

Übertragungsfehler

Stellt einen Fehler dar, der auftritt, wenn eine herkömmliche lizenzbasierte Übertragung akzeptiert wird.

Eigenschaft Typ Beschreibung
transferGroupId Zeichenfolge Die Auftragsgruppen-ID der Bestellung mit dem Fehler.
Code INT Der Fehlercode.
Beschreibung Zeichenfolge Die Beschreibung des Fehlers.
lineItems Liste der TransferLineItem-Objekte Eine Sammlung von transferEntity-Zeilenelementen, die Teil des Übertragungsfehlers sind.

TransferErrorCode

Eine [Enum/dotnet/api/system.enum) mit Werten, die einen Auftragsfehlertyp für herkömmliche lizenzbasierte Übertragungen angeben.

Wert Position Beschreibung
PartnerTokenMissing 800001 Partnertoken fehlt im Anforderungskontext.
Ungültige Eingabe 800002 Ungültige Anforderungseingabe.
Dienstfehler 800003 Unerwarteter Dienstfehler.
InvalidOfferId 800004 Ungültige Angebots-ID.
CreateOrderError 800005 Die Reihenfolge zum Erstellen ist nicht erfolgreich.
MpnIdNotFound 800015 PartnerID wurde nicht gefunden.
NotValidIndirectResellerMpnId 800016 PartnerID ist kein gültiger indirekter Wiederverkäufer.
TransferIdNotFound 900100 Die Übertragungsanforderung wurde nicht gefunden.
TransferNotAllowedIfStatusIsInProgress 900101 Die Übertragungsanforderung wird bereits ausgeführt.
TransferNotAllowedIfStatusIsCompleted 900102 Die Übertragungsanforderung ist bereits abgeschlossen.
TransferCreateOrderError 900103 Der Überweisungsauftrag ist nicht erfolgreich.
TransferProcessedByAnotherRequest 900104 Die Übertragung wird von einer anderen Anforderung verarbeitet.