Obtenha o estado da assinatura direta de um cliente (aceitação direta) de Contrato de Cliente Microsoft

  • Artigo
  • 2 minutos para ler

Aplica-se a: Centro de Parceiros

Não se aplica a: Partner Center operado pela 21Vianet | Centro de Parceiros para Microsoft Cloud for US Government

O recurso DirectSignedCustomerAgreementStatus é atualmente suportado pelo Partner Center apenas na nuvem pública da Microsoft.

Este artigo explica como pode recuperar o estado da aceitação direta do Contrato de Cliente Microsoft por parte de um cliente.

Pré-requisitos

  • Credenciais descritas na autenticação do Partner Center. Este cenário suporta a autenticação apenas com credenciais app+Utilizador.

  • Uma ID do cliente (customer-tenant-id). Se não souber a identificação do cliente, pode procurar no painel do Centro de Parceiros. Selecione CSP no menu Partner Center, seguido por Clientes. Selecione o cliente da lista de clientes e, em seguida, selecione Conta. Na página conta do cliente, procure o ID da Microsoft na secção Informação da Conta do Cliente . O ID da Microsoft é o mesmo que o ID do cliente (customer-tenant-id).

C#

Para recuperar o estado da aceitação direta do Contrato de Cliente Microsoft por parte do cliente, ligue para o método IAggregatePartner.Customers.ById com o identificador do cliente. Em seguida, use a propriedade Agreements para recuperar uma interface ICustomerAgreementCollection . Finalmente, ligue GetDirectSignedCustomerAgreementStatus() ou GetDirectSignedCustomerAgreementStatusAsync() recupere o estado.

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

Amostra: App de amostra de consola. Projeto: Classe SdkSamples : GetDirectSignedCustomerAgreementStatus.cs

Pedido de DESCANSO

Para recuperar o estado da aceitação direta do Contrato de Cliente Microsoft por parte do cliente, crie um pedido DEE para recuperar o DirectSignedCustomerAgreementStatus para o cliente.

Solicitar sintaxe

Utilize a seguinte sintaxe de pedido:

Método URI do pedido
GET {baseURL}/v1/clientes/{customer-tenant-id}/directSignedMicrosoftCustomagreementStatus HTTP/1.1

Parâmetros URI

Pode utilizar os seguintes parâmetros URI com o seu pedido:

Nome Tipo Necessário Descrição
cliente-inquilino-id GUID Yes O valor é um CustomerTenantId formatado pelo GUID que lhe permite especificar o ID do inquilino de um cliente.

Cabeçalhos do pedido

Para obter mais informações, consulte os cabeçalhos Partner Center REST.

Corpo do pedido

Nenhum.

Exemplo de pedido

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

Resposta do REST

Se for bem sucedido, este método devolve um recurso DirectSignedCustomerAgreementStatus no organismo de resposta.

O recurso tem uma propriedade assinada que indica o estado de assinatura direta do cliente (aceitação direta).

  • Um valor verdadeiro indica que o acordo foi assinado (aceite) diretamente pelo cliente.

  • Um valor de falso indica que o contrato não foi assinado (aceite) diretamente pelo cliente.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de estado HTTP que indica sucesso ou falha e informações adicionais de depuragem.

Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte os códigos de erro do Partner Center REST.

Exemplo de resposta

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}