分享方式：

取得客戶接受 Microsoft Cloud 合約的確認

  • 文章

適用於：合作夥伴中心

不適用：由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心

合作夥伴 中心目前僅支援 Microsoft 公用雲端中的合約 資源。

必要條件

.NET （1.4 版或更新版本）

若要擷取先前提供的客戶接受確認：

  • 使用 IAggregatePartner.Customers 集合，並使用指定的客戶標識符呼叫 ById 方法。

  • 藉由呼叫 ByAgreementType 方法，擷取 Agreements 屬性並篩選結果至 Microsoft Cloud 合約。

  • 呼叫 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: aaaa0000-bb11-2222-33cc-444444dddddd

REST 回應

如果成功，這個方法會在回應本文中傳回合約資源的集合。

回應成功和錯誤碼

每個回應都有一個 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@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"
        }
    ]
}