Compartir a través de

Activación de una suscripción de espacio aislado para productos SaaS de Marketplace comercial para habilitar la facturación

  • Artículo

Cómo activar una suscripción para productos de software como servicio (SaaS) de Marketplace comercial desde cuentas de espacio aislado de integración para habilitar la facturación.

Nota:

Solo es posible activar una suscripción para productos SaaS de Marketplace comercial a partir de cuentas de espacio aislado de integración. Si tiene una suscripción de producción, debe visitar el sitio del publicador para completar el proceso de configuración. La facturación de la suscripción solo comenzará una vez completada la instalación.

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.
  • Una cuenta de asociado de espacio aislado de integración con un cliente que tenga una suscripción activa para productos SaaS de Marketplace comercial.
  • Para los asociados que usan el SDK de .NET del Centro de partners, debe usar la versión 1.14.0 o posterior del SDK para acceder a esta funcionalidad.

Importante

A partir de junio de 2023, la versión 3.4.0 más reciente del SDK de .NET del Centro de partners ahora está archivada. Puede descargar esta versión del SDK de GitHub, junto con un archivo Léame que contiene información útil.

Se recomienda a los partners seguir usando las API REST del Centro de partners.

C#

Siga estos pasos para activar una suscripción para productos SaaS de Marketplace comercial:

  1. Haga que esté disponible una interfaz para las operaciones de suscripción. Debe identificar al cliente y especificar el identificador de suscripción de la suscripción de prueba.

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);

  2. Active la suscripción mediante la operación Activar .

    var subscriptionActivationResult = subscriptionOperations.Activate();

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
POST {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

Parámetro de URI

Nombre Type Obligatorio Descripción
customer-tenant-id guid Y El valor es un identificador de inquilino de cliente con formato GUID (customer-tenant-id), que permite especificar un cliente.
subscription-id guid Y El valor es un identificador de suscripción con formato GUID (identificador de suscripción), que permite especificar una 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

POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/87363db7-39ab-dd25-d371-94340aaa2f97/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

Respuesta REST

Este método devuelve las propiedades subscription-id y status .

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: 79
Content-Type: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"87363db7-39ab-dd25-d371-94340aaa2f97",
    "status":"Success"
}