Obtenir les détails de la demande de service par ID

Article
05/28/2024

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

Comment récupérer les détails d’une demande de service client existante à l’aide de l’identificateur de demande de service.

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 récupérer les détails d’une demande de service client existante, appelez la méthode IServiceRequestCollection.ById et transmettez un ServiceRequest.Id pour identifier et renvoyer une interface à l’objet ServiceRequest spécifique.

// 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,
));

Demande REST

Syntaxe de la requête

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

Paramètre d’URI

Utilisez le paramètre d’URI suivant pour obtenir la demande de service spécifiée.

Nom	Type	Obligatoire	Description
servicerequest-id	string	O	Valeur alphanumérique qui identifie la demande de service.

En-têtes de demande

Nom	Type	Obligatoire	Description
IncludeOrganizationRequests	string	N	En-tête qui, lorsqu’il est présent, autorise l’utilisateur pour le rôle de demande de support Administration rôle avant d’essayer d’obtenir les détails de la demande de service.

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

Corps de la demande

Aucune

Exemple de requête

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: fd969070-4e5f-4c6b-a3c6-1941283b39ae
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 0

Réponse REST

Si elle réussit, cette méthode retourne une ressource de demande de service 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: fd969070-4e5f-4c6b-a3c6-1941283b39ae
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": "3b33e682-00c3-41ee-9dd2-a548adf56438",
        "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