Billing Subscriptions - 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}/transfer

Параметры URI

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

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

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

Ответы

Имя	Тип	Описание
200 OK	TransferBillingSubscriptionResult	Все в порядке. Запрос выполнен успешно.
202 Accepted		Принято. Выполняется передача подписки на выставление счетов. Headers Location: string Retry-After: integer
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	олицетворения учетной записи пользователя

Примеры

TransferBillingSubscription

Sample Request

HTTP

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

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

Sample Response

Status code:

200

{
  "properties": {
    "billingSubscriptionName": "Test subscription"
  }
}

Status code:

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingSubscriptions/{billingSubscriptionName}/transfer/operationResults/10000000-0000-0000-0000-000000000001?api-version=2019-10-01-preview
Retry-After: 30

Определения

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

ErrorDetails

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

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

ErrorResponse

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

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

ErrorSubDetails

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

TransferBillingSubscriptionRequestProperties

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

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

TransferBillingSubscriptionResult

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

Имя	Тип	Описание
properties.billingSubscriptionName	string	Идентификатор целевой подписки выставления счетов.