Manage orders - Create a transfer
Crea una nuova entità di trasferimento.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/transfersParametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
Identificatore del cliente. |
|
version
|
path | True |
string |
Il numero di versione dell'API. |
Intestazione di richiesta
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| Authorization | True |
string |
Token di connessione dell'autorizzazione |
| ms-correlationid |
string |
Usato per tenere traccia delle richieste internamente. Se non viene specificato un ms-correlationid, il server genererà un nuovo elemento per ogni richiesta |
|
| ms-cv |
string |
Usato per tenere traccia delle richieste internamente. Se non viene specificata una ms-cv, il server genererà un nuovo per ogni richiesta |
|
| ms-requestid |
string |
Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server genererà un nuovo per ogni richiesta |
Corpo della richiesta
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nome | Tipo | Descrizione |
|---|---|---|
| alternateId |
string |
Identificatore alternativo per l'entità di trasferimento. Il valore è tipicamente un GUID. |
| attributes |
Attributi aggiuntivi associati all'entità di trasferimento. |
|
| completedTime |
string (date-time) |
Il tempo completato per l'entità di trasferimento. Utilizza il formato data-ora ISO 8601. |
| createdTime |
string (date-time) |
La data e l'ora in cui l'entità di trasferimento è stata creata, in formato ISO 8601. Utilizza il formato data-ora ISO 8601. |
| customerEmailId |
string |
L'identificatore unico dell'email del cliente. Il valore è tipicamente un GUID. |
| customerName |
string |
Il nome del cliente per l'entità di trasferimento. |
| customerTenantId |
string |
L'identificatore unico del cliente inquilino. Il valore è tipicamente un GUID. |
| expirationTime |
string (date-time) |
Il tempo di scadenza per l'entità di trasferimento. Utilizza il formato data-ora ISO 8601. |
| id |
string |
Identificatore unico per l'entità di trasferimento. Il valore è tipicamente un GUID. |
| ignoreEligibilityCheck |
boolean |
Se questa entità di trasferimento ignora il controllo di idoneità. |
| lastModifiedTime |
string (date-time) |
L'ultimo tempo modificato per l'entità di trasferimento. Utilizza il formato data-ora ISO 8601. |
| lastModifiedUser |
string |
L'utente che ha modificato l'entità di trasferimento per ultimo. |
| lineItems |
La raccolta delle voci associate a questa entità di trasferimento. |
|
| links |
Collegamenti a risorse correlate. |
|
| participants |
I partecipanti associati a questo oggetto. |
|
| partnerOnRecord |
string |
Il socio registrato per l'entità di trasferimento. |
| partnertenantid |
string |
L'identificatore univoco dell'entità di trasferimento. Il valore è tipicamente un GUID. |
| sourcePartnerEmailId |
string |
L'identificatore unico dell'email del partner di origine. Il valore è tipicamente un GUID. |
| sourcePartnerName |
string |
Il nome del partner di partenza per l'entità di trasferimento. |
| sourcePartnerTenantId |
string |
L'identificatore univoco del tenant partner sorgente. Il valore è tipicamente un GUID. |
| status |
string |
Stato attuale dell'entità di trasferimento. |
| targetPartnerEmailId |
string |
L'identificatore unico dell'email del partner target. Il valore è tipicamente un GUID. |
| targetPartnerName |
string |
Il nome del partner target per l'entità di trasferimento. |
| targetPartnerTenantId |
string |
L'identificatore univoco del partner inquilino target. Il valore è tipicamente un GUID. |
| targetProductTypes |
string[] |
La raccolta dei tipi di prodotti target associati a questa entità di trasferimento. |
| transferDirection |
enum:
|
La direzione di trasferimento per l'entità di trasferimento. I valori possibili includono: 0, 1, 2. |
| transferType |
enum:
|
Il tipo di trasferimento, inviato come intero. I valori possibili includono: 0 (Sconosciuto), 1 (EaToCsp), 2 (DirectToIndirect), 3 (ModernAzure), 4 (PartnerToPartner), 5 (NewCommerce). |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 201 Created |
La richiesta ha avuto esito positivo. Il corpo della risposta contiene le informazioni di trasferimento. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 400 Bad Request |
Non è presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
La richiesta non è stata autenticata. Il client deve prima eseguire l'autenticazione con il servizio API partner. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
La risorsa non viene trovata o non è disponibile con i parametri di input specificati. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta. I chiamanti possono riprovare. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Definizioni
| Nome | Descrizione |
|---|---|
|
Last |
Rappresenta l'ultima risorsa nota per i dettagli di fatturazione. |
|
Last |
Rappresenta l'ultima risorsa nota per il periodo di fatturazione. |
| Link |
Rappresenta una risorsa link. |
|
Resource |
Rappresenta una risorsa attributi. |
|
Resource |
Rappresenta una risorsa di link di risorsa. |
|
String |
Rappresenta una risorsa di coppie chiave-valore. |
|
Transfer |
Rappresenta una risorsa di entità di trasferimento. |
|
Transfer |
Rappresenta il tipo di elemento trasferito, inviato come intero. I valori possibili includono: 0 (AzureSubscription), 1 (AzureReservation), 2 (ModernAzureSubscription), 3 (LegacyAzureSubscription), 4 (AzureSavingsPlan), 5 (OnlineServicesNCE), 6 (Software), 7 (SaaS). |
|
Transfer |
Rappresenta una risorsa di trasferimento di linea. |
|
Transfer |
Rappresenta una risorsa di errore di linea di trasferimento. |
|
Transfer |
Rappresenta una risorsa di prezzo di riga di trasferimento. |
LastKnownBillingDetails
Rappresenta l'ultima risorsa nota per i dettagli di fatturazione.
| Nome | Tipo | Descrizione |
|---|---|---|
| billingAmount |
number (double) |
L'importo di fatturazione per gli ultimi dettagli di fatturazione conosciuti. |
| billingCycle |
enum:
|
Frequenza di fatturazione. I valori possibili includono: 'sconosciuto', 'mensile', 'annuale', 'nessuno', 'one_time'. |
| billingPeriod |
Periodo di fatturazione aggiuntivo associato agli ultimi dettagli di fatturazione conosciuti. |
|
| billingType |
enum:
|
Il tipo di fatturazione per gli ultimi dettagli di fatturazione conosciuti. I valori possibili includono: 'nessuno', 'uso', 'licenza'. |
| currency |
string |
Il codice valuta ISO a tre lettere. |
LastKnownBillingPeriod
Rappresenta l'ultima risorsa nota per il periodo di fatturazione.
| Nome | Tipo | Descrizione |
|---|---|---|
| endDate |
string (date-time) |
La data di fine di questo disco, in formato ISO 8601. Utilizza il formato data-ora ISO 8601. |
| startDate |
string (date-time) |
La data di inizio di questo record, in formato ISO 8601. Utilizza il formato data-ora ISO 8601. |
Link
Rappresenta una risorsa link.
| Nome | Tipo | Descrizione |
|---|---|---|
| body |
string |
Il corpo per il collegamento. |
| headers |
La raccolta di intestazioni associata a questo link. |
|
| method |
string |
Il metodo per il link. |
| uri |
string |
L'URI della risorsa correlata. |
ResourceAttributes
Rappresenta una risorsa attributi.
| Nome | Tipo | Descrizione |
|---|---|---|
| etag |
string |
Il tag dell'entità utilizzato per il controllo della concorrenza. |
| objectType |
string |
Il tipo di oggetto per gli attributi risorsa. |
ResourceLinks
Rappresenta una risorsa di link di risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| next |
Ulteriori dettagli legati ai link di risorse. |
|
| previous |
Ulteriori precedenti associati ai link alle risorse. |
|
| self |
Ulteriori sé associati ai link delle risorse. |
StringStringKeyValuePair
Rappresenta una risorsa di coppie chiave-valore.
| Nome | Tipo | Descrizione |
|---|---|---|
| key |
string |
La chiave per la coppia chiave-valore. |
| value |
string |
Il valore per la coppia chiave-valore. |
TransferEntity
Rappresenta una risorsa di entità di trasferimento.
| Nome | Tipo | Descrizione |
|---|---|---|
| alternateId |
string |
Identificatore alternativo per l'entità di trasferimento. Il valore è tipicamente un GUID. |
| attributes |
Attributi aggiuntivi associati all'entità di trasferimento. |
|
| completedTime |
string (date-time) |
Il tempo completato per l'entità di trasferimento. Utilizza il formato data-ora ISO 8601. |
| createdTime |
string (date-time) |
La data e l'ora in cui l'entità di trasferimento è stata creata, in formato ISO 8601. Utilizza il formato data-ora ISO 8601. |
| customerEmailId |
string |
L'identificatore unico dell'email del cliente. Il valore è tipicamente un GUID. |
| customerName |
string |
Il nome del cliente per l'entità di trasferimento. |
| customerTenantId |
string |
L'identificatore unico del cliente inquilino. Il valore è tipicamente un GUID. |
| expirationTime |
string (date-time) |
Il tempo di scadenza per l'entità di trasferimento. Utilizza il formato data-ora ISO 8601. |
| id |
string |
Identificatore unico per l'entità di trasferimento. Il valore è tipicamente un GUID. |
| ignoreEligibilityCheck |
boolean |
Se questa entità di trasferimento ignora il controllo di idoneità. |
| lastModifiedTime |
string (date-time) |
L'ultimo tempo modificato per l'entità di trasferimento. Utilizza il formato data-ora ISO 8601. |
| lastModifiedUser |
string |
L'utente che ha modificato l'entità di trasferimento per ultimo. |
| lineItems |
La raccolta delle voci associate a questa entità di trasferimento. |
|
| links |
Collegamenti a risorse correlate. |
|
| participants |
I partecipanti associati a questo oggetto. |
|
| partnerOnRecord |
string |
Il socio registrato per l'entità di trasferimento. |
| partnertenantid |
string |
L'identificatore univoco dell'entità di trasferimento. Il valore è tipicamente un GUID. |
| sourcePartnerEmailId |
string |
L'identificatore unico dell'email del partner di origine. Il valore è tipicamente un GUID. |
| sourcePartnerName |
string |
Il nome del partner di partenza per l'entità di trasferimento. |
| sourcePartnerTenantId |
string |
L'identificatore univoco del tenant partner sorgente. Il valore è tipicamente un GUID. |
| status |
string |
Stato attuale dell'entità di trasferimento. |
| targetPartnerEmailId |
string |
L'identificatore unico dell'email del partner target. Il valore è tipicamente un GUID. |
| targetPartnerName |
string |
Il nome del partner target per l'entità di trasferimento. |
| targetPartnerTenantId |
string |
L'identificatore univoco del partner inquilino target. Il valore è tipicamente un GUID. |
| targetProductTypes |
string[] |
La raccolta dei tipi di prodotti target associati a questa entità di trasferimento. |
| transferDirection |
enum:
|
La direzione di trasferimento per l'entità di trasferimento. I valori possibili includono: 0, 1, 2. |
| transferType |
enum:
|
Il tipo di trasferimento, inviato come intero. I valori possibili includono: 0 (Sconosciuto), 1 (EaToCsp), 2 (DirectToIndirect), 3 (ModernAzure), 4 (PartnerToPartner), 5 (NewCommerce). |
TransferItemType
Rappresenta il tipo di elemento trasferito, inviato come intero. I valori possibili includono: 0 (AzureSubscription), 1 (AzureReservation), 2 (ModernAzureSubscription), 3 (LegacyAzureSubscription), 4 (AzureSavingsPlan), 5 (OnlineServicesNCE), 6 (Software), 7 (SaaS).
| Valore | Descrizione |
|---|---|
| 0 | |
| 1 | |
| 2 | |
| 3 | |
| 4 | |
| 5 | |
| 6 | |
| 7 |
TransferLineItem
Rappresenta una risorsa di trasferimento di linea.
| Nome | Tipo | Descrizione |
|---|---|---|
| addonItems |
La collezione di elementi aggiuntivi associati a questa voce di trasferimento in linea. |
|
| billingCycle |
enum:
|
Frequenza di fatturazione. I valori possibili includono: 'sconosciuto', 'mensile', 'annuale', 'nessuno', 'one_time'. |
| billingDetails |
Dettagli aggiuntivi di fatturazione associati alla voce di trasferimento. |
|
| currencyCode |
string |
Il codice valuta ISO a tre lettere. |
| errors |
La raccolta di errori associati a questa voce di trasferimento. |
|
| friendlyName |
string |
Un nome amichevole per questo oggetto. |
| id |
integer (int32) |
Identificatore unico per la voce di trasferimento. |
| offerId |
string |
L'identificatore unico dell'offerta. Il valore è tipicamente un GUID. |
| orderId |
string |
Identificatore univoco dell'ordine. Il valore è tipicamente un GUID. |
| partnerIdOnRecord |
string |
L'ID del partner è registrato per la voce di trasferimento. |
| price |
Il prezzo associato a questo articolo. |
|
| productType |
Transfer |
Tipo di prodotto aggiuntivo associato alla voce di trasferimento della linea. |
| quantity |
integer (int32) |
Numero di unità. |
| sourceSubscriptionTermEndDate |
string (date-time) |
La data e l'ora in cui termina il termine dell'abbonamento sorgente, in UTC. |
| sourceSubscriptionTermStartDate |
string (date-time) |
La data di inizio del periodo di abbonamento sorgente, in formato ISO 8601. Utilizza il formato data-ora ISO 8601. |
| status |
string |
Lo stato attuale della voce di trasferimento. |
| subscriptionId |
string |
L'identificatore univoco (GUID) dell'abbonamento. Il valore è tipicamente un GUID. |
| transferError |
string |
L'errore di trasferimento per la voce di trasferimento. |
| transferGroupId |
string |
L'identificatore univoco del gruppo di trasferimento. Il valore è tipicamente un GUID. |
TransferLineItemError
Rappresenta una risorsa di errore di linea di trasferimento.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Il codice per l'errore della linea di trasferimento. |
| description |
string |
La descrizione di questo oggetto. |
TransferLineItemPrice
Rappresenta una risorsa di prezzo di riga di trasferimento.
| Nome | Tipo | Descrizione |
|---|---|---|
| currencyCode |
string |
Il codice valuta ISO a tre lettere. |
| discountedPrice |
number (double) |
Il prezzo scontato per il prezzo della linea di trasferimento della linea. |
| erpPrice |
number (double) |
Il prezzo stimato al dettaglio (ERP). La singola quantità stimata del prezzo al dettaglio elencata nel catalogo prima che vengano applicati eventuali modificatori di prezzo, nella valuta della linea. Questo è il prezzo al dettaglio a pieno termine quando viene specificato un termine di disponibilità. L'importo è prima di tassazione, tranne nei paesi o nelle regioni incluse fiscalmente dove il prezzo include l'imposta. Questa proprietà è attualmente in fase di implementazione e non viene restituita a tutti i partner. |
| extendedPrice |
number (double) |
Il prezzo esteso per il prezzo della linea di trasferimento della linea. |
| listPrice |
number (double) |
Il prezzo di listino prima che vengano applicati gli sconti. |
| price |
number (double) |
Il prezzo associato a questo articolo. |
| proratedPrice |
number (double) |
Il prezzo proporzionale per il prezzo della linea di trasferimento. |