適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心
如何取得指定Microsoft AI Cloud Partner 計劃合作夥伴提供給指定客戶的訂用帳戶清單。
先決條件
合作夥伴中心驗證中所述的憑證。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶標識碼 （
customer-tenant-id）。 如果您不知道客戶的標識碼，您可以在 合作夥伴中心 檢視，首先選取 [客戶 工作區]，然後從客戶清單中選擇客戶，最後選擇 帳戶。 在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找 Microsoft ID。 Microsoft識別碼與客戶標識碼 （customer-tenant-id） 相同。A PartnerID
C#
若要取得指定合作夥伴提供給指定客戶的訂用帳戶清單，請先使用 IAggregatePartner.Customers.ById 方法來識別客戶。 然後從 Subscriptions 屬性取得客戶訂用帳戶集合作業的介面，並使用 PartnerID 呼叫 ByPartner 方法，以識別合作夥伴，並擷取合作夥伴訂用帳戶作業的介面。 最後，呼叫 Get 或 GetAsync 方法來取得集合。
// IAggregatePartner partnerOperations;
// string customerId;
// string partnerMpnId;
var customerSubscriptionsByMpnId = partnerOperations.Customers.ById(customerId).Subscriptions.ByPartner(partnerMpnId).Get();
範例：主控台測試應用程式。 專案：合作夥伴中心 SDK 範例 類別:GetSubscriptionsByMpnid.cs
爪哇島
合作夥伴中心 Java SDK 可用來管理合作夥伴中心資源。 這是合作夥伴社群維護的開放原始碼專案，Microsoft未正式支援。 如果您遇到問題，您可以 從社群 取得協助，或 在 GitHub 上提出問題。
若要取得指定合作夥伴提供給指定客戶的訂用帳戶清單，請先使用 IAggregatePartner.getCustomers.byId 函式搭配客戶標識符來識別客戶。 然後從 getSubscriptions 函式取得客戶訂用帳戶集合作業的介面，並使用 PartnerID 呼叫 byPartner 函式，以識別合作夥伴，並擷取合作夥伴訂用帳戶作業的介面。 最後，呼叫 get 函式以取得集合。
// IAggregatePartner partnerOperations;
// String customerId;
// String partnerMpnId;
ResourceCollection<Subscription> customerSubscriptionsByMpnId = partnerOperations.getCustomers().byId(customerId).getSubscriptions().byPartner(partnerMpnId).get();
PowerShell
合作夥伴中心 PowerShell 模組 可用來管理合作夥伴中心資源。 這是合作夥伴社群維護的開放原始碼專案，Microsoft未正式支援。 如果您遇到問題，您可以 從社群 取得協助，或 在 GitHub 上提出問題。
若要取得指定合作夥伴提供給指定客戶的訂用帳戶清單，請執行 get-PartnerCustomerSubscription命令。 指定客戶標識碼，以使用 CustomerId 參數來識別客戶，並使用 PartnerID 填入 MpnId 參數，以識別合作夥伴。
# $customerId
# $partnerMpnId
Get-PartnerCustomerSubscription -CustomerId $customerId -MpnId $partnerMpnId
REST 要求
要求語法
| 方法 | 要求 URI |
|---|---|
| GET | {baseURL}/v1/customers/{customer-id}/subscriptions？mpn_id={mpn-id} HTTP/1.1 |
URI 參數
使用下列路徑和查詢參數來識別客戶和合作夥伴。
| 名字 | 類型 | 必填 | 描述 |
|---|---|---|---|
| 客戶編號 | 字串 | 是的 | 識別客戶的 GUID 格式化字串。 |
| mpn-id | 整數 | 是的 | 識別合作夥伴的 PartnerID。 |
要求標頭欄位
如需詳細資訊，請參閱 合作夥伴中心 REST 標頭。
請求主體
沒有。
要求範例
GET https://api.partnercenter.microsoft.com/v1/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/subscriptions?mpn_id=4847383 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: f98d0f61-01da-4d27-a923-8ec1e46e7358
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive
REST 回應
如果成功，回應主體將包含 訂用帳戶 資源的集合。
回應成功和錯誤碼
每個回應都有一個 HTTP 狀態代碼，指出成功或失敗和其他偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。 如需完整清單，請參閱 合作夥伴中心 REST 錯誤碼。
回應範例
HTTP/1.1 200 OK
Content-Length: 985
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: f98d0f61-01da-4d27-a923-8ec1e46e7358
Date: Thu, 13 Apr 2024 20:58:08 GMT
{
"totalCount": 2,
"items": [
{
"id": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"offerId": "DB2E705F-B82A-4024-A3D5-D88E12F2DB35",
"offerName": "Intune Device",
"friendlyName": "new offer purchase",
"quantity": 5,
"unitType": "Licenses",
"creationDate": "2024-04-10T23:02:26.02Z",
"effectiveStartDate": "2024-04-10T00:00:00Z",
"commitmentEndDate": "2025-05-07T00:00:00Z",
"status": "active",
"autoRenewEnabled": true,
"isTrial": false,
"billingType": "license",
"billingCycle": "monthly",
"partnerId": "4847383",
"contractType": "subscription",
"links": {
"offer": {
"uri": "/offers/DB2E705F-B82A-4024-A3D5-D88E12F2DB35?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"method": "GET",
"headers": []
}
},
"orderId": "3EDDCAC6-63B2-4C40-B0B6-F47E18301492",
"attributes": {
"etag": "eyJpZCI6IjQyMjI2ZWQ2LTA3MGEtNGUwZi1iODBjLTRjZGZiM2U5N2FhNyIsInZlcnNpb24iOjF9",
"objectType": "Subscription"
}
},
{
"id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"offerId": "CFQ7TTC0LH18:0001:CFQ7TTC0P0WS",
"offerName": "Microsoft 365 Business Basic",
"friendlyName": "Microsoft 365 Business Basic",
"productType": {
"id": "OnlineServicesNCE",
"displayName": "OnlineServicesNCE"
},
"quantity": 2,
"unitType": "Licenses",
"hasPurchasableAddons": false,
"creationDate": "2024-06-05T19:26:38.3667635Z",
"effectiveStartDate": "2024-06-05T00:00:00Z",
"commitmentEndDate": "2024-07-04T00:00:00Z",
"commitmentEndDateTime": "2024-07-04T23:59:59Z",
"cancellationAllowedUntilDate": "2024-06-12T19:27:03.440527Z",
"billingCycleEndDate": "2024-07-04T00:00:00Z",
"billingCycleEndDateTime": "2024-07-04T23:59:59Z",
"status": "active",
"autoRenewEnabled": true,
"isTrial": false,
"billingType": "license",
"billingCycle": "monthly",
"termDuration": "P1M",
"renewalTermDuration": "",
"isMicrosoftProduct": true,
"partnerId": "4847383",
"attentionNeeded": false,
"actionTaken": false,
"contractType": "subscription",
"links": {
"product": {
"uri": "/products/CFQ7TTC0LH18?country=US",
"method": "GET",
"headers": []
},
"sku": {
"uri": "/products/CFQ7TTC0LH18/skus/0001?country=US",
"method": "GET",
"headers": []
},
"availability": {
"uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0P0WS?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/subscriptions/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"method": "GET",
"headers": []
}
},
"publisherName": "Microsoft Corporation",
"refundableQuantity": {
"totalQuantity": 1,
"details": [
{
"quantity": 1,
"allowedUntilDateTime": "2024-06-14T17:41:13.4675407Z"
}
]
},
"orderId": "79d9f5e2f43a",
"attributes": {
"objectType": "Subscription"
}
}
],
"attributes": { "objectType": "Collection" }
}