Obtener el estado de aprovisionamiento de suscripciónGet subscription provisioning status

Se aplica aApplies To

  • Centro de partnersPartner Center
  • Centro de partners operado por 21VianetPartner Center operated by 21Vianet
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Cómo obtener el estado de aprovisionamiento de suscripción para una suscripción de cliente.How to get the subscription provisioning status for a customer subscription.

Requisitos previosPrerequisites

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners.Credentials as described in Partner Center authentication. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.This scenario supports authentication with App+User credentials only.

  • Un id. de cliente (customer-tenant-id).A customer ID (customer-tenant-id). Si no conoces el identificador del cliente, puedes buscarlo en el panel del Centro de partners.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecciona CSP en el menú del Centro de partners, seguido de Clientes.Select CSP from the Partner Center menu, followed by Customers. En la lista de clientes, selecciona el cliente y, a continuación, elige Cuenta.Select the customer from the customer list, then select Account. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. El identificador de Microsoft es el mismo que el de cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Identificador de la suscripción.A subscription identifier.

  • Se requieren permisos de administrador delegado en la suscripción para realizar esta operación.Delegated admin permissions on the subscription are required to perform this operation.

C#C#

Para obtener el estado de aprovisionamiento de una suscripción, empiece con el método [colección iaggregatepartner. customers. ById/dotnet/API/Microsoft.Store.partnercenter.customers.icustomercollection.byid) con el identificador de cliente para identificar al cliente.To get the provisioning status of a subscription, begin by using the [IAggregatePartner.Customers.ById/dotnet/api/microsoft.store.partnercenter.customers.icustomercollection.byid) method with the customer ID to identify the customer. A continuación, obtenga una interfaz para las operaciones de suscripción llamando al método [subscriptions. ById/dotnet/API/Microsoft.Store.partnercenter.customerusers.icustomerusercollection.byid) con el identificador de suscripción.Then, get an interface to subscription operations by calling the [Subscriptions.ById/dotnet/api/microsoft.store.partnercenter.customerusers.icustomerusercollection.byid) method with the subscription ID. A continuación, use la propiedad [ProvisioningStatus/dotnet/API/Microsoft.Store.partnercenter.subscriptions.isubscription.provisioningstatus) para obtener una interfaz para las operaciones de estado de aprovisionamiento de la suscripción actual y, después, llame al método [Get/dotnet/API/Microsoft.Store.partnercenter.subscriptions.isubscriptionprovisioningstatus.Get) o [GetAsync/dotnet/API/Microsoft.Store.partnercenter.subscriptions.isubscriptionprovisioningstatus.GetAsync) para recuperar el objeto [SubscriptionProvisioningStatus/dotnet/API/Microsoft.Store.partnercenter.Models.subscriptions.subscriptionprovisioningstatus).Next, use the [ProvisioningStatus/dotnet/api/microsoft.store.partnercenter.subscriptions.isubscription.provisioningstatus) property to obtain an interface to the current subscription's provisioning status operations, and then call the [Get/dotnet/api/microsoft.store.partnercenter.subscriptions.isubscriptionprovisioningstatus.get) or [GetAsync/dotnet/api/microsoft.store.partnercenter.subscriptions.isubscriptionprovisioningstatus.getasync) method to retrieve the [SubscriptionProvisioningStatus/dotnet/api/microsoft.store.partnercenter.models.subscriptions.subscriptionprovisioningstatus) object.

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/customers/{customer-ID}/subscriptions/{subscription-ID}/provisioningstatus http/1.1{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1

Parámetros del identificador URIURI parameters

Use los siguientes parámetros de ruta de acceso para identificar el cliente y la suscripción.Use the following path parameters to identify the customer and subscription.

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-idcustomer-id stringstring Yes Cadena con formato de GUID que identifica al cliente.A GUID formatted string that identifies the customer.
subscription-idsubscription-id stringstring Yes Cadena con formato de GUID que identifica la suscripción.A GUID formatted string that identifies the subscription.

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplo de solicitudRequest example

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 RESTREST response

Si se realiza correctamente, el cuerpo de la respuesta contiene un recurso SubscriptionProvisioningStatus .If successful, the response body contains a SubscriptionProvisioningStatus resource.

Códigos de error y de respuesta correctosResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.For the full list, see Partner Center REST error codes.

Ejemplo de respuestaResponse example

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"
    }
}

ComentariosRemarks

  • Durante una asignación de cambio de licencia, el campo de estado de SubscriptionProvisioningStatus se establece en "pendiente".During a license change assignment, the status field in SubscriptionProvisioningStatus is set to "pending".

  • El campo de estado se actualiza cada quince minutos.The status field is updated every fifteen minutes.