Abrufen von Serviceanfragendetails nach ID

Artikel
05/28/2024

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

So rufen Sie die Details einer vorhandenen Kundendienstanfrage mithilfe der Serviceanforderungs-ID ab.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Eine Serviceanforderungs-ID.

C#

Rufen Sie zum Abrufen der Details einer vorhandenen Kundendienstanfrage die IServiceRequestCollection.ById-Methode auf, und übergeben Sie eine ServiceRequest.Id, um eine Schnittstelle zum jeweiligen ServiceRequest-Objekt zu identifizieren und zurückzugeben.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest as ServiceRequest;

ServiceRequest serviceRequestDetails = partnerOperations.ServiceRequests.ById(existingServiceRequest.Id).Get();

Console.WriteLine(string.Format("The primary contact for the service request {0} is {1} {2}.",
    serviceRequestDetails.Title,
    serviceRequestDetails.PrimaryContact.FirstName,
    serviceRequestDetails.PrimaryContact.LastName,
));

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
GET	{baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden URI-Parameter, um die angegebene Dienstanforderung abzurufen.

Name	Type	Erforderlich	Beschreibung
servicerequest-id	string	J	Ein alphanumerischer Wert, der die Serviceanfrage identifiziert.

Anforderungsheader

Name	Type	Erforderlich	Beschreibung
IncludeOrganizationRequests	string	N	Ein Header, der den Benutzer bei Der Anwesenheit für die Rolle "Supportanfrage-Administrator" autorisiert, bevor versucht wird, Details zu Serviceanfragen zu erhalten.

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

Anforderungstext

None

Beispiel für eine Anfrage

GET https://api.partnercenter.microsoft.com/v1/servicerequests/616122292874576 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: f9a030bd-e492-4c1a-9c70-021f18234981
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 0

REST-Antwort

Bei erfolgreicher Ausführung gibt die Methode eine Dienstanforderungsressource 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 finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

HTTP/1.1 200 OK
Content-Length: 566
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: f9a030bd-e492-4c1a-9c70-021f18234981
MS-CV: rjLONPum/Uq94UQA.0
MS-ServerId: 030011719
Date: Mon, 09 Jan 2017 23:31:15 GMT

{
    "title": "TrialSR",
    "description": "Ignore this SR",
    "severity": "critical",
    "supportTopicId": "32444671",
    "supportTopicName": "Cannot manage my profile",
    "id": "616122292874576",
    "status": "open",
    "organization": {
        "id": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
        "name": "TEST_TEST_BugBash1"
    },
    "productId": "15960",
    "createdDate": "2016-12-22T20:31:17.24Z",
    "lastModifiedDate": "2017-01-09T23:31:15.373Z",
    "lastClosedDate": "0001-01-01T00:00:00",
    "notes": [{
            "createdByName": "Account",
            "createdDate": "2017-01-09T23:31:15.373",
            "text": "Sample Note"
        }
    ],
    "attributes": {
        "objectType": "ServiceRequest"
    }
}

Freigeben über