Transfers - Initiate

Référence

Service:: Billing

API Version:: 2019-10-01-preview

Envoie une demande à un utilisateur dans un autre compte de facturation pour transférer la propriété de facturation de ses abonnements. L’opération est prise en charge uniquement pour les comptes de facturation avec le type de contrat Contrat client Microsoft.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/initiateTransfer

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
billingAccountName	path	True	string	ID qui identifie de façon unique un compte de facturation.
billingProfileName	path	True	string	ID qui identifie de façon unique un profil de facturation.
invoiceSectionName	path	True	string	ID qui identifie de façon unique une section de facture.

Corps de la demande

Nom	Type	Description
properties.recipientEmailId	string	ID d’e-mail du destinataire auquel la demande de transfert est envoyée.
properties.resellerId	string	ID MPN facultatif du revendeur pour les demandes de transfert envoyées à partir d’un compte de facturation Contrat Partenaire Microsoft.

Réponses

Nom	Type	Description
200 OK	TransferDetails	Détails du transfert initié.
Other Status Codes	ErrorResponse	Erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

InitiateTransfer

Sample Request

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/initiateTransfer

{
  "properties": {
    "recipientEmailId": "user@contoso.com"
  }
}

Sample Response

Status code:: 200

{
  "properties": {
    "creationTime": "2018-10-10T17:32:28Z",
    "expirationTime": "2018-11-05T17:32:28Z",
    "billingAccountId": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}",
    "billingProfileId": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}",
    "invoiceSectionId": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}",
    "transferStatus": "Pending",
    "recipientEmailId": "user@contoso.com",
    "initiatorEmailId": "xyz@contoso.com",
    "lastModifiedTime": "2018-10-10T17:32:28Z"
  }
}

Définitions

Nom	Description
DetailedTransferStatus	Transfert détaillé status.
Error	Détails de l’erreur pour l’exécution du transfert.
ErrorDetails	Détails de l’erreur.
ErrorResponse	La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.
ErrorSubDetails
InitiateTransferRequest	Demander des paramètres pour lancer le transfert.
productTransferStatus	Transférer status.
productType	Type du produit transféré.
TransferDetails	Détails du transfert.
transferStatus	Transfert global status.

DetailedTransferStatus

Transfert détaillé status.

Nom	Type	Description
errorDetails	Error	Détails de l’erreur pour l’exécution du transfert.
productId	string	ID du produit transféré.
productType	productType	Type de produit transféré.
transferStatus	productTransferStatus	Transférer status.

Error

Détails de l’erreur pour l’exécution du transfert.

Nom	Type	Description
errorCode	string	Code d’erreur.
errorMessage	string	Message d’erreur.

ErrorDetails

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
details	ErrorSubDetails[]	Sous-détails de l’erreur.
message	string	Message d’erreur indiquant la raison de l’échec de l’opération.
target	string	Cible de l’erreur particulière.

ErrorResponse

La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur.

ErrorSubDetails

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant la raison de l’échec de l’opération.
target	string	Cible de l’erreur particulière.

InitiateTransferRequest

Demander des paramètres pour lancer le transfert.

Nom	Type	Description
properties.recipientEmailId	string	ID d’e-mail du destinataire auquel la demande de transfert est envoyée.
properties.resellerId	string	ID MPN facultatif du revendeur pour les demandes de transfert envoyées à partir d’un compte de facturation Contrat Partenaire Microsoft.

productTransferStatus

Transférer status.

Nom	Type	Description
Completed	string
Failed	string
InProgress	string
NotStarted	string

productType

Type du produit transféré.

Nom	Type	Description
AzureReservation	string
AzureSubscription	string

TransferDetails

Détails du transfert.

Nom	Type	Description
properties.billingAccountId	string	ID du compte de facturation auquel le produit est facturé une fois la demande de transfert terminée.
properties.billingProfileId	string	ID du profil de facturation auquel le produit sera facturé après le transfert.
properties.canceledBy	string	ID d’e-mail de l’utilisateur qui a annulé la demande de transfert.
properties.creationTime	string	Heure à laquelle la demande de transfert a été créée.
properties.detailedTransferStatus	DetailedTransferStatus[]	Transfert détaillé status.
properties.expirationTime	string	Heure à laquelle la demande de transfert expire.
properties.initiatorCustomerType	string	Type de client qui a envoyé la demande de transfert.
properties.initiatorEmailId	string	ID d’e-mail de l’utilisateur qui a envoyé la demande de transfert.
properties.invoiceSectionId	string	ID de la section de facture à laquelle le produit est facturé une fois la demande de transfert terminée.
properties.lastModifiedTime	string	Heure de la dernière modification de la demande de transfert.
properties.recipientEmailId	string	ID d’e-mail de l’utilisateur auquel la demande de transfert a été envoyée.
properties.resellerId	string	ID MPN facultatif du revendeur pour les demandes de transfert envoyées à partir d’un compte de facturation Contrat Partenaire Microsoft.
properties.resellerName	string	Nom facultatif du revendeur pour les demandes de transfert envoyées à partir de Contrat Partenaire Microsoft compte de facturation.
properties.transferStatus	transferStatus	Transfert global status.

transferStatus

Transfert global status.

Nom	Type	Description
Canceled	string
Completed	string
CompletedWithErrors	string
Declined	string
Failed	string
InProgress	string
Pending	string

Share via