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

Roles adecuados: Agente de administración

En este artículo se muestra cómo activar una suscripción para productos de Software como Servicio (SaaS) del mercado comercial desde cuentas de sandbox de integración para habilitar la facturación.

Nota:

Solo es posible activar una suscripción para productos SaaS del mercado comercial a partir de cuentas de entorno de pruebas 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.

Prerrequisitos

• Credenciales tal como se describe en Autenticación del Centro de asociados. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.
• Una cuenta de socio de sandbox de integración con un cliente que tenga una suscripción activa para productos SaaS del mercado 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 Socios ahora está archivada. Puede descargar la 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.

Uso de 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();
   

Envío de una solicitud REST

Use la siguiente sintaxis para enviar una solicitud REST.

Sintaxis de la solicitud

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

Parámetro de URI

Nombre	Tipo	Obligatorio	Descripción
id de cliente-arrendatario	guid	Y	El valor es un identificador de inquilino de cliente con formato GUID (customer-tenant-id), que permite especificar un cliente.
id-de-suscripción	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 más información, consulte 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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

Revisa la respuesta de REST

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

Códigos de éxito y de error de la respuesta

Cada respuesta incluye un código de estado HTTP que indica el éxito o error y la información adicional de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de socios.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "status":"Success"
}

Contenido relacionado

• ¿Cuáles son las API REST del Centro de asociados?