Obtener el estado de registro de la suscripción

  • Artículo

Cómo obtener el estado de registro de la suscripción para una suscripción de cliente que se ha habilitado para comprar instancias reservadas de máquina virtual de Azure.

Para comprar una instancia reservada de máquina virtual de Azure mediante la API del Centro de partners, debe tener al menos una suscripción de Azure de CSP existente. El método Registrar una suscripción le permite registrar la suscripción de Azure de CSP existente, lo que le permite comprar instancias reservadas de máquina virtual de Azure. Este método permite recuperar el estado de ese registro.

Requisitos previos

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+user.

  • 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 , el cliente de la lista de clientes y, a continuación, Cuenta. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

  • Identificador de suscripción.

C#

Para obtener el estado de registro 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 Subscription.ById() con el identificador de suscripción para identificar la suscripción. A continuación, use la propiedad RegistrationStatus para obtener una interfaz a las operaciones de estado de registro de la suscripción actual y llame al método Get o GetAsync para recuperar el objeto SubscriptionRegistrationStatus .

// IAggregatePartner partnerOperations;
// var selectedCustomerId;
// var selectedSubscriptionId;

// Retrieve a subscription's registration status details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).RegistrationStatus.Get();

Solicitud REST

Sintaxis de la solicitud

Método URI de la solicitud
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus 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 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/<customer-id>/subscriptions/<subscription-id>/registrationstatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-CorrelationId: ec8f62e5-1d92-47e9-8d5d-1924af105123
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

Respuesta REST

Si se ejecuta correctamente, el cuerpo de la respuesta contiene un recurso SubscriptionRegistrationStatus .

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, consulte Códigos de error.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344

{
    "subscriptionId":"<subscription-id>",
    "status":"NotRegistered",
    "attributes":{
        "objectType":"SubscriptionRegistrationStatus"
    }
}