Compartir a través de


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
billingAccountName
path True

string

Identificador que identifica de forma única una cuenta de facturación.

billingSubscriptionName
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

BillingSubscription

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

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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.

AutoRenew

Indica si la renovación automática está activada o desactivada para un producto.

Beneficiary

Detalles del beneficiario.

BillingSubscription

Propiedades de facturación de una suscripción.

BillingSubscriptionMergeRequest

Parámetros de solicitud que se proporcionan para combinar las dos suscripciones de facturación.

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.

BillingSubscriptionStatus

Estado de la suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise

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.

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.

createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

NextBillingCycleDetails

Detalles del ciclo de facturación del producto.

ProvisioningState

Estado de aprovisionamiento del recurso durante una operación de ejecución prolongada.

RenewalTermDetails

Detalles del siguiente período de renovación de una suscripción.

Reseller

Detalles 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.

SubscriptionStatusReason

Motivo de suspensión de una suscripción. Este campo no está disponible para las cuentas de facturación del Contrato Enterprise.

systemData

Metadatos relativos a la creación y última modificación del recurso.

SystemOverrides

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

AutoRenew

Indica si la renovación automática está activada o desactivada para un producto.

properties.beneficiary

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

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

Amount

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

Amount

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

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

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.

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

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

RenewalTermDetails

Detalles del siguiente período de renovación de una suscripción.

properties.reseller

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

BillingSubscriptionStatus

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

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.

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

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

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

SubscriptionStatusReason

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

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

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

createdByType

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

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.