Erstellen einer Serviceanfrage

Artikel
07/09/2024

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

Hier erfahren Sie, wie Sie eine vorhandene Kundendienstanforderung aktualisieren, die ein Cloudlösungsanbieter im Namen des Kunden bei Microsoft eingereicht hat.

In Partner Center kann dieser Vorgang ausgeführt werden, indem zuerst ein Kunde ausgewählt wird. Wählen Sie dann auf der linken Randleiste Dienstanforderungen aus, gefolgt von der betreffenden Dienstanforderung. Nehmen Sie zum Abschluss die gewünschten Änderungen an der Dienstanforderung vor, und wählen Sie dann Übermitteln aus.

Voraussetzungen

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

C#

Um die Serviceanfrage eines Kunden zu aktualisieren, rufen Sie die IServiceRequestCollection.ById-Methode mit der Dienstanforderungs-ID auf, um die Dienstanforderungsschnittstelle zu identifizieren und zurückzugeben. Rufen Sie dann die IServiceRequest.Patch - oder PatchAsync-Methode auf, um die Dienstanforderung zu aktualisieren. Um die aktualisierten Werte bereitzustellen, erstellen Sie ein neues, leeres ServiceRequest-Objekt , und legen Sie nur die Eigenschaftswerte fest, die Sie ändern möchten. Übergeben Sie dieses Objekt dann im Aufruf der Patch- oder PatchAsync-Methode.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;

ServiceRequest updatedServiceRequest = partnerOperations.ServiceRequests.ById(existingServiceRequest.Id).Patch(new ServiceRequest
{
   NewNote = note
});

Beispiel: Konsolentest-App. Project: Partner Center SDK Samples Class: UpdatePartnerServiceRequest.cs

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Verwenden Sie den folgenden URI-Parameter, um die Dienstanforderung zu aktualisieren.

Name	Typ	Erforderlich	BESCHREIBUNG
servicerequest-id	guid	J	Eine GUID, die die Dienstanforderung identifiziert.

Anforderungsheader

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

Anforderungstext

Der Anforderungstext sollte eine ServiceRequest-Ressource enthalten. Die einzigen erforderlichen Werte sind diejenigen, die aktualisiert werden sollen.

Anforderungsbeispiel

PATCH 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: 508
Expect: 100-continue

{
    "Id": null,
    "Title": null,
    "Description": null,
    "Severity": "unknown",
    "SupportTopicId": null,
    "SupportTopicName": null,
    "Status": "none",
    "Organization": null,
    "PrimaryContact": null,
    "LastUpdatedBy": null,
    "ProductName": null,
    "ProductId": null,
    "CreatedDate": "0001-01-01T00:00:00",
    "LastModifiedDate": "0001-01-01T00:00:00",
    "LastClosedDate": "0001-01-01T00:00:00",
    "NewNote": {
        "CreatedByName": null,
        "CreatedDate": null,
        "Text": "Sample Note"
    },
    "Notes": null,
    "CountryCode": null,
    "FileLinks": null,
    "Attributes": {
        "ObjectType": "ServiceRequest"
    }
}

REST-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine Service Request-Ressource mit aktualisierten Eigenschaften 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.

Antwortbeispiel

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