Compartir a través de

Obtener el estado de aprovisionamiento de suscripción

  • Artículo

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 privilegios de administrador delegados granulares (GDAP)

Necesita 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

Método URI de solicitud
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1

Parámetros de URI

Use los siguientes parámetros de ruta de acceso para identificar el cliente y la suscripción.

Nombre Type Obligatorio Descripción
customer-ID string Sí Cadena con formato GUID que identifica al cliente.
subscription-ID string 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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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 éxito o error y otra información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. 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: aaaa0000-bb11-2222-33cc-444444dddddd
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

  • El campo de estado de SubscriptionProvisioningStatus se establece en "pendiente" durante una asignación de cambios de licencia.

  • El campo de estado se actualiza cada 15 minutos.