Manage orders - Create a transfer

Dienst:
Partner Center Rest
API-Version:
v1

Erstellt eine neue Übertragungsentität.

POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/transfers

URI-Parameter

Name In Erforderlich Typ Beschreibung
customer_id
 path True

string

Der Kundenbezeichner.
version
 path True

string

Die API-Versionsnummer.

Anforderungsheader

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Name Erforderlich Typ Beschreibung
Authorization True

string

Autorisierungs-Bearertoken
ms-correlationid

string

Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue.
ms-cv

string

Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn kein ms-cv bereitgestellt wird, generiert der Server für jede Anforderung eine neue.
ms-requestid

string

Wird für die Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue anforderung.

Anforderungstext

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

Name Typ Beschreibung
alternateId

string

Alternative Kennung für die Übertragungs-Entität. Value ist typischerweise ein GUID.
attributes

ResourceAttributes

Zusätzliche Attribute, die mit der Übertragungseinheit verbunden sind.
completedTime

string (date-time)

Die abgeschlossene Zeit für die Übertragungsgesellschaft. Verwendet das ISO 8601 Datum-Zeit-Format.
createdTime

string (date-time)

Das Datum und die Uhrzeit, an der die Übertragungseinheit erstellt wurde, im ISO-8601-Format. Verwendet das ISO 8601 Datum-Zeit-Format.
customerEmailId

string

Die eindeutige Kennung der Kunden-E-Mail. Value ist typischerweise ein GUID.
customerName

string

Der Kundenname der Übertragungsgesellschaft.
customerTenantId

string

Die eindeutige Kennung des Kundenmieters. Value ist typischerweise ein GUID.
expirationTime

string (date-time)

Die Ablaufzeit der Übertragungsgesellschaft. Verwendet das ISO 8601 Datum-Zeit-Format.
id

string

Eindeutige Identifikatorin für die Übertragungs-Entität. Value ist typischerweise ein GUID.
ignoreEligibilityCheck

boolean

Ob diese Übertragungsstelle die Berechtigungsprüfung ignoriert.
lastModifiedTime

string (date-time)

Die letzte modifizierte Zeit für die Übertragungs-Entität. Verwendet das ISO 8601 Datum-Zeit-Format.
lastModifiedUser

string

Der Nutzer, der zuletzt die Übertragungseinheit modifiziert hat.
lineItems

TransferLineItem[]

Die Sammlung der mit dieser Übertragungseinheit verbundenen Posten.
links

ResourceLinks

Links zu verwandten Ressourcen.
participants

StringStringKeyValuePair[]

Die Teilnehmer, die mit diesem Artikel verbunden sind.
partnerOnRecord

string

Der Partner, der für die Übertragungsgesellschaft dokumentiert ist.
partnertenantid

string

Die eindeutige Kennung der Übertragungs-Entität. Value ist typischerweise ein GUID.
sourcePartnerEmailId

string

Die eindeutige Identifikatorin der Partner-E-Mail. Value ist typischerweise ein GUID.
sourcePartnerName

string

Der Name des Quellpartners für die Übertragungsgesellschaft.
sourcePartnerTenantId

string

Die eindeutige Kennung des Quellpartner-Tenants. Value ist typischerweise ein GUID.
status

string

Der aktuelle Status der Übertragungsgesellschaft.
targetPartnerEmailId

string

Die eindeutige Kennung der Zielpartner-E-Mail. Value ist typischerweise ein GUID.
targetPartnerName

string

Der Name des Zielpartners für die Übertragungsgesellschaft.
targetPartnerTenantId

string

Die eindeutige Kennung des Zielpartner-Mieters. Value ist typischerweise ein GUID.
targetProductTypes

string[]

Die Sammlung der Zielprodukttypen, die mit dieser Übertragungseinheit assoziiert sind.
transferDirection enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)

Die Übertragungsrichtung für die Übertragungseinheit. Mögliche Werte sind: 0, 1, 2.
transferType enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)
  • 3 (int32)
  • 4 (int32)
  • 5 (int32)

