Obtener el estado de aprovisionamiento de suscripción
Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government
Cómo obtener el estado de aprovisionamiento de la suscripción para una suscripción de cliente.
Requisitos previos
Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.
Un id. de cliente (
customer-tenant-id
). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id
).Identificador de suscripción.
Los permisos de administrador delegado en la suscripción son necesarios para realizar esta operación.
Roles de GDAP
Necesitará al menos uno de los siguientes roles de GDAP:
- Lector del directorio
- Lector global
C#
Para obtener el estado de aprovisionamiento de una suscripción, empiece por usar el método IAggregatePartner.Customers.ById con el identificador de cliente para identificar al cliente. A continuación, obtenga una interfaz para las operaciones de suscripción llamando al método Subscriptions.ById con el identificador de suscripción. A continuación, use la propiedad ProvisioningStatus para obtener una interfaz a las operaciones de estado de aprovisionamiento de la suscripción actual y, a continuación, llame al método Get o GetAsync para recuperar el objeto SubscriptionProvisioningStatus.
// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;
// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();
Solicitud REST
Sintaxis de la solicitud
Method | URI de solicitud |
---|---|
GET | {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1 |
Parámetros del identificador URI
Use los siguientes parámetros de ruta de acceso para identificar el cliente y la suscripción.
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
customer-id | cadena | Sí | Cadena con formato GUID que identifica al cliente. |
subscription-id | cadena | Sí | Cadena con formato GUID que identifica la suscripción. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Cuerpo de la solicitud
Ninguno.
Ejemplo de solicitud
GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Respuesta REST
Si se ejecuta correctamente, el cuerpo de la respuesta contiene un recurso SubscriptionProvisioningStatus .
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.
Ejemplo de respuesta
HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
Date: Thu, 20 Apr 2017 19:23:39 GMT
{
"skuId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
"status": "success",
"quantity": 5,
"endDate": "2018-05-10T00:00:00Z",
"attributes": {
"objectType": "SubscriptionProvisioningStatus"
}
}
Comentarios
Durante una asignación de cambios de licencia, el campo de estado de SubscriptionProvisioningStatus se establece en "pendiente".
El campo de estado se actualiza cada 15 minutos.
Comentarios
https://aka.ms/ContentUserFeedback.
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte:Enviar e ver os comentarios