Abrufen der verwalteten Dienste für einen Kunden nach ID

Gilt für: Partner Center | Partner Center für die Microsoft-Cloud für die US-Regierung

Ruft die verwalteten Dienste für einen Kunden ab. Mit anderen Worten: Rufen Sie Links zu allen Abonnements des Kunden ab, für die Sie Administratorrechte delegiert haben. Sie können diese Links verwenden, um Support- und Dateiserviceanfragen an Microsoft zu stellen.

Voraussetzungen

• Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Authentifizierung mit App- und Benutzeranmeldedaten.

• Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden auswählen, dann den Kunden aus der Kundenliste und anschließend Konto. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).

C#

Um eine Liste aller verwalteten Dienste für einen Kunden anzuzeigen, verwenden Sie Ihre IAggregatePartner.Customers-Auflistung , und rufen Sie die ById()- Methode auf. Rufen Sie dann die ManagedServices-Eigenschaft auf, gefolgt von der Get()- Methode oder der GetAsync()- Methode.

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

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

Beispiel: Konsolentest-App. Projekt: PartnerCenterSDK.FeaturesSamples Klasse: CustomerManagedServices.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
ERHALTEN	{baseURL}/v1/customers/{customer-tenant-id}/managedservices HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um die verwalteten Dienste des Kunden abzurufen.

Name	Typ	Erforderlich	BESCHREIBUNG
Kunden-Mieter-ID	GUID	Ja	Eine GUID für den Kunden.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center REST-Header.

Anfragekörper

Keiner.

Beispielanfrage

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

REST-Antwort

Wenn diese Methode erfolgreich ist, gibt sie eine Auflistung von Managed Service-Objekten im Antworttext zurück.

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Fehlercodes.

Antwortbeispiel

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