Manage orders - Create a transfer
Crée une entité de transfert.
POST https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/transfers
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
Identificateur du client. |
|
version
|
path | True |
string |
Le numéro de version de l’API. |
En-tête de la demande
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| Authorization | True |
string |
Jeton du porteur d’autorisation |
| ms-correlationid |
string |
Utilisé pour le suivi des demandes en interne. Si un ms-correlationid n’est pas fourni, le serveur en génère un nouveau pour chaque requête |
|
| ms-cv |
string |
Utilisé pour le suivi des demandes en interne. Si un ms-cv n’est pas fourni, le serveur en génère un nouveau pour chaque requête |
|
| ms-requestid |
string |
Utilisé pour l’idempotency des requêtes. Si un ms-requestid n’est pas fourni, le serveur en génère un nouveau pour chaque requête |
Corps de la demande
Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"
| Nom | Type | Description |
|---|---|---|
| alternateId |
string |
Identifiant alternatif pour l’entité de transfert. La valeur est généralement un GUID. |
| attributes |
Attributs supplémentaires associés à l’entité de transfert. |
|
| completedTime |
string (date-time) |
Le temps complété pour l’entité de transfert. Utilise le format date-heure ISO 8601. |
| createdTime |
string (date-time) |
La date et l’heure de création de l’entité de transfert, au format ISO 8601. Utilise le format date-heure ISO 8601. |
| customerEmailId |
string |
L’identifiant unique de l’adresse e-mail du client. La valeur est généralement un GUID. |
| customerName |
string |
Le nom du client pour l’entité de transfert. |
| customerTenantId |
string |
L’identifiant unique du locataire client. La valeur est généralement un GUID. |
| expirationTime |
string (date-time) |
La date d’expiration de l’entité transférée. Utilise le format date-heure ISO 8601. |
| id |
string |
Identifiant unique pour l’entité transférée. La valeur est généralement un GUID. |
| ignoreEligibilityCheck |
boolean |
Si cette entité de transfert ignore la vérification d’éligibilité. |
| lastModifiedTime |
string (date-time) |
Le dernier temps modifié pour l’entité de transfert. Utilise le format date-heure ISO 8601. |
| lastModifiedUser |
string |
L’utilisateur qui a modifié en dernier l’entité de transfert. |
| lineItems |
La collection des lignes associées à cette entité de transfert. |
|
| links |
Liens vers des ressources associées. |
|
| participants |
Les participants associés à cet article. |
|
| partnerOnRecord |
string |
Le partenaire enregistré pour l’entité de transfert. |
| partnertenantid |
string |
L’identifiant unique de l’entité transférée. La valeur est généralement un GUID. |
| sourcePartnerEmailId |
string |
L’identifiant unique de l’adresse e-mail du partenaire source. La valeur est généralement un GUID. |
| sourcePartnerName |
string |
Le nom du partenaire source pour l’entité de transfert. |
| sourcePartnerTenantId |
string |
L’identifiant unique du locataire partenaire source. La valeur est généralement un GUID. |
| status |
string |
Statut actuel de l’entité de transfert. |
| targetPartnerEmailId |
string |
L’identifiant unique de l’adresse e-mail du partenaire cible. La valeur est généralement un GUID. |
| targetPartnerName |
string |
Le nom du partenaire cible pour l’entité transférée. |
| targetPartnerTenantId |
string |
L’identifiant unique du locataire partenaire cible. La valeur est généralement un GUID. |
| targetProductTypes |
string[] |
L’ensemble des types de produits cibles associés à cette entité de transfert. |
| transferDirection |
enum:
|
La direction de transfert pour l’entité de transfert. Les valeurs possibles incluent : 0, 1, 2. |
| transferType |
enum:
|
Le type de transfert, envoyé en entier. Les valeurs possibles incluent : 0 (Inconnu), 1 (EaToCsp), 2 (DirectToIndirect), 3 (ModernAzure), 4 (PartnerToPartner), 5 (NewCommerce). |
Réponses
| Nom | Type | Description |
|---|---|---|
| 201 Created |
La demande a réussi. Le corps de la réponse contient les informations de transfert. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 400 Bad Request |
Une entrée est manquante ou non valide. Le corps de la réponse fournit les détails de l’erreur. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
La demande n’a pas été authentifiée. Le client doit d’abord s’authentifier auprès du service d’API partenaire. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
La demande a été authentifiée, mais a été refusée, car l’appelant n’a pas les droits de l’appeler. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
La ressource est introuvable ou non disponible avec les paramètres d’entrée donnés. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
Le service d’API partenaire ou l’une de ses dépendances n’a pas pu répondre à la demande. Les appelants peuvent réessayer. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Définitions
| Nom | Description |
|---|---|
|
Last |
Représente la dernière ressource connue pour les détails de facturation. |
|
Last |
Représente une dernière ressource connue pour la période de facturation. |
| Link |
Représente une ressource de lien. |
|
Resource |
Représente une ressource d’attributs de ressource. |
|
Resource |
Représente une ressource de liens de ressources. |
|
String |
Représente une ressource de paires clés-valeurs. |
|
Transfer |
Représente une ressource d’entité de transfert. |
|
Transfer |
Représente le type d’élément transféré, envoyé en entier. Les valeurs possibles incluent : 0 (AzureSubscription), 1 (AzureReservation), 2 (ModernAzureSubscription), 3 (LegacyAzureSubscription), 4 (AzureSavingsPlan), 5 (OnlineServicesNCE), 6 (Logiciel), 7 (SaaS). |
|
Transfer |
Représente une ressource de ligne de transfert. |
|
Transfer |
Représente une ressource d’erreur de ligne de transfert. |
|
Transfer |
Représente une ressource de prix de ligne de transfert. |
LastKnownBillingDetails
Représente la dernière ressource connue pour les détails de facturation.
| Nom | Type | Description |
|---|---|---|
| billingAmount |
number (double) |
Le montant de facturation pour les derniers détails de facturation connus. |
| billingCycle |
enum:
|
Fréquence de facturation. Les valeurs possibles incluent : « inconnu », « mensuel », « annuel », « aucun, » « one_time ». |
| billingPeriod |
Période de facturation supplémentaire associée aux derniers détails de facturation connus. |
|
| billingType |
enum:
|
Le type de facturation pour les derniers détails de facturation connus. Les valeurs possibles incluent : « aucune », « utilisation », « licence ». |
| currency |
string |
Le code de devise ISO à trois lettres. |
LastKnownBillingPeriod
Représente une dernière ressource connue pour la période de facturation.
| Nom | Type | Description |
|---|---|---|
| endDate |
string (date-time) |
La date de fin de cet enregistrement, au format ISO 8601. Utilise le format date-heure ISO 8601. |
| startDate |
string (date-time) |
La date de début de cet enregistrement, au format ISO 8601. Utilise le format date-heure ISO 8601. |
Link
Représente une ressource de lien.
| Nom | Type | Description |
|---|---|---|
| body |
string |
Le corps pour le lien. |
| headers |
La collection d’en-têtes associée à ce lien. |
|
| method |
string |
La méthode du lien. |
| uri |
string |
L’URI de la ressource associée. |
ResourceAttributes
Représente une ressource d’attributs de ressource.
| Nom | Type | Description |
|---|---|---|
| etag |
string |
L’entité utilisée pour le contrôle de la concurrence. |
| objectType |
string |
Le type d’objet pour les attributs de ressource. |
ResourceLinks
Représente une ressource de liens de ressources.
| Nom | Type | Description |
|---|---|---|
| next |
Ajout supplémentaire aux liens de ressources. |
|
| previous |
Des liens supplémentaires liés aux ressources de liens. |
|
| self |
Autre auto-association avec les liens de ressources. |
StringStringKeyValuePair
Représente une ressource de paires clés-valeurs.
| Nom | Type | Description |
|---|---|---|
| key |
string |
La clé pour la paire clé-valeur. |
| value |
string |
La valeur de la paire clé-valeur. |
TransferEntity
Représente une ressource d’entité de transfert.
| Nom | Type | Description |
|---|---|---|
| alternateId |
string |
Identifiant alternatif pour l’entité de transfert. La valeur est généralement un GUID. |
| attributes |
Attributs supplémentaires associés à l’entité de transfert. |
|
| completedTime |
string (date-time) |
Le temps complété pour l’entité de transfert. Utilise le format date-heure ISO 8601. |
| createdTime |
string (date-time) |
La date et l’heure de création de l’entité de transfert, au format ISO 8601. Utilise le format date-heure ISO 8601. |
| customerEmailId |
string |
L’identifiant unique de l’adresse e-mail du client. La valeur est généralement un GUID. |
| customerName |
string |
Le nom du client pour l’entité de transfert. |
| customerTenantId |
string |
L’identifiant unique du locataire client. La valeur est généralement un GUID. |
| expirationTime |
string (date-time) |
La date d’expiration de l’entité transférée. Utilise le format date-heure ISO 8601. |
| id |
string |
Identifiant unique pour l’entité transférée. La valeur est généralement un GUID. |
| ignoreEligibilityCheck |
boolean |
Si cette entité de transfert ignore la vérification d’éligibilité. |
| lastModifiedTime |
string (date-time) |
Le dernier temps modifié pour l’entité de transfert. Utilise le format date-heure ISO 8601. |
| lastModifiedUser |
string |
L’utilisateur qui a modifié en dernier l’entité de transfert. |
| lineItems |
La collection des lignes associées à cette entité de transfert. |
|
| links |
Liens vers des ressources associées. |
|
| participants |
Les participants associés à cet article. |
|
| partnerOnRecord |
string |
Le partenaire enregistré pour l’entité de transfert. |
| partnertenantid |
string |
L’identifiant unique de l’entité transférée. La valeur est généralement un GUID. |
| sourcePartnerEmailId |
string |
L’identifiant unique de l’adresse e-mail du partenaire source. La valeur est généralement un GUID. |
| sourcePartnerName |
string |
Le nom du partenaire source pour l’entité de transfert. |
| sourcePartnerTenantId |
string |
L’identifiant unique du locataire partenaire source. La valeur est généralement un GUID. |
| status |
string |
Statut actuel de l’entité de transfert. |
| targetPartnerEmailId |
string |
L’identifiant unique de l’adresse e-mail du partenaire cible. La valeur est généralement un GUID. |
| targetPartnerName |
string |
Le nom du partenaire cible pour l’entité transférée. |
| targetPartnerTenantId |
string |
L’identifiant unique du locataire partenaire cible. La valeur est généralement un GUID. |
| targetProductTypes |
string[] |
L’ensemble des types de produits cibles associés à cette entité de transfert. |
| transferDirection |
enum:
|
La direction de transfert pour l’entité de transfert. Les valeurs possibles incluent : 0, 1, 2. |
| transferType |
enum:
|
Le type de transfert, envoyé en entier. Les valeurs possibles incluent : 0 (Inconnu), 1 (EaToCsp), 2 (DirectToIndirect), 3 (ModernAzure), 4 (PartnerToPartner), 5 (NewCommerce). |
TransferItemType
Représente le type d’élément transféré, envoyé en entier. Les valeurs possibles incluent : 0 (AzureSubscription), 1 (AzureReservation), 2 (ModernAzureSubscription), 3 (LegacyAzureSubscription), 4 (AzureSavingsPlan), 5 (OnlineServicesNCE), 6 (Logiciel), 7 (SaaS).
| Valeur | Description |
|---|---|
| 0 | |
| 1 | |
| 2 | |
| 3 | |
| 4 | |
| 5 | |
| 6 | |
| 7 |
TransferLineItem
Représente une ressource de ligne de transfert.
| Nom | Type | Description |
|---|---|---|
| addonItems |
La collection d’éléments additionnels associés à cette ligne de transfert. |
|
| billingCycle |
enum:
|
Fréquence de facturation. Les valeurs possibles incluent : « inconnu », « mensuel », « annuel », « aucun, » « one_time ». |
| billingDetails |
Détails de facturation supplémentaires associés à la ligne de transfert. |
|
| currencyCode |
string |
Le code de devise ISO à trois lettres. |
| errors |
L’ensemble des erreurs associées à cette ligne de transfert. |
|
| friendlyName |
string |
Un nom d’affichage amical pour cet article. |
| id |
integer (int32) |
Identifiant unique pour la ligne de transfert. |
| offerId |
string |
L’identifiant unique de l’offre. La valeur est généralement un GUID. |
| orderId |
string |
Identificateur unique de la commande. La valeur est généralement un GUID. |
| partnerIdOnRecord |
string |
L’identifiant du partenaire enregistré pour la ligne de transfert. |
| price |
Le prix associé à cet article. |
|
| productType |
Transfer |
Type de produit supplémentaire associé à la ligne de transfert. |
| quantity |
integer (int32) |
Nombre d’unités. |
| sourceSubscriptionTermEndDate |
string (date-time) |
La date et l’heure de la fin de l’abonnement source, dans UTC. |
| sourceSubscriptionTermStartDate |
string (date-time) |
La date de début de la durée d’abonnement source, au format ISO 8601. Utilise le format date-heure ISO 8601. |
| status |
string |
Le statut actuel de la ligne de transfert. |
| subscriptionId |
string |
L’identifiant unique (GUID) de l’abonnement. La valeur est généralement un GUID. |
| transferError |
string |
L’erreur de transfert pour la ligne de transfert. |
| transferGroupId |
string |
L’identifiant unique du groupe de transfert. La valeur est généralement un GUID. |
TransferLineItemError
Représente une ressource d’erreur de ligne de transfert.
| Nom | Type | Description |
|---|---|---|
| code |
string |
Le code de l’erreur de ligne de transfert. |
| description |
string |
La description de cet objet. |
TransferLineItemPrice
Représente une ressource de prix de ligne de transfert.
| Nom | Type | Description |
|---|---|---|
| currencyCode |
string |
Le code de devise ISO à trois lettres. |
| discountedPrice |
number (double) |
Le prix réduit pour le prix de la ligne de transfert de ligne. |
| erpPrice |
number (double) |
Le prix de détail estimé (ERP). La quantité unique estimée au prix de détail indiquée dans le catalogue avant que tout modificateur de prix ne soit appliqué, dans la devise de la ligne. C’est le prix de détail à terme complet lorsqu’une durée de disponibilité est spécifiée. Le montant est avant impôt, sauf dans les pays ou régions à imposition inclusive où le prix inclut la taxe. Cette propriété est actuellement en cours de déploiement et n’est pas restituée à tous les partenaires. |
| extendedPrice |
number (double) |
Le prix prolongé pour le prix de la ligne de transfert. |
| listPrice |
number (double) |
Le prix affiché avant l’application des réductions. |
| price |
number (double) |
Le prix associé à cet article. |
| proratedPrice |
number (double) |
Le prix prorata pour le prix de la ligne de transfert. |