Compartir a través de


Recursos de suscripción

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

Una suscripción permite a un cliente usar un servicio durante un determinado período de tiempo. No todos los campos se aplican a todas las suscripciones. Muchos campos solo se aplican en determinados puntos del ciclo de vida, como si se suspende o cancela una suscripción.

Subscription

Nota:

El recurso Suscripción tiene un límite de velocidad de 500 solicitudes por minuto por identificador de inquilino.

El recurso Suscripción representa el ciclo de vida de una suscripción e incluye propiedades que definen los estados a lo largo del ciclo de vida de la suscripción.

Propiedad Tipo Descripción
ID string Identificador de la suscripción.
offerId string El identificador de la oferta.
entitlementId string Identificador de derechos (un identificador de suscripción de Azure).
offerName string Nombre de la oferta.
friendlyName string Nombre descriptivo de la suscripción definida por el asociado para ayudar a desambiguar.
quantity number La cantidad. Esta propiedad se establece en el recuento de licencias para la facturación basada en licencias.
unitType string Unidades que definen la cantidad de la suscripción: "Licencias", "Basada en uso" o "Ventaja".
parentSubscriptionId string Obtiene o establece el identificador de suscripción primario.
creationDate string Obtiene o establece la fecha de creación, en formato de fecha y hora.
effectiveStartDate cadena en formato de fecha y hora UTC Obtiene o establece la fecha de inicio efectiva de esta suscripción, en formato de fecha y hora. Esta propiedad se usa para volver a la fecha de una suscripción migrada o para alinearla con otra.
commitmentEndDate cadena en formato de fecha y hora UTC Fecha de finalización del compromiso para esta suscripción, en formato de fecha y hora. En el caso de las suscripciones que no se pueden modificar automáticamente, esta propiedad representa una fecha lejos en el futuro. Las nuevas fechas de finalización del comercio son inclusivas, lo que significa que el final del término está al final del día completo. Las fechas de finalización heredadas no son inclusivas.
commitmentEndDateTime cadena en formato de fecha y hora UTC Fecha y hora de finalización del compromiso para esta suscripción, en formato de fecha y hora. En el caso de las suscripciones que no se pueden modificar automáticamente, esta propiedad representa una fecha lejos en el futuro.
status string El estado de la suscripción: "none", "active", "pending", "suspended", "expired", "disabled" o "deleted".
autoRenewEnabled boolean Obtiene un valor que indica si la suscripción se renueva automáticamente.
billingType string Especifica cómo se factura la suscripción: "none", "usage", "license" o "benefit".
billingCycle string Indica la frecuencia con la que se factura al asociado para este pedido. Los valores admitidos son los nombres de los miembros que se encuentran en BillingCycleType.
hasPurchasableAddons boolean Obtiene o establece un valor que indica si la suscripción tiene complementos que se pueden purgar.
isTrial boolean Valor que indica si la suscripción es una prueba.
isMicrosoftProduct boolean Valor que indica si la suscripción es un producto de Microsoft.
publisherName string Nombre del publicador.
actions Matriz de cadenas Obtiene o establece las acciones permitidas. Valores posibles: "editar", "cancelar"
PartnerId string PartnerID del revendedor de registro, usado en el modelo de asociado indirecto.
suspensionReasons Matriz de cadenas Solo lectura Si la suscripción se suspendió, indica por qué.
contractType string Solo lectura Tipo de contrato: "subscription", "productKey" o "redemptionCode".
refundOptions matriz de recursos RefundOption Solo lectura. Conjunto de opciones de reembolso disponibles para esta suscripción.
scheduledNextTermInstructions scheduledNextTermInstructions Obtiene o establece las instrucciones programadas ejecutadas cuando se inicia el siguiente término.
nextChargeInstructions nextChargeInstructions Obtiene los detalles de las instrucciones de facturación del siguiente término para los cambios en el ciclo de facturación pendientes al final del período actual.
vínculos SubscriptionLinks Obtiene o establece los vínculos de suscripción.
orderId string Identificador del pedido que se realizó para iniciar la suscripción.
termDuration string Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (1 mes), P1Y (1 año) y P3Y (3 años).
atributos ResourceAttributes Atributos de metadatos correspondientes a la suscripción.
renewalTermDuration string Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (1 mes) y P1Y (1 año).
ProductType ItemType Solo lectura Tipo de producto para el que está la suscripción.
consumptionType matriz de recursos de uso por encima del límite Obtiene o establece el uso por encima del límite de un cliente determinado.
promotionId string Identificador de promoción si se aplica a la suscripción. Ejemplo de formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN"
CancellationAllowedUntilDate DateTime La última fecha de cancelación.
BillingCycleEndDate DateTime Obtiene o establece la fecha de finalización del ciclo de facturación para esta suscripción, en formato de fecha y hora.
BillingCycleEndDateTime DateTime Obtiene la fecha y hora de finalización del ciclo de facturación para esta suscripción, en formato de fecha y hora.
productOrderId string Identificador de una compra de producto específica (por ejemplo, Reservas o plan de ahorro de Azure).
lineItems SubscriptionLineItem Un elemento de línea contiene los detalles de compra de una suscripción determinada.

