Billing Subscriptions - Validate Transfer

Service:

Billing

API Version:

2019-10-01-preview

Aboneliğin ücretlerinin yeni bir fatura bölümüne taşınıp taşınamadığını doğrular. Bu işlem yalnızca yinelenen ücretle satın alınan ürünler ve sözleşme türü Microsoft Müşteri Sözleşmesi olan ödeme hesapları için desteklenir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
billingAccountName	path	True	string	Bir ödeme hesabını benzersiz olarak tanımlayan kimlik.
billingProfileName	path	True	string	Faturalama profilini benzersiz olarak tanımlayan kimlik.
billingSubscriptionName	path	True	string	Aboneliği benzersiz olarak tanımlayan kimlik.
invoiceSectionName	path	True	string	Bir fatura bölümünü benzersiz olarak tanımlayan kimlik.

İstek Gövdesi

Name	Tür	Description
destinationBillingProfileId	string	Hedef faturalama profili kimliği.
destinationInvoiceSectionId	string	Hedef fatura bölümü kimliği.

Yanıtlar

Name	Tür	Description
200 OK	ValidateSubscriptionTransferEligibilityResult	Tamam ögesini seçin. İstek başarılı oldu.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

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	kullanıcı hesabınızın kimliğine bürünme

Örnekler

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
}

Tanımlar

Name	Description
ErrorDetails	Hatanın ayrıntıları.
ErrorResponse	Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir.
ErrorSubDetails
subscriptionTransferValidationErrorCode	Ürün aktarımı doğrulaması için hata kodu.
TransferBillingSubscriptionRequestProperties	Faturalama aboneliğini aktarmak için parametreler isteyin.
ValidateSubscriptionTransferEligibilityError	Aktarım uygunluğu doğrulamasının hata ayrıntıları
ValidateSubscriptionTransferEligibilityResult	Aktarım uygunluğu doğrulamasının sonucu.

ErrorDetails

Hatanın ayrıntıları.

Name	Tür	Description
code	string	Hata kodu.
details	ErrorSubDetails[]	Hatanın alt ayrıntıları.
message	string	İşlemin neden başarısız olduğunu belirten hata iletisi.
target	string	Belirli bir hatanın hedefi.

ErrorResponse

Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir.

Name	Tür	Description
error	ErrorDetails	Hatanın ayrıntıları.

ErrorSubDetails

Name	Tür	Description
code	string	Hata kodu.
message	string	İşlemin neden başarısız olduğunu belirten hata iletisi.
target	string	Belirli bir hatanın hedefi.

subscriptionTransferValidationErrorCode

Ürün aktarımı doğrulaması için hata kodu.

Name	Tür	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

Faturalama aboneliğini aktarmak için parametreler isteyin.

Name	Tür	Description
destinationBillingProfileId	string	Hedef faturalama profili kimliği.
destinationInvoiceSectionId	string	Hedef fatura bölümü kimliği.

ValidateSubscriptionTransferEligibilityError

Aktarım uygunluğu doğrulamasının hata ayrıntıları

Name	Tür	Description
code	subscriptionTransferValidationErrorCode	Ürün aktarımı doğrulaması için hata kodu.
details	string	Hatayı açıklayan ayrıntılı hata iletisi.
message	string	Hata iletisi.

ValidateSubscriptionTransferEligibilityResult

Aktarım uygunluğu doğrulamasının sonucu.

Name	Tür	Description
errorDetails	ValidateSubscriptionTransferEligibilityError	Doğrulama hatası ayrıntıları.
isTransferEligible	boolean	Aboneliğin aktarılmaya uygun olup olmadığını belirtir.