Uzyskaj usługi zarządzane dla klienta według identyfikatora

Dotyczy: Centrum partnerskie | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Pobiera usługi zarządzane dla klienta. Innymi słowy, uzyskaj linki do wszystkich subskrypcji klienta, dla których masz delegowane uprawnienia administratora. Za pomocą tych linków można świadczyć pomoc techniczną i składać wnioski o usługi w firmie Microsoft.

Wymagania wstępne

• Poświadczenia opisane w sekcji Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu 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, następnie klienta z listy klientów, a na końcu Konto. Na stronie konta klienta poszukaj identyfikatora Microsoft w sekcji informacje o koncie klienta. Identyfikator Microsoftu to samo co identyfikator klienta (customer-tenant-id).

C#

Aby wyświetlić listę wszystkich usług zarządzanych dla klienta, użyj kolekcji IAggregatePartner.Customers i wywołaj metodę ById(). Następnie wywołaj właściwość ManagedServices, a następnie metody Get() lub GetAsync().

// IAggregatePartner partnerOperations;
// var selectedCustomerID as Customer;

ResourceCollection<ManagedService> managedServices = partnerOperations.Customers.ById(selectedCustomerId).ManagedServices.Get();

Przykład: testowa aplikacja konsoli. Projekt: PartnerCenterSDK.FeaturesSamples Klasa: CustomerManagedServices.cs

Żądanie REST

Składnia żądania

Metoda	Żądanie URI
POBIERZ	{baseURL}/v1/customers/{customer-tenant-id}/managedservices HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru zapytania, aby pobrać usługi zarządzane klienta.

Nazwa	Typ	Wymagane	Opis
identyfikator-klienta-najemcy	guid	Y	Identyfikator GUID odpowiadający klientowi.

Nagłówki zapytań

Aby uzyskać więcej informacji, zapoznaj się z Nagłówkami Centrum partnerskiego REST.

Ciało żądania

Żaden.

Przykład zapytania

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/managedservices HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4ff57220-f17b-4d8f-8e09-78334c57ba00
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Odpowiedź REST

Jeśli to się powiedzie, ta metoda zwraca kolekcję obiektów usługi zarządzanej w treści odpowiedzi.

Kody sukcesu i błędów w odpowiedziach

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.

Przykład odpowiedzi

HTTP/1.1 200 OK
Content-Length: 10588
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 4ff57220-f17b-4d8f-8e09-78334c57ba00
Date: Mon, 23 Nov 2015 18:02:12 GMT

{
    "totalCount": 2,
    "items": [{
        "id": "Exchange",
        "name": "Exchange",
        "groupName": "Office",
        "links": {
            "adminService": {
                "uri": "https://portal.office.com/Partner/BeginClientSession.aspx?CTID=<ctid>&CSDEST=Exchange&InitialDomain=<domain>&PrimaryDomain=<domain>",
                "method": "GET",
                "headers": []
            },
            "serviceHealth": {
                "uri": "https://portal.office.com/Partner/BeginClientSession.aspx?CTID=<ctid>&CSDEST=ServiceStatus",
                "method": "GET",
                "headers": []
            },
            "serviceTicket": {
                "uri": "https://portal.office.com/Partner/BeginClientSession.aspx?CTID=<ctid>&CSDEST=Support",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "ManagedService"
        }
    },
    {
        "id": "MicrosoftCommunicationsOnline",
        "name": "SkypeforBusiness",
        "groupName": "Office",
        "links": {
            "adminService": {
                "uri": "https://portal.office.com/Partner/BeginClientSession.aspx?CTID=<ctid>&CSDEST=MicrosoftCommunicationsOnline",
                "method": "GET",
                "headers": []
            },
            "serviceHealth": {
                "uri": "https://portal.office.com/Partner/BeginClientSession.aspx?CTID=<ctid>&CSDEST=ServiceStatus",
                "method": "GET",
                "headers": []
            },
            "serviceTicket": {
                "uri": "https://portal.office.com/Partner/BeginClientSession.aspx?CTID=<ctid>&CSDEST=Support",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "ManagedService"
        }
    }