Получение метаданных для соглашения об использовании Microsoft Cloud

  • Статья

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

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

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

Клиентское соглашение Майкрософт заменил соглашение Microsoft Cloud с 2021 г. Если клиент ранее подписал соглашение Microsoft Cloud, его последний известный журнал соглашений будет доступен в дополнение к журналу Клиентское соглашение Майкрософт.

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

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

    Внимание

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

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

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

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

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

Чтобы получить метаданные соглашения для Соглашения Microsoft Cloud, выполните следующие действия.

  1. Сначала получите коллекцию IAggregatePartner.AgreementDetails .

  2. Вызов метода ByAgreementType для фильтрации коллекции в Microsoft Cloud Agreement.++++++++++++++++++++++++

  3. Наконец, вызовите метод Get или GetAsync .

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCloudAgreement";

var microsoftCloudAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();

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

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

Чтобы получить метаданные соглашения для соглашения Microsoft Cloud, выполните следующие действия.

Сначала извлеките коллекцию IAggregatePartner.AgreementDetails, а затем вызовите методы Get или GetAsync. Затем найдите элемент в коллекции, соответствующий соглашению Microsoft Cloud:

// IAggregatePartner partnerOperations;

var agreements = partnerOperations.AgreementDetails.Get();

AgreementMetaData microsoftCloudAgreement = agreements.Items.FirstOrDefault (agr => agr.AgreementType == AgreementType.MicrosoftCloudAgreement);

Java

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

Чтобы получить метаданные соглашения для соглашения Microsoft Cloud, выполните следующие действия.

Сначала вызовите функцию IAggregatePartner.getAgreementDetails , а затем вызовите функцию get . Затем найдите элемент в коллекции, соответствующий соглашению Microsoft Cloud:

// IAggregatePartner partnerOperations;

ResourceCollection<AgreementMetaData> agreements = partnerOperations.getAgreements().get();

AgreementMetaData microsoftCloudAgreement;

for (AgreementMetaData metadata : agreements)
{
    if(metadata.getAgreementType() == AgreementType.MicrosoftCloudAgreement)
    {
        microsoftCloudAgreement = metadata;
    }
}

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

PowerShell

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

Чтобы получить метаданные соглашения для соглашения Microsoft Cloud, выполните следующие действия.

Используйте команду Get-PartnerAgreementDetail. Затем найдите элемент в коллекции, соответствующий соглашению Microsoft Cloud:

Get-PartnerAgreementDetail | Where-Object {$_.AgreementType -eq 'MicrosoftCloudAgreement'} | Select-Object -First 1

Запрос REST

Чтобы получить метаданные соглашения для Соглашения Microsoft Cloud, сначала создайте запрос REST для получения коллекции AgreementMetaData . Затем найдите элемент в коллекции, соответствующей соглашению Microsoft Cloud.

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

Способ URI запроса
GET {baseURL}/v1/agreements HTTP/1.1

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

Используйте следующие параметры URI с запросом:

Имя. Type Обязательно Описание
тип соглашения строка Нет Используйте этот параметр, чтобы область ответ запроса на конкретный тип соглашения. Поддерживаемые значения:

MicrosoftCloudAgreement, включающая метаданные соглашения только типа MicrosoftCloudAgreement

MicrosoftCustomerAgreement, содержащий метаданные соглашения только типа MicrosoftCustomerAgreement.

* возвращает все метаданные соглашения. (Не используйте * , если в коде нет необходимой логики среды выполнения для обработки незнакомых типов соглашений, так как корпорация Майкрософт может в любое время вводить метаданные соглашения с новыми типами соглашений.)

Примечание. Если параметр URI не указан, запрос по умолчанию используется в MicrosoftCloudAgreement для обратной совместимости.

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

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

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

Нет.

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

GET https://api.partnercenter.microsoft.com/v1/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

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

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

Каждый ответ содержит код состояния 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": 1,
    "items": [
        {
            "templateId": "998b88de-aa99-4388-a42c-1b3517d49490",
            "agreementType": "MicrosoftCloudAgreement",
            "agreementLink": "https://learn.microsoft.com/partner-center/agreements",
            "versionRank": 0
        }
    ],
    "links": {
        "self": {
            "uri": "/agreements",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

Чтобы определить ресурс в ответе, соответствующий соглашению Microsoft Cloud, найдите ресурс, свойство agreementType которого имеет значение MicrosoftCloudAgreement.