根据 PartnerID 获取客户的订阅
适用于：合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心
如何获取给定的 Microsoft AI 云合作伙伴计划合作伙伴提供给指定客户的订阅列表。
先决条件
合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和 App+User 凭据进行身份验证。
客户 ID (
customer-tenant-id)。 如果不知道客户的 ID，可以通过选择“客户”工作区，然后从客户列表中选择客户，然后选择“帐户”，在合作伙伴中心中查找该 ID。 在客户的“帐户”页上的“客户帐户信息”部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id) 相同。A PartnerID
C#
若要获取给定合作伙伴提供给指定客户的订阅列表，请先使用 具有客户 ID 的 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
合作伙伴中心 Java SDK 可用于管理合作伙伴中心资源。 它是由合作伙伴社区维护的开源项目，不受 Microsoft 正式支持。 如果遇到问题，可以从社区获取帮助或在 GitHub 上创建问题。
若要获取给定合作伙伴提供给指定客户的订阅列表，请先使用 IAggregatePartner.getCustomers.byId 函数和客户 ID 来标识客户。 然后从 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 命令。 指定客户 ID 以使用 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 参数
使用以下路径和查询参数来标识客户和合作伙伴。
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| customer-id | 字符串 | 是 | 标识客户的 GUID 格式字符串。 |
| mpn-id | int | 是 | 标识合作伙伴的 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" }
}