Uppdatera en tjänstbegäran

Artikel
07/09/2024

Gäller för: Partnercenter | Partnercenter för Microsoft Cloud for US Government

Så här uppdaterar du en befintlig kundtjänstbegäran som en molnlösningsleverantör har lämnat in till Microsoft för kundens räkning.

I Partnercenter kan den här åtgärden utföras genom att först välja en kund. Välj sedan Tjänstbegäranden i det vänstra sidofältet följt av den aktuella tjänstbegäran. Slutför genom att göra önskade ändringar i tjänstbegäran och sedan välja Skicka.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med app+användarautentiseringsuppgifter.
Ett ID för tjänstbegäran.

C#

Om du vill uppdatera en kunds tjänstbegäran anropar du metoden IServiceRequestCollection.ById med tjänstbegärans-ID:t för att identifiera och returnera gränssnittet för tjänstbegäran. Anropa sedan metoden IServiceRequest.Patch eller PatchAsync för att uppdatera tjänstbegäran. Om du vill ange de uppdaterade värdena skapar du ett nytt, tomt ServiceRequest-objekt och anger endast de egenskapsvärden som du vill ändra. Skicka sedan objektet i anropet till metoden Patch eller PatchAsync.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;

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

Exempel: Konsoltestapp. Projekt: Exempelklass för Partnercenter SDK: UpdatePartnerServiceRequest.cs

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
PATCH	{baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1

URI-parameter

Använd följande URI-parameter för att uppdatera tjänstbegäran.

Namn	Typ	Obligatorisk	Beskrivning
servicerequest-id	Guid	Y	Ett GUID som identifierar tjänstbegäran.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Begärandetexten ska innehålla en ServiceRequest-resurs . De enda obligatoriska värdena är de som ska uppdateras.

Exempel på begäran

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-svar

Om det lyckas returnerar den här metoden en resurs för tjänstbegäran med uppdaterade egenskaper i svarstexten.

Lyckade svar och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.

Exempel på svar

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

Dela via