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

Статья
01/02/2025

применимо к: Центр партнеров

не применяется к: Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud для государственных организаций США

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

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

Необходимые условия

Учетные данные, как описано в авторизации Центра партнеров. Этот сценарий поддерживает проверку подлинности только с учетными данными app+User.
Идентификатор клиента (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 Class: GetDirectSignedCustomerAgreementStatus.cs

Запрос REST

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

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

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

Метод	URI запроса
ПОЛУЧИТЬ	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Параметры URI

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

Имя	Тип	Обязательно	Описание
идентификатор клиента-арендатора	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}

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