Получение состояния прямого подписания клиента (прямое принятие) Клиентское соглашение Майкрософт

  • Статья

Область применения: Центр партнеров

Вне области применения: Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government

Ресурс DirectSignedCustomerAgreementStatus в настоящее время поддерживается Центром партнеров только в общедоступном облаке Майкрософт.

В этой статье объясняется, как получить статус прямого принятия клиентом Клиентское соглашение Майкрософт.

Необходимые компоненты

  • Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает только проверку подлинности с использованием учетных данных приложений и пользователей.

  • Идентификатор клиента (customer-tenant-id). Если вы не знаете идентификатор клиента, его можно найти в Центре партнеров, выбрав рабочую область "Клиенты" , затем клиент из списка клиентов, а затем учетная запись. На странице "Учетная запись клиента" найдите идентификатор Майкрософт в разделе "Сведения о учетной записи клиента". Идентификатор Майкрософт совпадает с идентификатором клиента (customer-tenant-id).

C#

Чтобы получить состояние прямого принятия клиентом Клиентское соглашение Майкрософт, вызовите метод IAggregatePartner.Customers.ById с идентификатором клиента. Затем используйте свойство Agreements для получения интерфейса ICustomerAgreementCollection. Наконец, вызов GetDirectSignedCustomerAgreementStatus() или GetDirectSignedCustomerAgreementStatusAsync() получение состояния.

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

Пример: пример консольного приложения. Проект: класс SdkSamples: GetDirectSignedCustomerAgreementStatus.cs

Запрос REST

Чтобы получить состояние прямого принятия клиентом Клиентское соглашение Майкрософт, создайте запрос REST для получения DirectSignedCustomerAgreementStatus для клиента.

Синтаксис запроса

Используйте следующий синтаксис запроса:

Способ URI запроса
GET {baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Параметры универсального кода ресурса (URI)

С запросом можно использовать следующие параметры URI:

Имя. Type Обязательно Описание
customer-tenant-id GUID Да Значением является идентификатор клиента с форматом GUID CustomerTenantId , который позволяет указать идентификатор клиента.

Заголовки запросов

Дополнительные сведения см. в статье о заголовках REST Центра партнеров.

Текст запроса

Нет.

Пример запроса

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

Ответ REST

В случае успешного выполнения этот метод возвращает ресурс DirectSignedCustomerAgreementStatus в тексте ответа.

Ресурс имеет свойство isSigned , указывающее состояние прямого подписания (прямого принятия) клиента.

  • Значение true указывает, что соглашение было подписано (принято) непосредственно клиентом.

  • Значение false указывает, что соглашение не было подписано (принято) непосредственно клиентом.

Коды успешного выполнения и ошибок в ответе

Каждый ответ поставляется с кодом состояния HTTP, который указывает на успешность или сбой и дополнительные сведения об отладке.

Используйте средство трассировки сети для чтения этого кода, типа ошибки и других параметров. Полный список ответов есть в статье Коды ошибок REST в Центре партнеров.

Пример ответа

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}