Obtiene el estado de la firma directa de un cliente (aceptación directa) del contrato de cliente de Microsoft.Get the status of a customer's direct signing (direct acceptance) of Microsoft Customer Agreement

Se aplica a:Applies to:

  • Centro de partnersPartner Center

El recurso DirectSignedCustomerAgreementStatus solo es compatible actualmente con el centro de Partners en la nube pública de Microsoft.The DirectSignedCustomerAgreementStatus resource is currently supported by Partner Center only in the Microsoft public cloud.

Este recurso no es aplicable a:This resource is not applicable to:

  • Centro de partners operado por 21VianetPartner Center operated by 21Vianet
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

En este artículo se explica cómo puede recuperar el estado de la aceptación directa de un cliente del contrato de cliente de Microsoft.This article explains how you can retrieve the status of a customer's direct acceptance of the Microsoft Customer Agreement.

Solicitud RESTREST request

Para recuperar el estado de la aceptación directa de un cliente del acuerdo de cliente de Microsoft, cree una solicitud REST para recuperar el DirectSignedCustomerAgreementStatus para el cliente.To retrieve the status of a customer's direct acceptance of the Microsoft Customer Agreement, create a REST request to retrieve the DirectSignedCustomerAgreementStatus for the customer.

Sintaxis de la solicitudRequest syntax

Use la siguiente sintaxis de solicitud:Use the following request syntax:

MétodoMethod URI de solicitudRequest URI
GETGET * { BASEURL } */v1/customers/{customer-tenant-ID}/directSignedMicrosoftCustomerAgreementStatus http/1.1{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Parámetros de URIURI parameters

Puede usar los siguientes parámetros de URI con la solicitud:You can use the following URI parameters with your request:

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-tenant-idcustomer-tenant-id GUIDGUID Yes El valor es un CustomerTenantId con formato de GUID que le permite especificar el identificador de inquilino de un cliente.The value is a GUID-formatted CustomerTenantId that allows you to specify the tenant ID of a customer.

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplo de solicitudRequest example

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: ab993325-1605-4cf4-bac4-fb584142a31b

Respuesta RESTREST response

Si es correcto, este método devuelve un recurso DirectSignedCustomerAgreementStatus en el cuerpo de la respuesta.If successful, this method returns a DirectSignedCustomerAgreementStatus resource in the response body.

El recurso tiene una propiedad isSigned que indica el estado de la firma directa del cliente (aceptación directa).The resource has an isSigned property that indicates the customer's direct signing (direct acceptance) status.

  • Un valor de true indica que el cliente ha firmado (aceptado) el acuerdo directamente.A value of true indicates that the agreement has been signed (accepted) directly by the customer.

  • Un valor de false indica que el cliente no ha firmado (aceptado) directamente el acuerdo.A value of false indicates that the agreement has not been signed (accepted) directly by the customer.

Códigos de error y de respuesta correctosResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information.

Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.For the full list, see Partner Center REST error codes.

Ejemplo de respuestaResponse example

HTTP/1.1 200 OK
Content-Length: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

{"isSigned":true}