Obtener todas las solicitudes de servicio de un clienteGet all service requests for a customer

Se aplica aApplies To

  • Centro de partnersPartner Center
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Obtiene todas las solicitudes de servicio de un cliente.Gets all of a customer's service requests.

En el panel del centro de Partners, esta operación se puede realizar seleccionando un clienteen primer lugar.In the Partner Center dashboard, this operation can be performed by first selecting a customer. A continuación, seleccione Administración de servicios en la barra lateral izquierda.Then, select Service management on the left sidebar. Las solicitudes de servicio del cliente se muestran en incidencias de soporte técnico.The customer's service requests are displayed under Support tickets.

Requisitos previosPrerequisites

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners.Credentials as described in Partner Center authentication. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.This scenario supports authentication with App+User credentials only.

  • Un id. de cliente (customer-tenant-id).A customer ID (customer-tenant-id). Si no conoces el identificador del cliente, puedes buscarlo en el panel del Centro de partners.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Selecciona CSP en el menú del Centro de partners, seguido de Clientes.Select CSP from the Partner Center menu, followed by Customers. En la lista de clientes, selecciona el cliente y, a continuación, elige Cuenta.Select the customer from the customer list, then select Account. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. El identificador de Microsoft es el mismo que el de cliente (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

C#C#

Para mostrar una lista de todas las solicitudes de servicio de un cliente, use la colección colección iaggregatepartner. customers y llame al método ById () .To display a list of all of a customer's service requests, use your IAggregatePartner.Customers collection and call the ById() method. A continuación, llame a la propiedad ServiceRequests , seguido de los métodos get () o GetAsync () .Then call the ServiceRequests property, followed by the Get() or GetAsync() methods.

// IAggregatePartner partnerOperations;
// string customerId as string;

ResourceCollection<ServiceRequest> serviceRequests = partnerOperations.Customers.ById(customerId).ServiceRequests.Get();

Ejemplo: aplicación de prueba de consola.Sample: Console test app. Proyecto: PartnerCenterSDK. FeaturesSamples ( clase): CustomerManagedServices.CSProject: PartnerCenterSDK.FeaturesSamples Class: CustomerManagedServices.cs

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/customers/{customer-tenant-ID}/servicerequests http/1.1{baseURL}/v1/customers/{customer-tenant-id}/servicerequests HTTP/1.1

Parámetro de URIURI parameter

Use el siguiente parámetro de consulta para obtener todas las solicitudes de servicio para el cliente.Use the following query parameter to get all service requests for the customer.

NombreName TipoType ObligatorioRequired DescripciónDescription
customer-tenant-idcustomer-tenant-id guidguid YY GUID correspondiente al cliente..A GUID corresponding to the customer..

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplo de solicitudRequest example

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/servicerequests HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 53d5d48c-9693-46b6-8071-2eed07797d6c
MS-CorrelationId: 998e31a1-3f17-4471-a9ee-7678dd72e033

Respuesta RESTREST response

Si es correcto, este método devuelve una colección de recursos de solicitud de servicio en el cuerpo de la respuesta.If successful, this method returns a collection of Service Request resources in the response body.

Códigos de error y de respuesta correctosResponse success and error codes

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulte Códigos de error.For the full list, see Error Codes.

Ejemplo de respuestaResponse example

HTTP/1.1 200 OK
Content-Length: 742
Content-Type: application/json
MS-CorrelationId: 998e31a1-3f17-4471-a9ee-7678dd72e033
MS-RequestId: 53d5d48c-9693-46b6-8071-2eed07797d6c
Date: Tue, 24 Nov 2015 07:19:21 GMT

{
    "totalCount": 1,
    "items": [{
        "title": "Test",
        "severity": 0,
        "id": "615112491169010",
        "status": 1,
        "primaryContact": {
            "lastName": "LastName",
            "firstName": "FirstName"
        },
        "createdDate": "2015-11-24T01:07:00.863",
        "lastModifiedDate": "2015-11-24T01:17:10.61",
        "lastClosedDate": "0001-01-01T00:00:00",
        "attributes": {
            "objectType": "ServiceRequest"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}