Actualizar una solicitud de servicio

Artículo
07/09/2024

Se aplica a: Centro de partners | Centro de partners para Microsoft Cloud for US Government

Cómo actualizar una solicitud de servicio al cliente existente que un proveedor de soluciones en la nube ha presentado con Microsoft en nombre del cliente.

En el Centro de partners, esta operación se puede realizar seleccionando primero un cliente. A continuación, seleccione Solicitudes de servicio en la barra lateral izquierda seguida de seleccionar la solicitud de servicio en cuestión. Para finalizar, realice los cambios deseados en la solicitud de servicio y seleccione Enviar.

Requisitos previos

Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.
Un identificador de solicitud de servicio.

C#

Para actualizar la solicitud de servicio de un cliente, llame al método IServiceRequestCollection.ById con el identificador de solicitud de servicio para identificar y devolver la interfaz de solicitud de servicio. A continuación, llame al método IServiceRequest.Patch o PatchAsync para actualizar la solicitud de servicio. Para proporcionar los valores actualizados, cree un nuevo objeto ServiceRequest vacío y establezca solo los valores de propiedad que desea cambiar. A continuación, pase ese objeto en la llamada al método Patch o PatchAsync.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;

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

Ejemplo: Aplicación de prueba de consola. Project: Clase de ejemplos del SDK del Centro de partners: UpdatePartnerServiceRequest.cs

Solicitud REST

Sintaxis de la solicitud

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

Parámetro de URI

Use el siguiente parámetro de URI para actualizar la solicitud de servicio.

Nombre	Tipo	Obligatorio	Descripción
servicerequest-id	guid	Y	GUID que identifica la solicitud de servicio.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

El cuerpo de la solicitud debe contener un recurso ServiceRequest . Los únicos valores necesarios son los que se van a actualizar.

Ejemplo de solicitud

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

Respuesta REST

Si se ejecuta correctamente, este método devuelve un recurso de solicitud de servicio con propiedades actualizadas en el cuerpo de la respuesta.

Códigos de error y de respuesta correctos

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. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error de REST del Centro de partners.

Ejemplo de respuesta

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

Compartir vía