TransferEntity-resurser
En partner skapar en överföring till en kunds nuvarande partner. Den aktuella partnern eller källpartnern accepterar överföringen och skickar den för att slutföra överföringen.
TransferEntity
Beskriver en transferEntity för nya handelsöverföringar.
| Property | Type | Beskrivning |
|---|---|---|
| ID | sträng | En transferEntity-identifierare som tillhandahålls när överföringenEntity har skapats. |
| status | sträng | Status för transferEntity. Möjliga värden är "Aktiv" (kan tas bort/skickas) och "Slutfört" (har redan slutförts). Tillämpas när transferEntity har skapats. |
| transferType | sträng | Ett tal som representerar typen av överföring. 3 löser till ModernAzure och 5 löser till NewCommerce. Partner som kör partner till partner för nya handelsöverföringar kan använda antingen men bör standardisera på 5. |
| customerEmailId | sträng | Identifierar kundens e-post som används för meddelanden. |
| createdTime | Datum/tid | Datumet då transferEntity skapades i datum-tid-format. Tillämpas när transferEntity har skapats. |
| lastModifiedTime | Datum/tid | Datumet då transferEntity senast uppdaterades, i datum-tid-format. Tillämpas när transferEntity har skapats. |
| completedTime | Datum/tid | Datumet då transferEntity slutfördes, i datum-tid-format. Tillämpas vid slutförande av överföringenEntity. |
| customerName | sträng | Valfritt. Namnet på kunden vars prenumerationer överförs. |
| customerTenantId | sträng | Ett GUID-formaterat kund-ID som identifierar kunden. Tillämpas när transferEntity har skapats. |
| partnertenantid | sträng | Ett GUID-formaterat partner-ID som identifierar partnern. |
| sourcePartnerName | sträng | Valfritt. Namnet på den partnerorganisation som initierar överföringen. |
| targetPartnerName | sträng | Valfritt. Namnet på den partnerorganisation som överföringen är riktad till. |
| targetPartnerTenantId | sträng | Ett GUID-formaterat partner-ID som identifierar den partner som överföringen är riktad till. |
| targetPartnerEmailId | sträng | En GUID-formaterad pid som identifierar den partner som överföringen är riktad till. Det här ID:t är detsamma som targetPartnerTenantId |
| transferDirection | sträng | Ett tal som representerar överföringens riktning. 1 representerar en inkommande överföring för den partner som accepterar överföringen. 2 representerar utgående överföring för den partner som skapar överföringen. |
| ignoreEligibilityCheck | sträng | Det här värdet ska vara falskt. |
| lastModifiedUser | sträng | Ett GUID-formaterat användar-ID som identifierar den senaste användaren att ändra överföringen |
| lineItems | Objektmatris | En matris med TransferLineItem-resurser . |
TransferLineItem
Representerar ett objekt som finns i en ny handelsöverföringEntity. Källpartners ser radobjekt för överföring av objekt som de försöker överföra. Målpartner ser nyligen skapade radobjekt när de har slutförts. Målpartner kan använda radobjekts-ID:n för att förstå nyligen skapade prenumerationer som är resultatet av överföringen.
| Property | Type | Beskrivning |
|---|---|---|
| ID | sträng | En unik identifierare för ett överföringsradobjekt. Tillämpas när transferEntity har skapats. |
| subscriptionId | sträng | Prenumerationsidentifieraren. |
| kvantitet | heltal | Antalet licenser eller instanser. |
| billingCycle | Objekt | Typ av faktureringsperiod som angetts för den aktuella perioden. |
| productType | sträng | En sträng som representerar den typ av produkt som överförs. |
| status | sträng | Status för lineitem i transferEntity. |
TransferEntity för traditionella licensbaserade överföringar
Beskriver en transferEntity.
| Property | Type | Beskrivning |
|---|---|---|
| ID | sträng | En transferEntity-identifierare som tillhandahålls när överföringenEntity har skapats. |
| createdTime | Datum/tid | Datumet då transferEntity skapades i datum-tid-format. Tillämpas när transferEntity har skapats. |
| lastModifiedTime | Datum/tid | Datumet då transferEntity senast uppdaterades, i datum-tid-format. Tillämpas när transferEntity har skapats. |
| lastModifiedUser | sträng | Användaren som senast uppdaterade transferEntity. Tillämpas vid lyckat skapande av transferEntity. |
| customerName | sträng | Valfritt. Namnet på kunden vars prenumerationer överförs. |
| customerTenantId | sträng | Ett GUID-formaterat kund-ID som identifierar kunden. Tillämpas när transferEntity har skapats. |
| partnertenantid | sträng | Ett GUID-formaterat partner-ID som identifierar partnern. |
| sourcePartnerName | sträng | Valfritt. Namnet på den partnerorganisation som initierar överföringen. |
| sourcePartnerTenantId | sträng | Ett GUID-formaterat partner-ID som identifierar partnern som initierar överföringen. |
| targetPartnerName | sträng | Valfritt. Namnet på den partnerorganisation som överföringen är riktad till. |
| targetPartnerTenantId | sträng | Ett GUID-formaterat partner-ID som identifierar den partner som överföringen är riktad till. |
| lineItems | Objektmatris | En matris med TransferLineItem-resurser . |
| status | sträng | Status för transferEntity. Möjliga värden är "Aktiv" (kan tas bort/skickas) och "Slutfört" (har redan slutförts). Tillämpas när transferEntity har skapats. |
TransferLineItem för traditionella licensbaserade överföringar
Representerar ett objekt som finns i en transferEntity.
| Property | Type | Beskrivning |
|---|---|---|
| ID | sträng | En unik identifierare för ett överföringsradobjekt. Tillämpas när transferEntity har skapats. |
| subscriptionId | sträng | Prenumerationsidentifieraren. |
| kvantitet | heltal | Antalet licenser eller instanser. |
| billingCycle | Objekt | Typ av faktureringsperiod som angetts för den aktuella perioden. |
| friendlyName | sträng | Valfritt. Det egna namnet på det objekt som definierats av partnern för att underlätta tvetydigheten. |
| partnerIdOnRecord | sträng | PartnerId på Posten vid köpet som sker när överföringen godkänns. |
| offerId | sträng | Erbjudandeidentifieraren. |
| addonItems | Lista över TransferLineItem-objekt | En samling transferEntity-radobjekt för tillägg som överförs tillsammans med den basprenumeration som överförs. Tillämpas när transferEntity har skapats. |
| transferError | sträng | Tillämpad efter överföringEntity godkänns om det skulle uppstå ett fel. |
| status | sträng | Status för lineitem i transferEntity. |
TransferSubmitResult
Representerar resultatet av en överförings accept för traditionella licensbaserade överföringar.
| Property | Type | Beskrivning |
|---|---|---|
| beställningar | Lista över orderobjekt. | Samlingen med beställningar. |
| transferErrors | Lista över TransferError-objekt. | Insamling av överföringsfel. |
TransferError
Representerar ett fel som uppstår när en traditionell licensbaserad överföring godkänns.
| Property | Type | Beskrivning |
|---|---|---|
| transferGroupId | sträng | Ordergruppens ID för ordern med felet . |
| kod | heltal | Felkoden. |
| description | sträng | Beskrivningen av felet. |
| lineItems | Lista över TransferLineItem-objekt | En samling transferEntity-radobjekt som ingår i överföringsfelet. |
TransferErrorCode
En [Enum/dotnet/api/system.enum) med värden som anger en typ av orderfel för traditionella licensbaserade överföringar.
| Värde | Position | beskrivning |
|---|---|---|
| PartnerTokenMissing | 800001 | Partnertoken saknas i begärandekontexten. |
| InvalidInput | 800002 | Ogiltiga indata för begäran. |
| ServiceException | 800003 | Oväntat tjänstfel. |
| InvalidOfferId | 800004 | Ogiltigt erbjudande-ID. |
| CreateOrderError | 800005 | Det går inte att skapa ordningen. |
| MpnIdNotFound | 800015 | PartnerID hittades inte. |
| NotValidIndirectResellerMpnId | 800016 | PartnerID är inte en giltig indirekt återförsäljare. |
| TransferIdNotFound | 900100 | Det går inte att hitta överföringsbegäran. |
| TransferNotAllowedIfStatusIsInProgress | 900101 | Överföringsbegäran pågår redan. |
| TransferNotAllowedIfStatusIsCompleted | 900102 | Överföringsbegäran är redan klar. |
| TransferCreateOrderError | 900103 | Överföringsordningen lyckas inte. |
| TransferProcessedByAnotherRequest | 900104 | Överföringen bearbetas av en annan begäran. |