Billing Subscriptions - Merge
Combina la suscripción de facturación proporcionada en la solicitud con una suscripción de facturación de destino.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/{billingSubscriptionName}/merge?api-version=2024-04-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
billing
|
path | True |
string |
Identificador que identifica de forma única una cuenta de facturación. |
billing
|
path | True |
string |
Identificador que identifica de forma única una suscripción. |
api-version
|
query | True |
string |
Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2024-04-01. |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
quantity |
integer |
Cantidad de la suscripción de facturación de origen que se combinará con la suscripción de facturación de destino. |
targetBillingSubscriptionName |
string |
Identificador de la suscripción de facturación de destino que se combinará con la suscripción de origen proporcionada en la solicitud. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Propiedades de facturación de una suscripción. |
|
202 Accepted |
Resultado aceptado por una operación que devuelve un encabezado "Location" que el cliente puede sondear para ver el resultado de la operación. Encabezados
|
|
Other Status Codes |
Respuesta de error que describe por qué se produjo un error en la operación. |
Ejemplos
BillingSubscriptionsMerge
Solicitud de ejemplo
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingSubscriptions/11111111-1111-1111-1111-111111111111/merge?api-version=2024-04-01
{
"targetBillingSubscriptionName": "22222222-2222-2222-2222-222222222222",
"quantity": 1
}
Respuesta de muestra
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingSubscriptions/22222222-2222-2222-2222-222222222222",
"name": "22222222-2222-2222-2222-222222222222",
"properties": {
"autoRenew": "On",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx",
"billingProfileDisplayName": "Billing Profile Display Name",
"billingProfileName": "xxxx-xxxx-xxx-xxx",
"displayName": "Billing Subscription Display Name",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/billingProfiles/xxxx-xxxx-xxx-xxx/invoiceSections/yyyy-yyyy-yyy-yyy",
"invoiceSectionDisplayName": "Invoice Section Display Name",
"invoiceSectionName": "yyyy-yyyy-yyy-yyy",
"productCategory": "SeatBased",
"productType": "Seat-Based Product Type",
"productTypeId": "XYZ56789",
"purchaseDate": "2023-01-05T22:39:34.2606750Z",
"quantity": 2,
"skuId": "0001",
"skuDescription": "SKU Description",
"systemOverrides": {
"cancellationAllowedEndDate": "2023-02-01T22:39:34.2606750Z"
},
"termDuration": "P1M",
"termStartDate": "2023-01-05T22:39:34.2606750Z",
"termEndDate": "2023-02-05T22:39:34.2606750Z",
"status": "Active"
},
"type": "Microsoft.Billing/billingAccounts/billingSubscriptions",
"systemData": {
"createdAt": "2023-01-05T22:39:34.2606750Z",
"lastModifiedAt": "2023-01-25T22:39:34.2606750Z"
}
}
location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2019-05-31/operationResults/splitBillingSubscription_11111111-1111-1111-1111-111111111111:22222222-2222-2222-2222-222222222222?api-version=2024-04-01
retry-after: 10
Definiciones
Nombre | Description |
---|---|
Amount |
Cantidad. |
Auto |
Indica si la renovación automática está activada o desactivada para un producto. |
Beneficiary |
Detalles del beneficiario. |
Billing |
Propiedades de facturación de una suscripción. |
Billing |
Parámetros de solicitud que se proporcionan para combinar las dos suscripciones de facturación. |
Billing |
Estado de una operación en la suscripción. Cuando Ninguno, no hay ninguna operación en curso. Cuando LockedForUpdate, las operaciones de escritura se bloquearán en la suscripción de facturación. Otro es el valor predeterminado y es posible que tenga que consultar la versión más reciente de la API para obtener más detalles. |
Billing |
Estado de la suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise |
Billing |
Los detalles de la suspensión de una suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise. |
Cancellation |
La invalidación de directiva de la suscripción indica si se permite la cancelación de autoservicio o la reducción de puestos. |
created |
Tipo de identidad que creó el recurso. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Next |
Detalles del ciclo de facturación del producto. |
Provisioning |
Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada. |
Renewal |
Detalles del siguiente período de renovación de una suscripción. |
Reseller |
Detalles del revendedor. |
Subscription |
Estado de la cuenta de inscripción actual de la suscripción. Este campo solo está disponible para el tipo de contrato Enterprise. |
Subscription |
Motivo de suspensión de una suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise. |
system |
Metadatos relativos a la creación y última modificación del recurso. |
System |
Las directivas impuestas por el sistema que regulan el comportamiento de la suscripción. |
Amount
Cantidad.
Nombre | Tipo | Description |
---|---|---|
currency |
string |
Moneda del valor de la cantidad. |
value |
number |
Valor de la cantidad. Por ejemplo, si la moneda es USD, un valor de 600 sería $600.00. |
AutoRenew
Indica si la renovación automática está activada o desactivada para un producto.
Nombre | Tipo | Description |
---|---|---|
Off |
string |
|
On |
string |
Beneficiary
Detalles del beneficiario.
Nombre | Tipo | Description |
---|---|---|
objectId |
string |
Identificador que identifica de forma única a un usuario de un inquilino. |
tenantId |
string |
Identificador que identifica de forma única un inquilino. |
BillingSubscription
Propiedades de facturación de una suscripción.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Nombre del recurso |
properties.autoRenew |
Indica si la renovación automática está activada o desactivada para un producto. |
|
properties.beneficiary |
Beneficiario de la suscripción de facturación. |
|
properties.beneficiaryTenantId |
string |
Inquilino de aprovisionamiento de la suscripción. |
properties.billingFrequency |
string |
Frecuencia de facturación en ISO8601 formato del producto en la suscripción. Ejemplo: P1M, P3M, P1Y |
properties.billingPolicies |
object |
Diccionario de directivas de facturación asociadas a la suscripción. |
properties.billingProfileDisplayName |
string |
Nombre del perfil de facturación. |
properties.billingProfileId |
string |
Identificador completo que identifica de forma única un perfil de facturación. |
properties.billingProfileName |
string |
Identificador que identifica de forma única un perfil de facturación. |
properties.consumptionCostCenter |
string |
Centro de costos aplicado a la suscripción. Este campo solo está disponible para suscripciones de consumo de cuentas de facturación de Contrato de cliente de Microsoft o Tipo de contrato Enterprise. |
properties.customerDisplayName |
string |
Nombre del cliente. |
properties.customerId |
string |
Identificador completo que identifica de forma única a un cliente. |
properties.customerName |
string |
Identificador que identifica de forma única a un cliente. |
properties.displayName |
string |
Nombre de la suscripción de facturación. |
properties.enrollmentAccountDisplayName |
string |
Nombre de la cuenta de inscripción asociado a la suscripción. Este campo solo está disponible para las cuentas de facturación de Tipo de contrato Enterprise. |
properties.enrollmentAccountId |
string |
Identificador de cuenta de inscripción asociado a la suscripción. Este campo solo está disponible para las cuentas de facturación de Tipo de contrato Enterprise. |
properties.enrollmentAccountSubscriptionDetails.enrollmentAccountStartDate |
string |
La cuenta de inscripción y la fecha de inicio de la asociación de suscripción. Este campo solo está disponible para el tipo de contrato Enterprise. |
properties.enrollmentAccountSubscriptionDetails.subscriptionEnrollmentAccountStatus |
Estado de la cuenta de inscripción actual de la suscripción. Este campo solo está disponible para el tipo de contrato Enterprise. |
|
properties.invoiceSectionDisplayName |
string |
Nombre de la sección de factura. |
properties.invoiceSectionId |
string |
Identificador completo que identifica de forma única una sección de factura. |
properties.invoiceSectionName |
string |
Identificador que identifica de forma única una sección de factura. |
properties.lastMonthCharges |
Los cargos del último mes. Este campo solo está disponible para las suscripciones basadas en el uso de las cuentas de facturación del Contrato de cliente de Microsoft. |
|
properties.monthToDateCharges |
El mes actual hasta la fecha cobra. Este campo solo está disponible para las suscripciones basadas en el uso de las cuentas de facturación del Contrato de cliente de Microsoft. |
|
properties.nextBillingCycleDetails |
Detalles del ciclo de facturación siguiente de la suscripción. |
|
properties.offerId |
string |
Identificador de oferta de la suscripción. Este campo solo está disponible para las cuentas de facturación del Programa microsoft Online Services. |
properties.operationStatus |
Estado de una operación en la suscripción. Cuando Ninguno, no hay ninguna operación en curso. Cuando LockedForUpdate, las operaciones de escritura se bloquearán en la suscripción de facturación. Otro es el valor predeterminado y es posible que tenga que consultar la versión más reciente de la API para obtener más detalles. |
|
properties.productCategory |
string |
Categoría del producto para el que se adquiere la suscripción. Entre los valores posibles se incluyen: AzureSupport, Hardware, ReservationOrder, SaaS, SavingsPlanOrder, Software, UsageBased, Other. |
properties.productType |
string |
Tipo del producto para el que se adquiere la suscripción. |
properties.productTypeId |
string |
Identificador del producto para el que se adquiere la suscripción. |
properties.provisioningState |
Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada. |
|
properties.provisioningTenantId |
string |
Inquilino en el que se aprovisiona la suscripción. |
properties.purchaseDate |
string |
Fecha de compra del producto en hora UTC. |
properties.quantity |
integer |
Cantidad de licencias o unidades de suministro para la suscripción. |
properties.renewalTermDetails |
Detalles del siguiente período de renovación de una suscripción. |
|
properties.reseller |
Revendedor de esta suscripción. Los campos no están disponibles para las cuentas de facturación del Contrato de partners de Microsoft. |
|
properties.resourceUri |
string |
Identificador único del recurso vinculado. |
properties.skuDescription |
string |
Descripción de la SKU del producto para el que se compra la suscripción. Este campo solo está disponible para las cuentas de facturación con el tipo de contrato Microsoft Customer Agreement y Microsoft Partner Agreement. |
properties.skuId |
string |
Identificador de SKU del producto para el que se adquiere la suscripción. Este campo solo está disponible para las cuentas de facturación del Contrato de cliente de Microsoft. |
properties.status |
Estado de la suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise |
|
properties.subscriptionId |
string |
Identificador de la suscripción. |
properties.suspensionReasonDetails |
Los detalles de la suspensión de una suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise. |
|
properties.suspensionReasons |
string[] |
Motivo de suspensión de una suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise. |
properties.systemOverrides |
Las directivas impuestas por el sistema que regulan el comportamiento de la suscripción. |
|
properties.termDuration |
string |
Duración en ISO8601 formato para el que puede usar la suscripción. Ejemplo: P1M, P3M, P1Y |
properties.termEndDate |
string |
Fecha de finalización del término en hora UTC. |
properties.termStartDate |
string |
Fecha de inicio del término en hora UTC. |
systemData |
Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy. |
|
tags |
object |
Diccionario de metadatos asociados al recurso. Es posible que no se rellene para todos los tipos de recursos. Longitud máxima de clave/valor admitida de 256 caracteres. Las claves y el valor no deben estar vacíos ni null. Las claves no pueden contener <> % & \ ? / |
type |
string |
Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
BillingSubscriptionMergeRequest
Parámetros de solicitud que se proporcionan para combinar las dos suscripciones de facturación.
Nombre | Tipo | Description |
---|---|---|
quantity |
integer |
Cantidad de la suscripción de facturación de origen que se combinará con la suscripción de facturación de destino. |
targetBillingSubscriptionName |
string |
Identificador de la suscripción de facturación de destino que se combinará con la suscripción de origen proporcionada en la solicitud. |
BillingSubscriptionOperationStatus
Estado de una operación en la suscripción. Cuando Ninguno, no hay ninguna operación en curso. Cuando LockedForUpdate, las operaciones de escritura se bloquearán en la suscripción de facturación. Otro es el valor predeterminado y es posible que tenga que consultar la versión más reciente de la API para obtener más detalles.
Nombre | Tipo | Description |
---|---|---|
LockedForUpdate |
string |
|
None |
string |
|
Other |
string |
BillingSubscriptionStatus
Estado de la suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise
Nombre | Tipo | Description |
---|---|---|
Active |
string |
|
AutoRenew |
string |
|
Cancelled |
string |
|
Deleted |
string |
|
Disabled |
string |
|
Expired |
string |
|
Expiring |
string |
|
Failed |
string |
|
Other |
string |
|
Suspended |
string |
|
Unknown |
string |
|
Warned |
string |
BillingSubscriptionStatusDetails
Los detalles de la suspensión de una suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise.
Nombre | Tipo | Description |
---|---|---|
effectiveDate |
string |
Fecha de vigencia de la suspensión de una suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise. |
reason |
Motivo de suspensión de una suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise. |
Cancellation
La invalidación de directiva de la suscripción indica si se permite la cancelación de autoservicio o la reducción de puestos.
Nombre | Tipo | Description |
---|---|---|
Allowed |
string |
|
NotAllowed |
string |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
Mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
NextBillingCycleDetails
Detalles del ciclo de facturación del producto.
Nombre | Tipo | Description |
---|---|---|
billingFrequency |
string |
Frecuencia de facturación del producto en la suscripción. |
ProvisioningState
Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada.
Nombre | Tipo | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
RenewalTermDetails
Detalles del siguiente período de renovación de una suscripción.
Nombre | Tipo | Description |
---|---|---|
billingFrequency |
string |
Frecuencia de facturación en ISO8601 formato del producto en la suscripción. Ejemplo: P1M, P3M, P1Y |
productId |
string |
Identificador del producto para el que se adquiere la suscripción. |
productTypeId |
string |
Escriba Id. del producto para el que se compra la suscripción. |
quantity |
integer |
Cantidad de licencias o unidades de suministro para la suscripción. |
skuId |
string |
Identificador de SKU del producto para el que se adquiere la suscripción. Este campo solo está disponible para las cuentas de facturación del Contrato de cliente de Microsoft. |
termDuration |
string |
Duración en ISO8601 formato para el que puede usar la suscripción. Ejemplo: P1M, P3M, P1Y |
termEndDate |
string |
Fecha de finalización del término en hora UTC. |
Reseller
Detalles del revendedor.
Nombre | Tipo | Description |
---|---|---|
description |
string |
Nombre del revendedor. |
resellerId |
string |
Identificador de MPN del revendedor. |
SubscriptionEnrollmentAccountStatus
Estado de la cuenta de inscripción actual de la suscripción. Este campo solo está disponible para el tipo de contrato Enterprise.
Nombre | Tipo | Description |
---|---|---|
Active |
string |
|
Cancelled |
string |
|
Deleted |
string |
|
Expired |
string |
|
Inactive |
string |
|
TransferredOut |
string |
|
Transferring |
string |
SubscriptionStatusReason
Motivo de suspensión de una suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise.
Nombre | Tipo | Description |
---|---|---|
Cancelled |
string |
|
Expired |
string |
|
None |
string |
|
Other |
string |
|
PastDue |
string |
|
PolicyViolation |
string |
|
SpendingLimitReached |
string |
|
SuspiciousActivity |
string |
|
Transferred |
string |
systemData
Metadatos relativos a la creación y última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
SystemOverrides
Las directivas impuestas por el sistema que regulan el comportamiento de la suscripción.
Nombre | Tipo | Description |
---|---|---|
cancellation |
La invalidación de directiva de la suscripción indica si se permite la cancelación de autoservicio o la reducción de puestos. |
|
cancellationAllowedEndDate |
string |
Fecha de finalización en hora UTC en la que finaliza la cancelación de autoservicio. |