Die Art der Übertragung, als ganze Zahl gesendet. Mögliche Werte sind: 0 (Unbekannt), 1 (EaToCsp), 2 (DirectToIndirect), 3 (ModernAzure), 4 (PartnerToPartner), 5 (NewCommerce).

Antworten

Name Typ Beschreibung
201 Created

TransferEntity

Die Anforderung war erfolgreich. Der Antworttext enthält die Übertragungsinformationen.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer versuchen dies möglicherweise erneut.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definitionen

Name Beschreibung
LastKnownBillingDetails

Stellt eine zuletzt bekannte Ressource für Abrechnungsdetails dar.
LastKnownBillingPeriod

Repräsentiert eine zuletzt bekannte Ressource für den Abrechnungszeitraum.
Link

Stellt eine Linkressource dar.
ResourceAttributes

Repräsentiert eine Ressource mit Ressourcenattributen.
ResourceLinks

Repräsentiert eine Ressource, die eine Ressource verknüpft.
StringStringKeyValuePair

Repräsentiert eine Schlüssel-Wertpaar-Ressource.
TransferEntity

Repräsentiert eine Ressource der übertragenen Entität.
TransferItemType

Repräsentiert den Typ des übertragenen Elements und wird als ganze Zahl gesendet. Mögliche Werte sind: 0 (AzureSubscription), 1 (AzureReservation), 2 (ModernAzureSubscription), 3 (LegacyAzureSubscription), 4 (AzureSavingsPlan), 5 (OnlineServicesNCE), 6 (Software), 7 (SaaS).
TransferLineItem

Repräsentiert eine Übertragungs-Zeilen-Ressource.
TransferLineItemError

Repräsentiert eine Übertragungs-Zeilen-Fehlerressource.
TransferLineItemPrice

Stellt eine Übertragungspostenpreisressource dar.

LastKnownBillingDetails

Objekt

Stellt eine zuletzt bekannte Ressource für Abrechnungsdetails dar.

Name Typ Beschreibung
billingAmount

number (double)

Der Rechnungsbetrag für die zuletzt bekannten Abrechnungsdetails.
billingCycle enum:
  • annual
  • monthly
  • none
  • one_time
  • unknown

Die Abrechnungshäufigkeit. Mögliche Werte sind: 'unbekannt', 'monatlich', 'jährlich', 'keine', 'one_time'.
billingPeriod

LastKnownBillingPeriod

Zusätzlicher Abrechnungszeitraum, der mit den zuletzt bekannten Abrechnungsdetails verbunden ist.
billingType enum:
  • license
  • none
  • usage

Der Abrechnungstyp für die zuletzt bekannten Abrechnungsdetails. Mögliche Werte sind: 'kein', 'Nutzung', 'Lizenz'.
currency

string

Der dreibuchstabige ISO-Währungscode.

LastKnownBillingPeriod

Objekt

Repräsentiert eine zuletzt bekannte Ressource für den Abrechnungszeitraum.

Name Typ Beschreibung
endDate

string (date-time)

Das Enddatum dieses Datensatzes ist im ISO-8601-Format. Verwendet das ISO 8601 Datum-Zeit-Format.
startDate

string (date-time)

Das Startdatum dieses Datensatzes ist im ISO-8601-Format. Verwendet das ISO 8601 Datum-Zeit-Format.
Objekt

Stellt eine Linkressource dar.

Name Typ Beschreibung
body

string

Der Körper für die Verbindung.
headers

StringStringKeyValuePair[]

Die Sammlung von Headern, die mit diesem Link verbunden sind.
method

string

Die Methode für den Link.
uri

string

Die URI für die zugehörige Ressource.

ResourceAttributes

Objekt

Repräsentiert eine Ressource mit Ressourcenattributen.

Name Typ Beschreibung
etag

string

Das Entitätstag, das für die Konkurrenzsteuerung verwendet wird.
objectType

string

Der Objekttyp für die Ressourcenattribute.
Objekt

Repräsentiert eine Ressource, die eine Ressource verknüpft.

Name Typ Beschreibung
next

Link

Zusätzliches ist mit den Ressourcenlinks verbunden.
previous

Link

Zusätzliche Vorgeschichte ist mit den Ressourcenlinks verbunden.
self

