Billing Subscriptions - Validate Transfer

Service:

Billing

API Version:

2019-10-01-preview

Проверяет, можно ли переместить расходы на подписку в новый раздел счета. Эта операция поддерживается только для продуктов, приобретенных с регулярной оплатой, и для учетных записей выставления счетов с типом соглашения Клиентское соглашение Майкрософт.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
billingAccountName	path	True	string	Идентификатор, однозначно определяющий учетную запись выставления счетов.
billingProfileName	path	True	string	Идентификатор, однозначно определяющий профиль выставления счетов.
billingSubscriptionName	path	True	string	Идентификатор, который однозначно идентифицирует подписку.
invoiceSectionName	path	True	string	Идентификатор, однозначно определяющий раздел счета.

Текст запроса

Имя	Тип	Описание
destinationBillingProfileId	string	Идентификатор профиля выставления счетов назначения.
destinationInvoiceSectionId	string	Идентификатор раздела целевого счета.

Ответы

Имя	Тип	Описание
200 OK	ValidateSubscriptionTransferEligibilityResult	Все в порядке. Запрос выполнен успешно.
Other Status Codes	ErrorResponse	Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Scopes

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

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
}

Определения

Имя	Описание
ErrorDetails	Сведения об ошибке.
ErrorResponse	Ответ об ошибке указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке.
ErrorSubDetails
subscriptionTransferValidationErrorCode	Код ошибки для проверки передачи продукта.
TransferBillingSubscriptionRequestProperties	Запрос параметров для передачи подписки на выставление счетов.
ValidateSubscriptionTransferEligibilityError	Сведения об ошибке при проверке соответствия требованиям для передачи
ValidateSubscriptionTransferEligibilityResult	Результат проверки соответствия требованиям для передачи.

ErrorDetails

Сведения об ошибке.

Имя	Тип	Описание
code	string	Код ошибки.
details	ErrorSubDetails[]	Дополнительные сведения об ошибке.
message	string	Сообщение об ошибке, указывающее, почему операция завершилась сбоем.
target	string	Целевой объект конкретной ошибки.

ErrorResponse

Ответ об ошибке указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке.

Имя	Тип	Описание
error	ErrorDetails	Сведения об ошибке.

ErrorSubDetails

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке, указывающее, почему операция завершилась сбоем.
target	string	Целевой объект конкретной ошибки.

subscriptionTransferValidationErrorCode

Код ошибки для проверки передачи продукта.

Имя	Тип	Описание
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

Запрос параметров для передачи подписки на выставление счетов.

Имя	Тип	Описание
destinationBillingProfileId	string	Идентификатор профиля выставления счетов назначения.
destinationInvoiceSectionId	string	Идентификатор раздела целевого счета.

ValidateSubscriptionTransferEligibilityError

Сведения об ошибке при проверке соответствия требованиям для передачи

Имя	Тип	Описание
code	subscriptionTransferValidationErrorCode	Код ошибки для проверки передачи продукта.
details	string	Подробное сообщение об ошибке, объясняющее ошибку.
message	string	Сообщение об ошибке.

ValidateSubscriptionTransferEligibilityResult

Результат проверки соответствия требованиям для передачи.

Имя	Тип	Описание
errorDetails	ValidateSubscriptionTransferEligibilityError	Сведения об ошибке проверки.
isTransferEligible	boolean	Указывает, допускается ли перенос подписки.