Obtener el estado de la firma directa de un cliente (aceptación directa) de Contrato de cliente de Microsoft

Artículo
03/05/2024

Se aplica a: Centro de partners

No se aplica a: Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

El recurso DirectSignedCustomerAgreementStatus solo es compatible actualmente con el Centro de partners en la nube pública de Microsoft.

En este artículo se explica cómo recuperar el estado de la aceptación directa de la Contrato de cliente de Microsoft de un cliente.

Requisitos previos

Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y 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, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

C#

Para recuperar el estado de la aceptación directa de un cliente del Contrato de cliente de Microsoft, llame al método IAggregatePartner.Customers.ById con el identificador de cliente. A continuación, use la propiedad Agreements para recuperar una interfaz ICustomerAgreementCollection. Por último, llame GetDirectSignedCustomerAgreementStatus() a o GetDirectSignedCustomerAgreementStatusAsync() para recuperar el estado.

// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();

Ejemplo: Aplicación de ejemplo de consola. Project: SdkSamples (Clase): GetDirectSignedCustomerAgreementStatus.cs

Solicitud REST

Para recuperar el estado de aceptación directa de la Contrato de cliente de Microsoft de un cliente, cree una solicitud REST para recuperar DirectSignedCustomerAgreementStatus para el cliente.

Sintaxis de la solicitud

Use la siguiente sintaxis de solicitud:

Método	URI de solicitud
GET	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Parámetros de URI

Puede usar los siguientes parámetros de URI con la solicitud:

Nombre	Type	Obligatorio	Descripción
customer-tenant-id	GUID	Sí	El valor es un CustomerTenantId con formato GUID que permite especificar el identificador de inquilino de un cliente.

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/14876998-c0dc-46e6-9d0c-65a57a6c32ec/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Respuesta REST

Si se ejecuta correctamente, este método devuelve un recurso DirectSignedCustomerAgreementStatus en el cuerpo de la respuesta.

El recurso tiene una propiedad isSigned que indica el estado de firma directa (aceptación directa) del cliente.

Un valor true indica que el cliente firmó (aceptó) directamente el contrato.
Un valor false indica que el cliente no ha firmado (aceptado) directamente el contrato.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica éxito o error y más información de depuración.

Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. 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: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}

Compartir vía