De abonnementen van een klant op basis van PartnerID ophalen
Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid
Een lijst met abonnementen ophalen die worden geleverd door een bepaalde Microsoft AI Cloud Partner Program-partner voor een opgegeven klant.
Vereisten
Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een klant-id (
customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).Een partner-id
C#
Gebruik eerst de methode IAggregatePartner.Customers.ById met de klant-id om een lijst met abonnementen op te halen die door een bepaalde partner aan een bepaalde klant worden verstrekt. Haal vervolgens een interface op voor bewerkingen voor het verzamelen van klantabonnementen vanuit de eigenschap Abonnementen en roep de Methode ByPartner aan met de PartnerID om de partner te identificeren en een interface op te halen voor bewerkingen voor partnerabonnementen. Roep ten slotte de methode Get of GetAsync aan om de verzameling op te halen.
// IAggregatePartner partnerOperations;
// string customerId;
// string partnerMpnId;
var customerSubscriptionsByMpnId = partnerOperations.Customers.ById(customerId).Subscriptions.ByPartner(partnerMpnId).Get();
Voorbeeld: consoletest-app. Project: Partner Center SDK-voorbeeldenklasse: GetSubscriptionsByMpnid.cs
Java
De Partner Center Java SDK kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.
Gebruik eerst de functie IAggregatePartner.getCustomers.byId met de klant-id om een lijst met abonnementen op te halen die door een bepaalde partner aan een bepaalde klant worden verstrekt. Haal vervolgens een interface op voor bewerkingen voor het verzamelen van klantabonnementen van de functie getSubscriptions en roep de functie byPartner aan met de Partner-id om de partner te identificeren en een interface op te halen voor bewerkingen van partnerabonnementen. Roep tot slot de get-functie aan om de verzameling op te halen.
// IAggregatePartner partnerOperations;
// String customerId;
// String partnerMpnId;
ResourceCollection<Subscription> customerSubscriptionsByMpnId = partnerOperations.getCustomers().byId(customerId).getSubscriptions().byPartner(partnerMpnId).get();
PowerShell
De PowerShell-module partnercentrum kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.
Voer de opdracht Get-PartnerCustomerSubscription uit om een lijst met abonnementen op te halen die door een bepaalde partner aan een opgegeven klant worden verstrekt. Geef de klant-id op om de klant te identificeren met behulp van de parameter CustomerId en vul de MpnId-parameter in met de PartnerID om de partner te identificeren.
# $customerId
# $partnerMpnId
Get-PartnerCustomerSubscription -CustomerId $customerId -MpnId $partnerMpnId
REST-aanvraag
Aanvraagsyntaxis
| Methode | Aanvraag-URI |
|---|---|
| GET | {baseURL}/v1/customers/{customer-id}/subscriptions?mpn_id={mpn-id} HTTP/1.1 |
URI-parameters
Gebruik het volgende pad en queryparameters om de klant en partner te identificeren.
| Naam | Type | Vereist | Beschrijving |
|---|---|---|---|
| klant-id | string | Ja | Een tekenreeks met GUID-indeling die de klant identificeert. |
| mpn-id | int | Ja | Een PartnerID die de partner identificeert. |
Aanvraagheaders
Zie Rest-headers in Partnercentrum voor meer informatie.
Aanvraagtekst
Geen.
Aanvraagvoorbeeld
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-antwoord
Als dit lukt, bevat de hoofdtekst van het antwoord de verzameling abonnementsbronnen .
Geslaagde antwoorden en foutcodes
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.
Responsvoorbeeld
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" }
}