Link

Zusätzliche Selbstverbindungen zu den Ressourcenlinks.

StringStringKeyValuePair

Objekt

Repräsentiert eine Schlüssel-Wertpaar-Ressource.

Name Typ Beschreibung
key

string

Der Schlüssel für das Schlüssel-Wert-Paar.
value

string

Der Wert für das Schlüsselwertpaar.

TransferEntity

Objekt

Repräsentiert eine Ressource der übertragenen Entität.

Name Typ Beschreibung
alternateId

string

Alternative Kennung für die Übertragungs-Entität. Value ist typischerweise ein GUID.
attributes

ResourceAttributes

Zusätzliche Attribute, die mit der Übertragungseinheit verbunden sind.
completedTime

string (date-time)

Die abgeschlossene Zeit für die Übertragungsgesellschaft. Verwendet das ISO 8601 Datum-Zeit-Format.
createdTime

string (date-time)

Das Datum und die Uhrzeit, an der die Übertragungseinheit erstellt wurde, im ISO-8601-Format. Verwendet das ISO 8601 Datum-Zeit-Format.
customerEmailId

string

Die eindeutige Kennung der Kunden-E-Mail. Value ist typischerweise ein GUID.
customerName

string

Der Kundenname der Übertragungsgesellschaft.
customerTenantId

string

Die eindeutige Kennung des Kundenmieters. Value ist typischerweise ein GUID.
expirationTime

string (date-time)

Die Ablaufzeit der Übertragungsgesellschaft. Verwendet das ISO 8601 Datum-Zeit-Format.
id

string

Eindeutige Identifikatorin für die Übertragungs-Entität. Value ist typischerweise ein GUID.
ignoreEligibilityCheck

boolean

Ob diese Übertragungsstelle die Berechtigungsprüfung ignoriert.
lastModifiedTime

string (date-time)

Die letzte modifizierte Zeit für die Übertragungs-Entität. Verwendet das ISO 8601 Datum-Zeit-Format.
lastModifiedUser

string

Der Nutzer, der zuletzt die Übertragungseinheit modifiziert hat.
lineItems

TransferLineItem[]

Die Sammlung der mit dieser Übertragungseinheit verbundenen Posten.
links

ResourceLinks

Links zu verwandten Ressourcen.
participants

StringStringKeyValuePair[]

Die Teilnehmer, die mit diesem Artikel verbunden sind.
partnerOnRecord

string

Der Partner, der für die Übertragungsgesellschaft dokumentiert ist.
partnertenantid

string

Die eindeutige Kennung der Übertragungs-Entität. Value ist typischerweise ein GUID.
sourcePartnerEmailId

string

Die eindeutige Identifikatorin der Partner-E-Mail. Value ist typischerweise ein GUID.
sourcePartnerName

string

Der Name des Quellpartners für die Übertragungsgesellschaft.
sourcePartnerTenantId

string

Die eindeutige Kennung des Quellpartner-Tenants. Value ist typischerweise ein GUID.
status

string

Der aktuelle Status der Übertragungsgesellschaft.
targetPartnerEmailId

string

Die eindeutige Kennung der Zielpartner-E-Mail. Value ist typischerweise ein GUID.
targetPartnerName

string

Der Name des Zielpartners für die Übertragungsgesellschaft.
targetPartnerTenantId

string

Die eindeutige Kennung des Zielpartner-Mieters. Value ist typischerweise ein GUID.
targetProductTypes

string[]

Die Sammlung der Zielprodukttypen, die mit dieser Übertragungseinheit assoziiert sind.
transferDirection enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)

Die Übertragungsrichtung für die Übertragungseinheit. Mögliche Werte sind: 0, 1, 2.
transferType enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)
  • 3 (int32)
  • 4 (int32)
  • 5 (int32)

Die Art der Übertragung, als ganze Zahl gesendet. Mögliche Werte sind: 0 (Unbekannt), 1 (EaToCsp), 2 (DirectToIndirect), 3 (ModernAzure), 4 (PartnerToPartner), 5 (NewCommerce).

TransferItemType

Enumeration

