Abrufen aller Serviceanfragen für einen Kunden

Artikel
06/04/2024

Gilt für: Partner Center | Partner Center für Microsoft Cloud for US Government

Ruft alle Dienstanforderungen eines Kunden ab.

In Partner Center kann dieser Vorgang ausgeführt werden, indem zuerst ein Kunde ausgewählt wird. Wählen Sie dann auf der linken Seitenleiste Dienstverwaltung aus. Die Serviceanfragen des Kunden werden unter Supporttickets angezeigt.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
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 und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

C#

Um eine Liste aller Dienstanforderungen eines Kunden anzuzeigen, verwenden Sie Ihre IAggregatePartner.Customers-Auflistung , und rufen Sie die ById() -Methode auf. Rufen Sie dann die ServiceRequests-Eigenschaft auf, gefolgt von den Methoden Get() oder GetAsync().

// IAggregatePartner partnerOperations;
// string customerId as string;

ResourceCollection<ServiceRequest> serviceRequests = partnerOperations.Customers.ById(customerId).ServiceRequests.Get();

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

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/servicerequests HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um alle Dienstanforderungen für den Kunden abzurufen.

Name	Typ	Erforderlich	BESCHREIBUNG
customer-tenant-id	guid	J	Eine GUID, die dem Kunden entspricht.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Anforderungsbeispiel

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/servicerequests HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 53d5d48c-9693-46b6-8071-2eed07797d6c
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine Auflistung von Service Request-Ressourcen im Antworttext zurück.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. 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 Partner-API: REST-Fehlercodes.

Antwortbeispiel

HTTP/1.1 200 OK
Content-Length: 742
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 53d5d48c-9693-46b6-8071-2eed07797d6c
Date: Tue, 24 Nov 2015 07:19:21 GMT

{
    "totalCount": 1,
    "items": [{
        "title": "Test",
        "severity": 0,
        "id": "615112491169010",
        "status": 1,
        "primaryContact": {
            "lastName": "LastName",
            "firstName": "FirstName"
        },
        "createdDate": "2015-11-24T01:07:00.863",
        "lastModifiedDate": "2015-11-24T01:17:10.61",
        "lastClosedDate": "0001-01-01T00:00:00",
        "attributes": {
            "objectType": "ServiceRequest"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}

Freigeben über