サービス リクエストを更新する
適用対象: パートナー センター | Microsoft Cloud for US Government のパートナー センター
クラウド ソリューション プロバイダーが顧客に代わって Microsoft に提出した既存の顧客サービス要求を更新する方法。
パートナー センターでは、最初に 顧客を選択することで、この操作を実行できます。 次に、左側のサイドバーで [ サービス要求 ] を選択し、問題のサービス要求を選択します。 完了するには、サービス要求に必要な変更を加え、[送信] を選択 します。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。
サービス要求 ID。
C#
顧客のサービス要求を更新するには、サービス要求 ID を指定して IServiceRequestCollection.ById メソッドを呼び出して、サービス要求インターフェイスを識別して返します。 次に 、IServiceRequest.Patch メソッドまたは PatchAsync メソッドを呼び出して、サービス要求を更新します。 更新された値を指定するには、新しい空 の ServiceRequest オブジェクトを作成し、変更するプロパティ値のみを設定します。 次に、Patch メソッドまたは PatchAsync メソッドの呼び出しでそのオブジェクトを渡します。
// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest;
ServiceRequest updatedServiceRequest = partnerOperations.ServiceRequests.ById(existingServiceRequest.Id).Patch(new ServiceRequest
{
NewNote = note
});
サンプル: コンソール テスト アプリ。 プロジェクト: パートナー センター SDK サンプル クラス: UpdatePartnerServiceRequest.cs
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
PATCH | {baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1 |
URI パラメーター
サービス要求を更新するには、次の URI パラメーターを使用します。
名前 | Type | 必須 | 説明 |
---|---|---|---|
servicerequest-id | guid | Y | サービス要求を識別する GUID。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
[要求本文]
要求本文には ServiceRequest リソースが含まれている必要があります。 必要な値は、更新される値のみです。
要求の例
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"
}
}
REST 応答
成功した場合、このメソッドは応答本文で更新されたプロパティを持つ サービス要求 リソースを返します。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、「 パートナー センター REST エラー コード」を参照してください。
応答の例
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"
}
}