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