Aggiornare una richiesta di servizio

Articolo
07/09/2024

Si applica a: Centro per i partner | Centro per i partner per Microsoft Cloud for US Government

Come aggiornare una richiesta del servizio clienti esistente che un provider di soluzioni cloud ha archiviato con Microsoft per conto del cliente.

Nel Centro per i partner è possibile eseguire questa operazione selezionando prima un cliente. Selezionare quindi Richieste di servizio sulla barra laterale sinistra seguita selezionando la richiesta di servizio in questione. Per completare, apportare le modifiche desiderate alla richiesta di servizio e quindi selezionare Invia.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.
ID richiesta di servizio.

C#

Per aggiornare la richiesta di servizio di un cliente, chiamare il metodo IServiceRequestCollection.ById con l'ID richiesta del servizio per identificare e restituire l'interfaccia della richiesta di servizio. Chiamare quindi il metodo IServiceRequest.Patch o PatchAsync per aggiornare la richiesta di servizio. Per fornire i valori aggiornati, creare un nuovo oggetto ServiceRequest vuoto e impostare solo i valori delle proprietà da modificare. Passare quindi l'oggetto nella chiamata al metodo Patch o PatchAsync.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;

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

Esempio: app di test della console. Project: Classe di esempi sdk del Centro per i partner: UpdatePartnerServiceRequest.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
PATCH	{baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1

Parametro URI

Usare il parametro URI seguente per aggiornare la richiesta di servizio.

Nome	Tipo	Obbligatoria	Descrizione
servicerequest-id	guid	S	GUID che identifica la richiesta del servizio.

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Il corpo della richiesta deve contenere una risorsa ServiceRequest . Gli unici valori necessari sono quelli da aggiornare.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce una risorsa Richiesta di servizio con proprietà aggiornate nel corpo della risposta.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedere Codici di errore REST del Centro per i partner.

Esempio di risposta

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

Condividi tramite