获取客户接受 Microsoft 云协议的确认

  • 项目

适用于：合作伙伴中心

不适用于：由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心

协议资源目前仅在 Microsoft 公有云中受合作伙伴中心支持。

先决条件

  • 如果使用合作伙伴中心 .NET SDK，则需要版本 1.9 或更高版本。

    重要

    截至 2023 年 6 月，最新的合作伙伴中心 .NET SDK 版本 3.4.0 现已存档。 可以从 GitHub 下载 SDK 版本，以及包含有用信息的自述文件。

    建议合作伙伴继续使用合作伙伴中心 REST API。

  • 如果使用合作伙伴中心 Java SDK，则需要版本 1.8 或更高版本。

  • 合作伙伴中心身份验证中所述的凭据。 此方案仅支持应用 + 用户身份验证。

  • 客户 ID (customer-tenant-id)。 如果不知道客户的 ID，可以通过选择“客户”工作区，然后从客户列表中选择客户，然后选择“帐户”，在合作伙伴中心中查找该 ID。 在客户的“帐户”页上，在“客户帐户信息”部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id) 相同。

.NET （版本 1.4 或更高版本）

检索以前提供的客户接受确认信息：

  • 使用 IAggregatePartner.Customers 集合并调用具有指定客户标识符的 ById 方法。

  • 通过调用 ByAgreementType 方法提取 Agreements 属性并将结果筛选到 Microsoft 云协议。

  • 调用 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

合作伙伴中心 Java SDK 可用于管理合作伙伴中心资源。 它是由合作伙伴社区维护的开源项目，不受 Microsoft 正式支持。 如果遇到问题，可以从社区获取帮助或在 GitHub 上创建问题。

若要检索之前提供的客户接受确认，

使用 IAggregatePartner.getCustomers 函数，并使用指定的客户的标识符调用 byId 函数。 然后，获取 getAgreements 函数，然后调用 get 函数。

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

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

可以在控制台测试应用项目的 GetCustomerAgreements 类中找到完整的示例。

PowerShell

合作伙伴中心 PowerShell 模块可用于管理合作伙伴中心资源。 它是由合作伙伴社区维护的开源项目，不受 Microsoft 正式支持。 如果遇到问题，可以从社区获取帮助或在 GitHub 上创建问题。

若要检索之前提供的客户接受确认，

使用 Get-PartnerCustomerAgreement 命令。

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

REST 请求

若要检索之前提供的客户接受确认，请参阅以下说明。

使用相关的认证信息创建新的 协议 资源。

请求语法

方法 请求 URI
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

URI 参数

使用以下查询参数指定要确认的客户。

名称 类型​​ 必需 说明
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"
        }
    ]
}