Mettre à jour une demande de service

Article
07/09/2024

S’applique à : Espace partenaires | Espace partenaires de Microsoft Cloud for US Government

Comment mettre à jour une demande de service client existante qu’un fournisseur de solutions cloud a déposée auprès de Microsoft pour le compte du client.

Dans l’Espace partenaires, cette opération peut être effectuée en sélectionnant d’abord un client. Ensuite, sélectionnez Demandes de service dans la barre latérale gauche, puis sélectionnez la demande de service en question. Pour terminer, apportez les modifications souhaitées à la demande de service, puis sélectionnez Envoyer.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.
ID de demande de service.

C#

Pour mettre à jour la demande de service d’un client, appelez la méthode IServiceRequestCollection.ById avec l’ID de demande de service pour identifier et retourner l’interface de demande de service. Appelez ensuite la méthode IServiceRequest.Patch ou PatchAsync pour mettre à jour la demande de service. Pour fournir les valeurs mises à jour, créez un objet ServiceRequest vide et définissez uniquement les valeurs de propriété que vous souhaitez modifier. Passez ensuite cet objet dans l’appel à la méthode Patch ou PatchAsync.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;

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

Exemple : application de test console. Projet : Classe d’exemples sdk de l’Espace partenaires : UpdatePartnerServiceRequest.cs

Demande REST

Syntaxe de la requête

Méthode	URI de demande
PATCH	{baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1

Paramètre d’URI

Utilisez le paramètre URI suivant pour mettre à jour la demande de service.

Nom	Type	Obligatoire	Description
servicerequest-id	guid	O	GUID qui identifie la demande de service.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

Le corps de la demande doit contenir une ressource ServiceRequest . Les seules valeurs requises sont celles à mettre à jour.

Exemple de requête

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

Réponse REST

Si elle réussit, cette méthode retourne une ressource de demande de service avec des propriétés mises à jour dans le corps de la réponse.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse

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

Partager via