Billing Subscriptions - Transfer

Service:

Billing

API Version:

2019-10-01-preview

Move os encargos de uma assinatura para uma nova seção de fatura. A nova seção da fatura deve pertencer ao mesmo perfil de cobrança que a seção da fatura existente. Essa operação tem suporte apenas para produtos comprados com uma cobrança recorrente e para contas de cobrança com o tipo de contrato Contrato de Cliente da Microsoft.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
billingAccountName	path	True	string	A ID que identifica exclusivamente uma conta de cobrança.
billingProfileName	path	True	string	A ID que identifica exclusivamente um perfil de cobrança.
billingSubscriptionName	path	True	string	A ID que identifica exclusivamente uma assinatura.
invoiceSectionName	path	True	string	A ID que identifica exclusivamente uma seção de fatura.

Corpo da solicitação

Nome	Tipo	Description
destinationBillingProfileId	string	A ID do perfil de cobrança de destino.
destinationInvoiceSectionId	string	A ID da seção da fatura de destino.

Respostas

Nome	Tipo	Description
200 OK	TransferBillingSubscriptionResult	OK. A solicitação foi bem-sucedida.
202 Accepted		Aceita. A transferência de assinatura de cobrança está em andamento. Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Erro inesperado.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Definições

Nome	Description
ErrorDetails	Os detalhes do erro.
ErrorResponse	A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.
ErrorSubDetails
TransferBillingSubscriptionRequestProperties	Solicite parâmetros para transferir a assinatura de cobrança.
TransferBillingSubscriptionResult	Resultado da operação de assinatura de cobrança de transferência.

ErrorDetails

Os detalhes do erro.

Nome	Tipo	Description
code	string	Código do erro.
details	ErrorSubDetails[]	Os sub-detalhes do erro.
message	string	Mensagem de erro indicando por que a operação falhou.
target	string	O destino do erro específico.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Nome	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

ErrorSubDetails

Nome	Tipo	Description
code	string	Código do erro.
message	string	Mensagem de erro indicando por que a operação falhou.
target	string	O destino do erro específico.

TransferBillingSubscriptionRequestProperties

Solicite parâmetros para transferir a assinatura de cobrança.

Nome	Tipo	Description
destinationBillingProfileId	string	A ID do perfil de cobrança de destino.
destinationInvoiceSectionId	string	A ID da seção da fatura de destino.

TransferBillingSubscriptionResult

Resultado da operação de assinatura de cobrança de transferência.

Nome	Tipo	Description
properties.billingSubscriptionName	string	A ID da assinatura de cobrança de destino.