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

Статья
03/08/2024

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

Вне области применения: Центр партнеров, управляемый 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: aaaa0000-bb11-2222-33cc-444444dddddd

Ответ 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: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}

Поделиться через