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

ResourceAttributes

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

TransferLineItem[]

La collection des lignes associées à cette entité de transfert.

links

ResourceLinks

Liens vers des ressources associées.

participants

StringStringKeyValuePair[]

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:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)

La direction de transfert pour l’entité de transfert. Les valeurs possibles incluent : 0, 1, 2.

transferType enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)
  • 3 (int32)
  • 4 (int32)
  • 5 (int32)

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

TransferEntity

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
LastKnownBillingDetails

Représente la dernière ressource connue pour les détails de facturation.

LastKnownBillingPeriod

Représente une dernière ressource connue pour la période de facturation.

Link

Représente une ressource de lien.

ResourceAttributes

Représente une ressource d’attributs de ressource.

ResourceLinks

Représente une ressource de liens de ressources.

StringStringKeyValuePair

Représente une ressource de paires clés-valeurs.

TransferEntity

Représente une ressource d’entité de transfert.

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).

TransferLineItem

Représente une ressource de ligne de transfert.

TransferLineItemError

Représente une ressource d’erreur de ligne de transfert.

TransferLineItemPrice

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:
  • annual
  • monthly
  • none
  • one_time
  • unknown

Fréquence de facturation. Les valeurs possibles incluent : « inconnu », « mensuel », « annuel », « aucun, » « one_time ».

billingPeriod

LastKnownBillingPeriod

Période de facturation supplémentaire associée aux derniers détails de facturation connus.

billingType enum:
  • license
  • none
  • usage

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.

Représente une ressource de lien.

Nom Type Description
body

string

Le corps pour le lien.

headers

StringStringKeyValuePair[]

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.

Représente une ressource de liens de ressources.

Nom Type Description
next

Link

Ajout supplémentaire aux liens de ressources.

previous

Link

Des liens supplémentaires liés aux ressources de liens.

self

Link

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

ResourceAttributes

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

TransferLineItem[]

La collection des lignes associées à cette entité de transfert.

links

ResourceLinks

Liens vers des ressources associées.

participants

StringStringKeyValuePair[]

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:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)

La direction de transfert pour l’entité de transfert. Les valeurs possibles incluent : 0, 1, 2.

transferType enum:
  • 0 (int32)
  • 1 (int32)
  • 2 (int32)
  • 3 (int32)
  • 4 (int32)
  • 5 (int32)

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

TransferLineItem[]

La collection d’éléments additionnels associés à cette ligne de transfert.

billingCycle enum:
  • annual
  • monthly
  • none
  • one_time
  • unknown

Fréquence de facturation. Les valeurs possibles incluent : « inconnu », « mensuel », « annuel », « aucun, » « one_time ».

billingDetails

LastKnownBillingDetails

Détails de facturation supplémentaires associés à la ligne de transfert.

currencyCode

string

Le code de devise ISO à trois lettres.

errors

TransferLineItemError[]

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

TransferLineItemPrice

Le prix associé à cet article.

productType

TransferItemType (int32)

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.