Actualizar una solicitud de servicioUpdate a service request

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

Cómo actualizar una solicitud de servicio de atención al cliente existente que un proveedor de soluciones en la nube ha archivado con Microsoft en nombre del cliente.How to update an existing customer service request that a Cloud Solution Provider has filed with Microsoft on the customer's behalf.

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. En el encabezado solicitudes de soporte técnico , seleccione la solicitud de servicio en cuestión.Under the Support requests header, select the service request in question. Para finalizar, realice los cambios deseados en la solicitud de servicio y, a continuación, seleccione submit (enviar).To finish, make the desired changes to the service request then select Submit.

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.

  • IDENTIFICADOR de solicitud de servicio.A service request ID.

C#C#

Para actualizar la solicitud de servicio de un cliente, llame al método [IServiceRequestCollection. ById/dotnet/API/Microsoft.Store.partnercenter.servicerequests.iservicerequestcollection.byid) con el identificador de solicitud de servicio para identificar y devolver la interfaz de solicitud de servicio.To update a customer's service request, call the [IServiceRequestCollection.ById/dotnet/api/microsoft.store.partnercenter.servicerequests.iservicerequestcollection.byid) method with the service request id to identify and return the service request interface. A continuación, llame al método [IServiceRequest. patch/dotnet/API/Microsoft.Store.partnercenter.servicerequests.iservicerequest.patch) o [PatchAsync/dotnet/API/Microsoft.Store.partnercenter.servicerequests.iservicerequest.patchasync) para actualizar la solicitud de servicio.Then call the [IServiceRequest.Patch/dotnet/api/microsoft.store.partnercenter.servicerequests.iservicerequest.patch) or [PatchAsync/dotnet/api/microsoft.store.partnercenter.servicerequests.iservicerequest.patchasync) method to update the service request. Para proporcionar los valores actualizados, cree un nuevo objeto vacío [ServiceRequest/dotnet/API/Microsoft.Store.partnercenter.Models.servicerequests.servicerequest) y establezca solo los valores de propiedad que desee cambiar.To provide the updated values, create a new, empty [ServiceRequest/dotnet/api/microsoft.store.partnercenter.models.servicerequests.servicerequest) object and set only the property values that you want to change. A continuación, pase ese objeto en la llamada al método patch o PatchAsync.Then pass that object in the call to the Patch or PatchAsync method.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;

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

Ejemplo: aplicación de prueba de consola.Sample: Console test app. Proyecto: SDK del centro de Partners ( clase): UpdatePartnerServiceRequest.CSProject: Partner Center SDK Samples Class: UpdatePartnerServiceRequest.cs

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de solicitudRequest URI
PATCHPATCH {baseurl}/v1/servicerequests/{servicerequest-ID} http/1.1{baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1

Parámetro de URIURI parameter

Use el siguiente parámetro URI para actualizar la solicitud de servicio.Use the following URI parameter to update the service request.

NombreName TipoType ObligatorioRequired DescripciónDescription
identificador de servicerequestservicerequest-id guidguid YY GUID que identifica la solicitud de servicio.A GUID that identifies the service request.

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

El cuerpo de la solicitud debe contener un recurso ServiceRequest .The request body should contain a ServiceRequest resource. Los únicos valores obligatorios son los que se van a actualizar.The only required values are those to be updated.

Ejemplo de solicitudRequest example

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: fd969070-4e5f-4c6b-a3c6-1941283b39ae
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"
    }
}

Respuesta RESTREST response

Si es correcto, este método devuelve un recurso de solicitud de servicio con propiedades actualizadas en el cuerpo de la respuesta.If successful, this method returns a Service Request resource with updated properties 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 ver la lista completa, consulte los códigos de error de REST del centro de Partners.For the full list, see Partner Center REST Error Codes.

Ejemplo de respuestaResponse example

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