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

Статья
03/11/2025

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

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

В настоящее время ресурс соглашения поддерживается только в Центре партнерства в общедоступном облаке Microsoft.

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

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

Если вы используете пакет SDK для .NET для Центра партнеров, требуется версия 1.14 или более новая.

Важный

По состоянию на июнь 2023 г. последняя версия пакета SDK для .NET для Центра партнеров 3.4.0 теперь архивируется. Вы можете скачать релиз SDK с сайта GitHub, вместе с файлом README, который содержит полезные сведения.

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

.СЕТЬ

Чтобы получить подтверждение принятия клиентом, которое ранее было предоставлено:

Используйте коллекцию IAggregatePartner.Customers и вызовите метод ById с указанным идентификатором клиента.
Извлеките свойство соглашений и отфильтруйте результаты по типу "Клиентское соглашение Microsoft", вызвав метод ByAgreementType.
Вызовите метод Get или метод GetAsync.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Полный пример можно найти в классе GetCustomerAgreements из проекта консольного тестового приложения.

Запрос REST

Чтобы получить подтверждение принятия клиентом, которое ранее было предоставлено:

Создайте запрос REST, чтобы получить коллекцию соглашений для клиента.
Используйте параметр запроса agreementType для области результатов только клиентского соглашения Майкрософт.

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

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

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

Параметры URI

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

Имя	Тип	Обязательно	Описание
идентификатор клиента-арендатора	GUID	Да	Это значение в формате GUID CustomerTenantId, которое позволяет указать клиента.
тип соглашения	струна	Нет	Этот параметр возвращает все метаданные соглашения. Используйте этот параметр для области ответа запроса на определенный тип соглашения. Поддерживаемые значения: MicrosoftCloudAgreement, включающую только метаданные соглашения типа MicrosoftCloudAgreement. MicrosoftCustomerAgreement, которая включает только метаданные соглашения типа MicrosoftCustomerAgreement. , который возвращает все метаданные соглашения. (Не используйте , если код не имеет необходимой логики для обработки непредвиденных типов соглашений.) Примечание. Если параметр URI не указан, то по умолчанию запрос используется MicrosoftCloudAgreement для совместимости с предыдущими версиями. Корпорация Майкрософт может в любое время вводить метаданные соглашения с новыми типами соглашений.

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

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

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

Нет.

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

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Ответ REST

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

Коды успеха и ошибок ответов

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

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

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

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}

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