Atualizar um pedido de serviço

Artigo
07/09/2024

Aplica-se a: Centro de Parceiros | Centro de Parceiros para Microsoft Cloud for US Government

Como atualizar um pedido de suporte ao cliente existente que um Fornecedor de Soluções Cloud tenha apresentado à Microsoft em nome do cliente.

No Centro de Parceiros, esta operação pode ser efetuada ao selecionar primeiro um cliente. Em seguida, selecione Pedidos de serviço na barra lateral esquerda e, em seguida, selecione o pedido de serviço em questão. Para concluir, faça as alterações pretendidas ao pedido de serviço e, em seguida, selecione Submeter.

Pré-requisitos

Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação apenas com credenciais de Aplicação+Utilizador.
Um ID de pedido de serviço.

C#

Para atualizar o pedido de serviço de um cliente, chame o método IServiceRequestCollection.ById com o ID do pedido de serviço para identificar e devolver a interface de pedido de serviço. Em seguida, chame o método IServiceRequest.Patch ou PatchAsync para atualizar o pedido de serviço. Para fornecer os valores atualizados, crie um novo objeto ServiceRequest vazio e defina apenas os valores de propriedade que pretende alterar. Em seguida, transmita esse objeto na chamada para o método Patch ou PatchAsync.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;

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

Exemplo: aplicação de teste da consola. Project: Partner Center SDK Samples Class: UpdatePartnerServiceRequest.cs

Pedido REST

Sintaxe do pedido

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

Parâmetro URI

Utilize o seguinte parâmetro URI para atualizar o pedido de serviço.

Nome	Tipo	Necessário	Descrição
servicerequest-id	guid	Y	Um GUID que identifica o pedido de serviço.

Cabeçalhos do pedido

Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.

Corpo do pedido

O corpo do pedido deve conter um recurso ServiceRequest . Os únicos valores necessários são aqueles a serem atualizados.

Exemplo de pedido

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

Resposta do REST

Se for bem-sucedido, este método devolve um recurso de Pedido de Serviço com propriedades atualizadas no corpo da resposta.

Códigos de erro e êxito da resposta

Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja Códigos de Erro REST do Centro de Parceiros.

Exemplo de resposta

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

Partilhar via