Memperbarui permintaan layanan

Artikel
07/09/2024

Berlaku untuk: Pusat Mitra | Pusat Mitra untuk Microsoft Cloud for US Government

Cara memperbarui permintaan layanan pelanggan yang ada yang telah diajukan oleh Penyedia Solusi Cloud dengan Microsoft atas nama pelanggan.

Di Pusat Mitra, operasi ini dapat dilakukan dengan terlebih dahulu memilih pelanggan. Kemudian, pilih Permintaan layanan di bilah sisi kiri diikuti dengan memilih permintaan layanan yang dimaksud. Untuk menyelesaikannya, buat perubahan yang diinginkan pada permintaan layanan lalu pilih Kirim.

Prasyarat

Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi dengan kredensial Aplikasi+Pengguna.
ID permintaan layanan.

C#

Untuk memperbarui permintaan layanan pelanggan, panggil metode IServiceRequestCollection.ById dengan ID permintaan layanan untuk mengidentifikasi dan mengembalikan antarmuka permintaan layanan. Kemudian panggil metode IServiceRequest.Patch atau PatchAsync untuk memperbarui permintaan layanan. Untuk menyediakan nilai yang diperbarui, buat objek ServiceRequest baru yang kosong dan atur hanya nilai properti yang ingin Anda ubah. Kemudian teruskan objek tersebut dalam panggilan ke metode Patch atau PatchAsync.

// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;

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

Sampel: Aplikasi pengujian konsol. Proyek: Kelas Sampel SDK Pusat Mitra: UpdatePartnerServiceRequest.cs

Permintaan REST

Minta sintaks

Metode	Meminta URI
PATCH	{baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1

Parameter URI

Gunakan parameter URI berikut untuk memperbarui permintaan layanan.

Nama	Jenis	Diperlukan	Deskripsi
servicerequest-id	guid	Y	GUID yang mengidentifikasi permintaan layanan.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Isi permintaan harus berisi sumber daya ServiceRequest . Satu-satunya nilai yang diperlukan adalah nilai yang akan diperbarui.

Contoh permintaan

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

Respons REST

Jika berhasil, metode ini mengembalikan sumber daya Permintaan Layanan dengan properti yang diperbarui dalam isi respons.

Respons keberhasilan dan kode kesalahan

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, lihat Kode Kesalahan REST Pusat Mitra.

Contoh respons

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

Bagikan melalui