Billing Subscriptions - Validate Transfer

Service:

Billing

API Version:

2019-10-01-preview

Verifierar om en prenumerations avgifter kan flyttas till ett nytt fakturaavsnitt. Den här åtgärden stöds endast för produkter som köps med en återkommande avgift och för faktureringskonton med avtalstyp Microsoft-kundavtal.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
billingAccountName	path	True	string	Det ID som unikt identifierar ett faktureringskonto.
billingProfileName	path	True	string	Det ID som unikt identifierar en faktureringsprofil.
billingSubscriptionName	path	True	string	Det ID som unikt identifierar en prenumeration.
invoiceSectionName	path	True	string	Det ID som unikt identifierar ett fakturaavsnitt.

Begärandetext

Name	Typ	Description
destinationBillingProfileId	string	Målfaktureringsprofilens ID.
destinationInvoiceSectionId	string	Målfakturaavsnittets ID.

Svar

Name	Typ	Description
200 OK	ValidateSubscriptionTransferEligibilityResult	OK. Begäran har slutförts.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

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
}

Definitioner

Name	Description
ErrorDetails	Information om felet.
ErrorResponse	Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.
ErrorSubDetails
subscriptionTransferValidationErrorCode	Felkod för valideringen av produktöverföringen.
TransferBillingSubscriptionRequestProperties	Begär parametrar för att överföra faktureringsprenumeration.
ValidateSubscriptionTransferEligibilityError	Felinformation om verifiering av överföringsberättigande
ValidateSubscriptionTransferEligibilityResult	Resultatet av valideringen av överföringsberättigande.

ErrorDetails

Information om felet.

Name	Typ	Description
code	string	Felkod.
details	ErrorSubDetails[]	Underinformationen om felet.
message	string	Felmeddelande som anger varför åtgärden misslyckades.
target	string	Målet för det specifika felet.

ErrorResponse

Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Name	Typ	Description
error	ErrorDetails	Information om felet.

ErrorSubDetails

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.
target	string	Målet för det specifika felet.

subscriptionTransferValidationErrorCode

Felkod för valideringen av produktöverföringen.

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

Begär parametrar för att överföra faktureringsprenumeration.

Name	Typ	Description
destinationBillingProfileId	string	Målfaktureringsprofilens ID.
destinationInvoiceSectionId	string	Målfakturaavsnittets ID.

ValidateSubscriptionTransferEligibilityError

Felinformation om verifiering av överföringsberättigande

Name	Typ	Description
code	subscriptionTransferValidationErrorCode	Felkod för valideringen av produktöverföringen.
details	string	Detaljerat felmeddelande som förklarar felet.
message	string	Felmeddelandet.

ValidateSubscriptionTransferEligibilityResult

Resultatet av valideringen av överföringsberättigande.

Name	Typ	Description
errorDetails	ValidateSubscriptionTransferEligibilityError	Information om verifieringsfel.
isTransferEligible	boolean	Anger om prenumerationen är berättigad att överföras.