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.