El recurso SubscriptionLinks describe la colección de vínculos asociados a un recurso de suscripción.

Propiedad Tipo Descripción
offer Vínculo Obtiene o establece la oferta.
parentSubscription Vínculo Obtiene o establece la suscripción primaria.
producto Vínculo Obtiene el producto asociado a la suscripción.
sku Vínculo Obtiene la SKU del producto asociada a la suscripción.
disponibilidad Vínculo Obtiene la disponibilidad de la SKU del producto asociada a la suscripción.
activationLinks Vínculo Obtiene la lista de vínculos de activación asociados a la suscripción.
self Vínculo Identificador URI propio.
siguiente Vínculo Página siguiente de elementos.
previous Vínculo Página anterior de elementos.

SubscriptionProvisioningStatus

El recurso SubscriptionProvisioningStatus proporciona información sobre el estado de aprovisionamiento de una suscripción.

Propiedad Tipo Descripción
skuId string Cadena que identifica la SKU del producto.
status string Indica el estado de aprovisionamiento: "correcto", "pendiente" o "error".
quantity number Proporciona la cantidad de suscripción después del aprovisionamiento.
endDate cadena en formato de fecha y hora UTC Fecha de finalización de la suscripción.
atributos ResourceAttributes Atributos de metadatos.

scheduledNextTermInstructions

El recurso scheduledNextTermInstructions define las instrucciones que se aplicarán al inicio del siguiente período de la suscripción. Solo está presente si se establecen cambios programados o para todas las suscripciones de prueba.

Propiedad Tipo Descripción
producto product Cadena con formato GUID que identifica la SKU del producto.
quantity number Proporciona la cantidad de suscripción después del aprovisionamiento.
customTermEndDate cadena en formato de fecha y hora UTC Fecha de finalización personalizada de la suscripción cuando se alinea con la fecha de finalización de otra suscripción

Producto

El recurso scheduledNextTermInstructions.product y los atributos que se aplicarán a un cambio programado en el siguiente término.

Propiedad Tipo Descripción
productId Cadena Identificador de un producto.
skuId Cadena Proporciona la cantidad de suscripción después del aprovisionamiento.
availabilityId Cadena Identificador de esta disponibilidad. Este identificador es único solo en el contexto de su producto principal y SKU. Nota Los identificadores de disponibilidad pueden cambiar con el tiempo. Los asociados solo deben confiar en este valor en un breve intervalo de tiempo después de recuperarlo.
billingCycle Cadena Indica la frecuencia con la que se factura al asociado para este pedido. Los valores admitidos son los nombres de los miembros que se encuentran en BillingCycleType.
termDuration Cadena Representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (1 mes) y P1Y (1 año).
promotionId Cadena Identificador de promoción que se va a aplicar para el siguiente período programado. Ejemplo de formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN".

nextChargeInstructions

El recurso nextChargeInstructions define las instrucciones del ciclo de facturación aplicadas al inicio del siguiente período de la suscripción. Solo está presente cuando los cambios pendientes del ciclo de facturación están pendientes.

Propiedad Tipo Descripción
producto product Cadena con formato GUID que identifica la SKU del producto.
quantity number Proporciona la cantidad de suscripción después del aprovisionamiento.

SubscriptionRegistrationStatus

El recurso SubscriptionRegistrationStatus describe la colección de vínculos adjuntos a un recurso de suscripción.