Repräsentiert den Typ des übertragenen Elements und wird als ganze Zahl gesendet. Mögliche Werte sind: 0 (AzureSubscription), 1 (AzureReservation), 2 (ModernAzureSubscription), 3 (LegacyAzureSubscription), 4 (AzureSavingsPlan), 5 (OnlineServicesNCE), 6 (Software), 7 (SaaS).

Wert Beschreibung
0
1
2
3
4
5
6
7

TransferLineItem

Objekt

Repräsentiert eine Übertragungs-Zeilen-Ressource.

Name Typ Beschreibung
addonItems

TransferLineItem[]

Die Sammlung von Addon-Einträgen, die mit diesem Übertragungsposten verbunden sind.
billingCycle enum:
  • annual
  • monthly
  • none
  • one_time
  • unknown

Die Abrechnungshäufigkeit. Mögliche Werte sind: 'unbekannt', 'monatlich', 'jährlich', 'keine', 'one_time'.
billingDetails

LastKnownBillingDetails

Zusätzliche Abrechnungsdetails, die mit der Übertragungslinie verbunden sind.
currencyCode

string

Der dreibuchstabige ISO-Währungscode.
errors

TransferLineItemError[]

Die Sammlung von Fehlern, die mit diesem Übertragungsstrang verbunden sind.
friendlyName

string

Ein freundlicher Display-Name für diesen Artikel.
id

integer (int32)

Eindeutige Kennung für den Übertragungspost.
offerId

string

Die eindeutige Kennung des Angebots. Value ist typischerweise ein GUID.
orderId

string

Der eindeutige Bezeichner des Auftrags. Value ist typischerweise ein GUID.
partnerIdOnRecord

string

Die Partner-ID ist für die Übertragungszeile eingetragen.
price

TransferLineItemPrice

Der Preis für diesen Artikel.
productType

TransferItemType (int32)

Zusätzlicher Produkttyp, der mit der Übertragungslinie verbunden ist.
quantity

integer (int32)

Die Anzahl der Einheiten.
sourceSubscriptionTermEndDate

string (date-time)

Das Datum und die Uhrzeit, an der die Laufzeit des Quellabonnements endet, liegt in UTC.
sourceSubscriptionTermStartDate

string (date-time)

Das Startdatum des Quell-Abonnements im ISO-8601-Format. Verwendet das ISO 8601 Datum-Zeit-Format.
status

string

Der aktuelle Status der Übertragungszeile.
subscriptionId

string

Die eindeutige Kennung (GUID) des Abonnements. Value ist typischerweise ein GUID.
transferError

string

Der Übertragungsfehler für die Übertragungszeile.
transferGroupId

string

Die eindeutige Kennung der Übertragungsgruppe. Value ist typischerweise ein GUID.

TransferLineItemError

Objekt

Repräsentiert eine Übertragungs-Zeilen-Fehlerressource.

Name Typ Beschreibung
code

string

Der Code für den Übertragungsfehler.
description

string

Die Beschreibung dieses Gegenstands.

TransferLineItemPrice

Objekt

Stellt eine Übertragungspostenpreisressource dar.

Name Typ Beschreibung
currencyCode

string

Der dreibuchstabige ISO-Währungscode.
discountedPrice

number (double)

Der rabattierte Preis für den Übertragungspostenpreis.
erpPrice

number (double)

Der geschätzte Verkaufspreis (ERP). Der im Katalog angegebene geschätzte Einzelhandelspreis vor jeglichen Preismodifikatoren in der Währung der Zeile. Dies ist der vollwertige Einzelhandelspreis, wenn ein Verfügbarkeitszeitraum angegeben ist. Der Betrag erfolgt vor der Besteuerung, außer in steuereinschließenden Ländern oder Regionen, in denen der Preis die Steuer enthält. Diese Immobilie wird derzeit eingeführt und wird nicht für alle Partner zurückgegeben.
extendedPrice

number (double)

Der erweiterte Preis für den Übertragungspostenpreis.
listPrice

number (double)

Der Listenpreis vor der Anwendung von Rabatten.
price

number (double)

Der Preis für diesen Artikel.
proratedPrice

number (double)

Der anteilige Preis für den Übertragungsposten.