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

Получение подтверждения принятия клиентом условий соглашения об использовании Microsoft Cloud

  • Статья

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

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

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

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

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

    Внимание

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

    Партнерам рекомендуется продолжать использовать REST API Центра партнеров.

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

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

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

.NET (версия 1.4 или более поздней версии)

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

  • Используйте коллекцию IAggregatePartner.Customers и вызовите метод ById с указанным идентификатором клиента.

  • Извлеките свойство Agreement и отфильтруйте результаты в Microsoft Cloud Agreement, вызвав метод ByAgreementType.

  • Вызов метода Get или GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

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

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

.NET (версия 1.9 – 1.13)

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

Используйте коллекцию IAggregatePartner.Customers и вызовите метод ById с указанным идентификатором клиента. Затем получите свойство Agreements , а затем вызовите методы Get или GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var agreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Get();

Java

Пакет SDK для Java центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. При необходимости вы можете получить помощь от сообщества или опубликовать проблему в GitHub.

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

Используйте функцию IAggregatePartner.getCustomers и вызовите функцию byId с указанным идентификатором клиента. Затем получите функцию getAgreements , а затем вызовите функцию get .

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

ResourceCollection<Agreement> agreements = partnerOperations.getCustomers().byId(selectedCustomerId).getAgreements().get();

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

PowerShell

Модуль PowerShell Центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. При необходимости вы можете получить помощь от сообщества или опубликовать проблему в GitHub.

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

Используйте команду Get-PartnerCustomerAgreement.

Get-PartnerCustomerAgreement -CustomerId '14876998-c0dc-46e6-9d0c-65a57a6c32ec'

Запрос REST

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

Создайте ресурс соглашения с соответствующими сведениями о сертификации.

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

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

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

Используйте следующий параметр запроса, чтобы указать клиента, который вы подтверждаете.

Имя. Type Обязательно Описание
CustomerTenantId GUID Y Это значение — это идентификатор GUID, отформатированный CustomerTenantId , который позволяет указать клиента.

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

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

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

Нет.

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

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

Ответ REST

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

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

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

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

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2018-07-28T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2017-08-01T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        }
    ]
}