Propiedad Tipo Descripción
subscriptionId string Identificador de la suscripción.
status string Indica el estado del registro: "registered", "register" o "notregistered".

SupportContact

El recurso SupportContact representa un contacto de soporte técnico para la suscripción de un cliente.

Propiedad Tipo Descripción
supportTenantId string Cadena con formato GUID que indica el identificador de inquilino del contacto de soporte técnico.
supportMpnId string Identificador del asociado del contacto.
name string Nombre del contacto de soporte técnico.
vínculos ResourceLinks Los vínculos relacionados con el soporte técnico.
atributos ResourceAttributes Atributos de metadatos. Contiene "objectType": " SupportContact".

Uso por encima del límite

El recurso de uso por encima del límite representa el uso por encima del límite de la suscripción de consumo al que se puede asignar, tanto si está asignado como el revendedor asignado.

Propiedad Tipo Descripción
azureEntitlementId string Cadena con formato GUID que indica el identificador de suscripción de consumo.
PartnerId string Identificador de asociado del revendedor asociado a la suscripción.
type cadena El tipo de uso por encima del límite puede ser "Teléfono Services"
Excedente boolean Valor que indica si el uso por encima del límite está habilitado.
vínculos ResourceLinks Vínculos relacionados con el uso por encima del límite.
atributos ResourceAttributes Atributos de metadatos. Contiene "objectType": "Uso por encima del límite".

RegisterSubscription

El recurso RegisterSubscription devuelve un vínculo que se puede usar para consultar el estado de registro de una suscripción. El estado de registro se devuelve en el cuerpo de la respuesta de una solicitud aceptada correctamente para registrar una suscripción de Azure.

Propiedad Tipo Descripción
httpResponseMessage object Devuelve el código de estado HTTP 202 "Aceptado", con un encabezado Location que contiene un vínculo para consultar el estado del registro. Por ejemplo: "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus"

RefundOption

El recurso RefundOption representa una posible opción de reembolso para la suscripción.

Propiedad Tipo Descripción
type cadena Tipo de reembolso. Los valores admitidos son "Partial" y "Full"
expiresAfter cadena en formato de fecha y hora UTC Marca de tiempo cuando esta opción expira. Si es null, la operación de reembolso no tiene expiración.

AzureEntitlement

El recurso AzureEntitlement representa los derechos de Azure para la suscripción.

Propiedad Tipo Descripción
ID string Identificador de derechos
friendlyName string Nombre descriptivo del derecho.
status string Estado del derecho.
subscriptionId string Identificador de suscripción al que pertenece el derecho.

SubscriptionLineItem

Un elemento de línea contiene los detalles de compra de una suscripción determinada.

Propiedad Tipo Descripción
ID string Identificador del elemento de línea de suscripción.
friendlyName string Nombre descriptivo del elemento de línea de suscripción definido por el asociado para ayudar a desambiguar.
scope Ámbito Ámbito indica dónde se aplican las ventajas.
autoRenewEnabled Booleano Obtiene un valor que indica si la suscripción se renueva automáticamente.
status string El estado de la suscripción: "none", "active", "pending", "suspended", "expired", "disabled" o "deleted".
purchaseCommitment Compromiso de compra Cantidad fija confirmada en los servicios de proceso.

Ámbito

Ámbito indica dónde se aplican las ventajas.

Propiedad Tipo Descripción
type cadena El tipo de ámbito de una compra: "Single", "Shared", "Resource group" o "Management group".
subscriptionId string Identificador del plan de Azure que se usaría para una compra. Obligatorio para el ámbito compartido.
entitlementId string Identificador de la suscripción de Azure que se usaría para una compra. Necesario para un ámbito único.
managementGroupId string Identificador del grupo de administración que se usaría para una compra. Este ámbito solo se puede seleccionar a través de Azure Portal en la actualidad, pero las actualizaciones se reflejan en el equipo.
ResourceGroupId string Identificador del grupo de recursos que se usaría para una compra. Este ámbito solo se puede seleccionar a través de Azure Portal en la actualidad, pero las actualizaciones se reflejan en el equipo.

Compromiso de compra

Cantidad fija confirmada en los servicios de proceso.

Propiedad Tipo Descripción
amount string Compromiso fijo de importe.
Grano string Período para el compromiso.
currency string Moneda del compromiso.