Billing Subscriptions - Transfer

Service:

Billing

API Version:

2019-10-01-preview

Mueve los cargos de una suscripción a una nueva sección de factura. La nueva sección de factura debe pertenecer al mismo perfil de facturación que la sección de factura existente. Esta operación solo se admite para los productos que se compran con un cargo periódico y para las cuentas de facturación con tipo de contrato Contrato de cliente de Microsoft.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
billingAccountName	path	True	string	Identificador que identifica de forma única una cuenta de facturación.
billingProfileName	path	True	string	Identificador que identifica de forma única un perfil de facturación.
billingSubscriptionName	path	True	string	Identificador que identifica de forma única una suscripción.
invoiceSectionName	path	True	string	Identificador que identifica de forma única una sección de factura.

Cuerpo de la solicitud

Nombre	Tipo	Description
destinationBillingProfileId	string	Identificador del perfil de facturación de destino.
destinationInvoiceSectionId	string	Identificador de la sección de factura de destino.

Respuestas

Nombre	Tipo	Description
200 OK	TransferBillingSubscriptionResult	Aceptar. La solicitud se ha realizado correctamente.
202 Accepted		Accepted. La transferencia de la suscripción de facturación está en curso. Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	error inesperado.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

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

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

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

Definiciones

Nombre	Description
ErrorDetails	Detalles del error.
ErrorResponse	La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.
ErrorSubDetails
TransferBillingSubscriptionRequestProperties	Solicite parámetros para transferir la suscripción de facturación.
TransferBillingSubscriptionResult	Resultado de la operación de suscripción de facturación de transferencia.

ErrorDetails

Detalles del error.

Nombre	Tipo	Description
code	string	Código de error.
details	ErrorSubDetails[]	Los subdelementos del error.
message	string	Mensaje de error que indica por qué se produjo un error en la operación.
target	string	Destino del error concreto.

ErrorResponse

La respuesta de error indica que el servicio no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.

Nombre	Tipo	Description
error	ErrorDetails	Detalles del error.

ErrorSubDetails

Nombre	Tipo	Description
code	string	Código de error.
message	string	Mensaje de error que indica por qué se produjo un error en la operación.
target	string	Destino del error concreto.

TransferBillingSubscriptionRequestProperties

Solicite parámetros para transferir la suscripción de facturación.

Nombre	Tipo	Description
destinationBillingProfileId	string	Identificador del perfil de facturación de destino.
destinationInvoiceSectionId	string	Identificador de la sección de factura de destino.

TransferBillingSubscriptionResult

Resultado de la operación de suscripción de facturación de transferencia.

Nombre	Tipo	Description
properties.billingSubscriptionName	string	Identificador de la suscripción de facturación de destino.