Bir hizmet isteğini güncelleştirme

Makale
07/09/2024

Şunlar için geçerlidir: İş Ortağı Merkezi | Microsoft Cloud for US Government için İş Ortağı Merkezi

Bulut Çözümü Sağlayıcısı'nın müşteri adına Microsoft'a bildirdiği mevcut bir müşteri hizmetleri isteğini güncelleştirme.

İş Ortağı Merkezi'nde, bu işlem önce bir müşteri seçilerek gerçekleştirilebilir. Ardından sol kenar çubuğundan Hizmet istekleri'ni ve ardından söz konusu hizmet isteğini seçin. Bitirmek için, hizmet isteğinde istediğiniz değişiklikleri yapın ve gönder'i seçin.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Hizmet isteği kimliği.

C#

Müşterinin hizmet isteğini güncelleştirmek için, hizmet isteği arabirimini tanımlamak ve döndürmek için hizmet isteği kimliğiyle IServiceRequestCollection.ById yöntemini çağırın. Ardından hizmet isteğini güncelleştirmek için IServiceRequest.Patch veya PatchAsync yöntemini çağırın. Güncelleştirilmiş değerleri sağlamak için yeni, boş bir ServiceRequest nesnesi oluşturun ve yalnızca değiştirmek istediğiniz özellik değerlerini ayarlayın. Ardından bu nesneyi Patch veya PatchAsync yöntemine çağrısında geçirin.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;

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

Örnek: Konsol test uygulaması. Proje: İş Ortağı Merkezi SDK Örnekleri Sınıfı: UpdatePartnerServiceRequest.cs

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
PATCH	{baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1

URI parametresi

Hizmet isteğini güncelleştirmek için aşağıdaki URI parametresini kullanın.

Ad	Tür	Gerekli	Açıklama
servicerequest-id	Guıd	Y	Hizmet isteğini tanımlayan GUID.

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

İstek gövdesi bir ServiceRequest kaynağı içermelidir. Tek gerekli değerler güncelleştirilecek değerlerdir.

İstek örneği

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

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde güncelleştirilmiş özelliklere sahip bir Hizmet İsteği kaynağı döndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İş Ortağı Merkezi REST Hata Kodları.

Yanıt örneği

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

Aracılığıyla paylaş