Uzyskaj subskrypcje klienta za pomocą identyfikatora PartnerID

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Jak uzyskać listę subskrypcji udostępnianych przez danego partnera programu Microsoft AI Cloud Partner Program dla określonego klienta.

Warunki wstępne

Poświadczenia opisane w uwierzytelnianiu w Centrum Partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i poświadczeń aplikacji i użytkownika.
Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w centrum partnerskim , wybierając obszar roboczy Klienci, a następnie klient z listy klientów, a następnie konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji informacje o koncie klienta . Identyfikator Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).
Identyfikator partnera

C#

Aby uzyskać listę subskrypcji udostępnianych przez danego partnera określonemu klientowi, najpierw użyj metody IAggregatePartner.Customers.ById z identyfikatorem klienta, aby zidentyfikować klienta. Następnie pobierz interfejs operacji zbierania subskrypcji klienta z właściwości Subscriptions i wywołaj metodę ByPartner z identyfikatorem PartnerID, aby zidentyfikować partnera i pobrać interfejs do operacji subskrypcji partnera. Na koniec wywołaj metodę Get lub GetAsync, aby pobrać kolekcję.

// IAggregatePartner partnerOperations;
// string customerId;
// string partnerMpnId;

var customerSubscriptionsByMpnId = partnerOperations.Customers.ById(customerId).Subscriptions.ByPartner(partnerMpnId).Get();

Przykładowy: aplikacja testowa konsoli. Projekt: Partner Center SDK Samples Klasa: GetSubscriptionsByMpnid.cs

Jawa

Zestaw Java SDK Centrum partnerskiego może służyć do zarządzania zasobami Centrum partnerskiego. Jest to projekt typu open source obsługiwany przez społeczność partnerów i nie jest oficjalnie obsługiwany przez firmę Microsoft. Jeśli wystąpi problem, możesz uzyskać pomoc od społeczności lub otworzyć problem w usłudze GitHub.

Aby uzyskać listę subskrypcji udostępnianych przez danego partnera określonemu klientowi, najpierw użyj funkcji IAggregatePartner.getCustomers.byId podając identyfikator klienta w celu zidentyfikowania klienta. Następnie uzyskaj interfejs do zbierania subskrypcji klientów za pomocą funkcji getSubscriptions i wywołaj funkcję byPartner z identyfikatorem PartnerID, aby zidentyfikować partnera oraz pobrać interfejs do operacji subskrypcji partnera. Na koniec wywołaj funkcję get, aby pobrać kolekcję.

// IAggregatePartner partnerOperations;
// String customerId;
// String partnerMpnId;

ResourceCollection<Subscription> customerSubscriptionsByMpnId = partnerOperations.getCustomers().byId(customerId).getSubscriptions().byPartner(partnerMpnId).get();

PowerShell

Moduł PowerShell Centrum Partnerskiego może służyć do zarządzania jego zasobami. Jest to projekt typu open source obsługiwany przez społeczność partnerów i nie jest oficjalnie obsługiwany przez firmę Microsoft. Jeśli wystąpi problem, możesz uzyskać pomoc od społeczności lub otworzyć problem w usłudze GitHub.

Aby uzyskać listę subskrypcji udostępnianych przez danego partnera określonemu klientowi, wykonaj polecenie Get-PartnerCustomerSubscription. Określ identyfikator klienta, aby zidentyfikować klienta przy użyciu parametru CustomerId, a następnie wypełnij parametr MpnId identyfikatorem PartnerID, aby zidentyfikować partnera.

# $customerId
# $partnerMpnId

Get-PartnerCustomerSubscription -CustomerId $customerId -MpnId $partnerMpnId

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
GET	{baseURL}/v1/customers/{customer-id}/subscriptions?mpn_id={mpn-id} HTTP/1.1

Parametry identyfikatora URI

Użyj następującej ścieżki i parametrów zapytania, aby zidentyfikować klienta i partnera.

Nazwa	Typ	Wymagane	Opis
identyfikator klienta	struna	Tak	Ciąg w formacie GUID identyfikujący klienta.
mpn-id	Int	Tak	PartnerID, który identyfikuje partnera.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST w Centrum partnerskim.

Treść żądania

Żaden.

Przykład żądania

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

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera zbiór zasobów typu Subskrypcja.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum Partnerskiego.

Przykład odpowiedzi

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" } 
}

Zobacz też

analiza Centrum partnerskiego — zasoby

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-03-07