Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a: Centro de asociados | Centro de asociados operado por 21Vianet | Centro de asociados para la Nube de Microsoft para el Gobierno de los EE. UU.
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.
Suscripción
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 |
|---|---|---|
| identificación | cuerda / cadena | Identificador de la suscripción. |
| ID de oferta | cuerda / cadena | El identificador de la oferta. |
| entitlementId | cuerda / cadena | Identificador de derechos (un identificador de suscripción de Azure). |
| nombreDeLaOferta | cuerda / cadena | Nombre de la oferta. |
| nombre amistoso | cuerda / cadena | El nombre amigable de la suscripción definida por el asociado para ayudar a desambiguar. |
| cantidad | número | Cantidad. Esta propiedad se establece según el número de licencias para la facturación por licencias. |
| tipoUnidad | cuerda / cadena | Unidades que definen la cantidad de la suscripción: "Licencias", "Basada en uso" o "Ventaja". |
| idSuscripciónPrincipal | cuerda / cadena | Obtiene o establece el identificador de suscripción primario. |
| fechaDeCreación | cuerda / cadena | Obtiene o establece la fecha de creación, en formato de fecha y hora. |
| fecha de inicio efectiva | 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 utiliza para retroceder la fecha de una suscripción migrada o para alinearla con otra. |
| fecha de fin de compromiso | 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. |
| fechaHoraFinCompromiso | 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. |
| estado | cuerda / cadena | El estado de la suscripción: "ninguno", "activo", "pendiente", "suspendido", "expirado", "deshabilitado" o "eliminado". |
| renovaciónAutomáticaActivada | booleano | Obtiene un valor que indica si la suscripción se renueva automáticamente. |
| tipo de facturación | cuerda / cadena | Especifica cómo se factura la suscripción: "ninguno", "uso", "licencia" o "beneficio". |
| ciclo de facturación | cuerda / cadena | Indica la frecuencia con la que se factura al socio por este pedido. Los valores admitidos son los nombres de miembro que se encuentran en BillingCycleType. |
| tieneComplementosComprables | booleano | Obtiene o establece un valor que indica si la suscripción tiene complementos que se pueden purgar. |
| isTrial | booleano | Valor que indica si la suscripción es una prueba. |
| esProductoDeMicrosoft | booleano | Valor que indica si la suscripción es un producto de Microsoft. |
| nombre del editor | cuerda / cadena | Nombre del publicador. |
| Acciones | Matriz de cadenas | Obtiene o establece las acciones permitidas. Valores posibles: "editar", "cancelar" |
| partnerId | cuerda / cadena | El PartnerID del revendedor oficial, utilizado en el modelo de socio indirecto. |
| additionalPartnerIds | Matriz de cadenas | Una recopilación de PartnerIDs utilizados únicamente por los distribuidores en los mercados de la UE/EFTA. |
| razones de suspensión | Matriz de cadenas | Solo lectura. Si la suscripción se suspendió, indica por qué. |
| tipoDeContrato | cuerda / cadena | Solo lectura. Tipo de contrato: "suscripción", "clave del producto" o "código de canje". |
| opcionesDeReembolso | matriz de recursos RefundOption | Solo lectura. Conjunto de opciones de reembolso disponibles para esta suscripción. |
| instruccionesprogramadasparapróximoperiodo | scheduledNextTermInstructions | Obtiene o establece las instrucciones programadas ejecutadas al inicio del siguiente término. |
| instruccionesParaLaPróximaCarga | 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. |
| Enlaces | SubscriptionLinks | Obtiene o establece los vínculos de suscripción. |
| ID de pedido | cuerda / cadena | Identificador del pedido que se realizó para iniciar la suscripción. |
| duración del término | cuerda / cadena | Una representación ISO 8601 de la duración del término. Los valores admitidos actualmente son P1M (1 mes), P1Y (1 año) y P3Y (3 años). |
| termLifeCycleState | cuerda / cadena | Representación del estado del ciclo de vida del término de subíndice. Los valores admitidos actuales son GA (disponible con carácter general), EndOfSale, y EndOfSaleWithConversions (se puede convertir a). |
| Atributos | ResourceAttributes (Atributos de recurso) | Atributos de metadatos correspondientes a la suscripción. |
| duraciónDelPlazoDeRenovación | cuerda / cadena | Una representación ISO 8601 de la duración del término. Los valores admitidos actuales son P1M (1 mes) y P1Y (1 año). |
| Tipo de producto | ItemType (Tipo de artículo) | Solo lectura. Tipo de producto para el que está la suscripción. |
| tipo de consumo | conjunto de recursos excedentes | Obtiene o establece el exceso para un cliente determinado. |
| promotionId | cuerda / cadena | Identificador de promoción si se aplica a la suscripción. Ejemplo de formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN" |
| CancelaciónPermitidaHastaFecha | Fecha y hora | La última fecha de cancelación. |
| FechaFinCicloFacturación | Fecha y hora | Obtiene o establece la fecha de finalización del ciclo de facturación para esta suscripción, en formato de fecha y hora. |
| BillingCycleEndDateTime | Fecha y hora | Obtiene la fecha y hora de finalización del ciclo de facturación para esta suscripción, en formato de fecha y hora. |
| identificadorDePedidoDeProducto | cuerda / cadena | 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. |
Enlaces de suscripción
El recurso SubscriptionLinks describe la colección de vínculos asociados a un recurso de suscripción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| oferta | Vínculo | Obtiene o establece la oferta. |
| suscripción principal | Vínculo | Obtiene o establece la suscripción principal. |
| producto | Vínculo | Obtiene el producto asociado a la suscripción. |
| código 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. |
| propio | Vínculo | El self-URI. |
| siguiente | Vínculo | Página siguiente de elementos. |
| anterior | Vínculo | Página anterior de elementos. |
Estado de Aprovisionamiento de Suscripción
El recurso SubscriptionProvisioningStatus proporciona información sobre el estado de aprovisionamiento de una suscripción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| skuId | cuerda / cadena | Cadena que identifica la SKU del producto. |
| estado | cuerda / cadena | Indica el estado de aprovisionamiento: "correcto", "pendiente" o "error". |
| cantidad | número | Proporciona la cantidad de suscripción después del aprovisionamiento. |
| fecha de finalización | cadena en formato de fecha y hora UTC | Fecha de finalización de la suscripción. |
| Atributos | ResourceAttributes (Atributos de recurso) | Los atributos de metadatos. |
instruccionesprogramadasparapróximoperiodo
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 | producto | Cadena con formato GUID que identifica la SKU del producto. |
| cantidad | número | Proporciona la cantidad de suscripción después del aprovisionamiento. |
| fechaDeFinalizacionDelTerminoPersonalizado | 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 a los que se aplicará un cambio programado en el siguiente término.
| Propiedad | Tipo | Descripción |
|---|---|---|
| ID de producto | Cuerda | Identificador de un producto. |
| skuId | Cuerda | Proporciona la cantidad de suscripción después del aprovisionamiento. |
| identificadorDeDisponibilidad | Cuerda | 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. |
| ciclo de facturación | Cuerda | Indica la frecuencia con la que se factura al socio por este pedido. Los valores admitidos son los nombres de miembro que se encuentran en BillingCycleType. |
| duración del término | Cuerda | Una 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 | Cuerda | Identificador de promoción que se va a aplicar para el siguiente período programado. Ejemplo de formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN". |
instruccionesParaLaPróximaCarga
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 hay cambios pendientes en el ciclo de facturación.
| Propiedad | Tipo | Descripción |
|---|---|---|
| producto | producto | Cadena con formato GUID que identifica la SKU del producto. |
| cantidad | número | Proporciona la cantidad de suscripción después del aprovisionamiento. |
EstadoDeRegistroDeSuscripción
El recurso SubscriptionRegistrationStatus describe la colección de vínculos adjuntos a un recurso de suscripción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| ID de suscripción | cuerda / cadena | Identificador de la suscripción. |
| estado | cuerda / cadena | Indica el estado del registro: "registrado", "registrando" o "no registrado". |
SoporteContacto
El recurso SupportContact representa un contacto de soporte técnico para la suscripción de un cliente.
| Propiedad | Tipo | Descripción |
|---|---|---|
| supportTenantId | cuerda / cadena | Cadena con formato GUID que indica el identificador de inquilino del contacto de soporte técnico. |
| supportMpnId | cuerda / cadena | Identificador del asociado del contacto. |
| nombre | cuerda / cadena | Nombre del contacto de soporte técnico. |
| Enlaces | Enlaces de recursos | Los vínculos relacionados con el soporte técnico. |
| Atributos | ResourceAttributes (Atributos de recurso) | Los atributos de metadatos. Contiene "objectType": " SupportContact". |
Uso por encima del límite
El recurso de exceso representa el exceso de uso de la suscripción de consumo al que se puede asignar, ya sea si está asignado o el revendedor a quien está asignado.
| Propiedad | Tipo | Descripción |
|---|---|---|
| azureEntitlementId | cuerda / cadena | Cadena con formato GUID que indica el identificador de suscripción de consumo. |
| partnerId | cuerda / cadena | Identificador de asociado del revendedor asociado a la suscripción. |
| tipo | cuerda / cadena | El tipo de sobreuso puede ser "PhoneServices" |
| excedente de mercancías | booleano | Valor que indica si el uso por encima del límite está habilitado. |
| Enlaces | Enlaces de recursos | Vínculos relacionados con el uso por encima del límite. |
| Atributos | ResourceAttributes (Atributos de recurso) | Los atributos de metadatos. Contiene "objectType": "Uso por encima del límite". |
RegistrarseSuscripción
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 |
|---|---|---|
| Mensaje de respuesta HTTP | objeto | 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" |
Opción de reembolso
El recurso RefundOption representa una posible opción de reembolso para la suscripción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tipo | cuerda / cadena | Tipo de reembolso. Los valores admitidos son "Parcial" y "Completo" |
| caducaDespués | cadena en formato de fecha y hora UTC | La marca de tiempo en la que 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 |
|---|---|---|
| identificación | cuerda / cadena | Identificador de derechos |
| nombre amistoso | cuerda / cadena | Nombre amigable del derecho. |
| estado | cuerda / cadena | El estado de los derechos. |
| ID de suscripción | cuerda / cadena | Identificador de suscripción al que pertenece el derecho. |
ElementoDeLíneaDeSuscripción
Un elemento de línea contiene los detalles de compra de una suscripción determinada.
| Propiedad | Tipo | Descripción |
|---|---|---|
| identificación | cuerda / cadena | Identificador de elemento de línea de suscripción. |
| nombre amistoso | cuerda / cadena | Nombre amigable del elemento de línea de suscripción definido por el socio para ayudar a desambiguar. |
| alcance | Ámbito | Ámbito indica dónde se aplican los beneficios. |
| renovaciónAutomáticaActivada | Booleano | Obtiene un valor que indica si la suscripción se renueva automáticamente. |
| estado | cuerda / cadena | El estado de la suscripción: "ninguno", "activo", "pendiente", "suspendido", "expirado", "deshabilitado" o "eliminado". |
| compromiso de compra | Compromiso de compra | Cantidad fija comprometida a los servicios de cómputo. |
Ámbito
Ámbito indica dónde se aplican los beneficios.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tipo | cuerda / cadena | El tipo de ámbito de una compra: "Único", "Compartido", "Grupo de recursos" o "Grupo de administración". |
| ID de suscripción | cuerda / cadena | Identificador del plan de Azure que se usaría para una compra. Obligatorio para el ámbito compartido. |
| entitlementId | cuerda / cadena | Identificador de la suscripción de Azure que se usaría para una compra. Necesario para un ámbito único. |
| IdGrupoDeGestión | cuerda / cadena | El identificador del grupo de administración que se usaría para una compra. Este ámbito solo se puede seleccionar a través del portal de Azure actualmente, pero las actualizaciones se reflejan en el PC. |
| resourceGroupId | cuerda / cadena | Identificador del grupo de recursos que sería utilizado para una compra. Este ámbito solo se puede seleccionar a través del portal de Azure actualmente, pero las actualizaciones se reflejan en el PC. |
Compromiso de compra
Cantidad fija comprometida a los servicios de cómputo.
| Propiedad | Tipo | Descripción |
|---|---|---|
| importe | cuerda / cadena | Compromiso fijo de importe. |
| grano | cuerda / cadena | Período del compromiso. |
| divisa | cuerda / cadena | Moneda del compromiso. |