Billing Subscriptions - Validate Transfer

Service:

Billing

API Version:

2019-10-01-preview

Ověří, jestli je možné přesunout poplatky za předplatné do nového oddílu faktury. Tato operace se podporuje jenom u produktů zakoupených s opakovanými poplatky a u fakturačních účtů s typem smlouvy Smlouva se zákazníkem Microsoftu.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
billingAccountName	path	True	string	ID, které jednoznačně identifikuje fakturační účet.
billingProfileName	path	True	string	ID, které jednoznačně identifikuje fakturační profil.
billingSubscriptionName	path	True	string	ID, které jednoznačně identifikuje předplatné.
invoiceSectionName	path	True	string	ID, které jednoznačně identifikuje oddíl faktury.

Text požadavku

Name	Typ	Description
destinationBillingProfileId	string	ID cílového fakturačního profilu.
destinationInvoiceSectionId	string	ID cílového oddílu faktury.

Odpovědi

Name	Typ	Description
200 OK	ValidateSubscriptionTransferEligibilityResult	OK. Žádost byla úspěšná.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

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

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

SubscriptionTransferValidateFailure

SubscriptionTransferValidateSuccess

SubscriptionTransferValidateFailure

Sample Request

HTTP

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

{
  "destinationInvoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}",
  "destinationBillingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}"
}

Sample Response

Status code:

200

{
  "isTransferEligible": false,
  "errorDetails": {
    "code": "SubscriptionNotActive",
    "message": "Invoice Sections can only be changed for active subscriptions."
  }
}

SubscriptionTransferValidateSuccess

Sample Request

HTTP

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

{
  "destinationInvoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}",
  "destinationBillingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}"
}

Sample Response

Status code:

200

{
  "isTransferEligible": true
}

Definice

Name	Description
ErrorDetails	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uveden v chybové zprávě.
ErrorSubDetails
subscriptionTransferValidationErrorCode	Kód chyby pro ověření převodu produktu
TransferBillingSubscriptionRequestProperties	Vyžádejte si parametry pro převod fakturačního předplatného.
ValidateSubscriptionTransferEligibilityError	Podrobnosti o chybě ověření způsobilosti k převodu
ValidateSubscriptionTransferEligibilityResult	Výsledek ověření způsobilosti k převodu.

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby
details	ErrorSubDetails[]	Dílčí podrobnosti o chybě.
message	string	Chybová zpráva označující, proč operace selhala.
target	string	Cíl konkrétní chyby.

ErrorResponse

Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uveden v chybové zprávě.

Name	Typ	Description
error	ErrorDetails	Podrobnosti o chybě.

ErrorSubDetails

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.
target	string	Cíl konkrétní chyby.

subscriptionTransferValidationErrorCode

Kód chyby pro ověření převodu produktu

Name	Typ	Description
BillingAccountInactive	string
CrossBillingAccountNotAllowed	string
DestinationBillingProfileInactive	string
DestinationBillingProfileNotFound	string
DestinationBillingProfilePastDue	string
DestinationInvoiceSectionInactive	string
DestinationInvoiceSectionNotFound	string
InsufficientPermissionOnDestination	string
InsufficientPermissionOnSource	string
InvalidDestination	string
InvalidSource	string
MarketplaceNotEnabledOnDestination	string
NotAvailableForDestinationMarket	string
ProductInactive	string
ProductNotFound	string
ProductTypeNotSupported	string
SourceBillingProfilePastDue	string
SourceInvoiceSectionInactive	string
SubscriptionNotActive	string
SubscriptionTypeNotSupported	string

TransferBillingSubscriptionRequestProperties

Vyžádejte si parametry pro převod fakturačního předplatného.

Name	Typ	Description
destinationBillingProfileId	string	ID cílového fakturačního profilu.
destinationInvoiceSectionId	string	ID cílového oddílu faktury.

ValidateSubscriptionTransferEligibilityError

Podrobnosti o chybě ověření způsobilosti k převodu

Name	Typ	Description
code	subscriptionTransferValidationErrorCode	Kód chyby pro ověření převodu produktu
details	string	Podrobná chybová zpráva vysvětlující chybu
message	string	Chybová zpráva

ValidateSubscriptionTransferEligibilityResult

Výsledek ověření způsobilosti k převodu.

Name	Typ	Description
errorDetails	ValidateSubscriptionTransferEligibilityError	Podrobnosti o chybě ověření
isTransferEligible	boolean	Určuje, jestli má předplatné nárok na převod.