Registrar una suscripción

  • Artículo

Registre una suscripción existente para que esté habilitada para pedir reservas de Azure.

Para comprar una reserva de Azure, debe tener al menos una suscripción de Azure de CSP existente. Este método permite registrar la suscripción de Azure de CSP existente, lo que le permite comprar reservas de Azure.

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+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, 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).

  • Un identificador de suscripción.

C#

Para registrar la suscripción de un cliente, recupere una interfaz para las operaciones de suscripción llamando al método IAggregatePartner.Customers.ById con el identificador de cliente para identificar al cliente. A continuación, llame al método Subscription.ById() con el identificador de suscripción para identificar la suscripción que está registrando.

Por último, llame al método Registration.Register() para registrar la suscripción y recuperar un URI que se puede usar para obtener el estado de registro de la suscripción. Para obtener más información, consulte Obtención del estado del registro de la suscripción.

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

// Retrieve the subscription registration details.
var subscriptionRegistrationDetails = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).Registration.Register();

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
POST {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/registrations 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 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. Los asociados deben usar el identificador del plan de Azure para los nuevos casos comerciales.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-id>/subscriptions/<subscription-id>/registrations 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, la respuesta contiene un encabezado Location con un URI que se puede usar para recuperar el estado de registro de la suscripción. Guarde este URI para usarlo con otras API REST relacionadas. Para obtener un ejemplo de cómo recuperar el estado, consulte Obtención del estado de registro de la suscripción.

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 202 Accepted
Content-Length: 0
Location: /customers/<customer-id>/subscriptions/<subscription-id>/registrationstatus
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525