ID でサービス リクエストの詳細を取得する
適用対象: パートナー センター | Microsoft Cloud for US Government のパートナー センター
サービス要求識別子を使用して既存の顧客サービス要求の詳細を取得する方法。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。
サービス要求 ID。
C#
既存の顧客サービス要求の詳細を取得するには、IServiceRequestCollection.ById メソッドを呼び出し、特定の ServiceRequest オブジェクトを識別してインターフェイスを返す ServiceRequest.Id を渡します。
// IAggregatePartner partnerOperations;
// ServiceRequest existingServiceRequest as ServiceRequest;
ServiceRequest serviceRequestDetails = partnerOperations.ServiceRequests.ById(existingServiceRequest.Id).Get();
Console.WriteLine(string.Format("The primary contact for the service request {0} is {1} {2}.",
serviceRequestDetails.Title,
serviceRequestDetails.PrimaryContact.FirstName,
serviceRequestDetails.PrimaryContact.LastName,
));
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/servicerequests/{servicerequest-id} HTTP/1.1 |
URI パラメーター
指定したサービス要求を取得するには、次の URI パラメーターを使用します。
名前 | タイプ | Required | 説明 |
---|---|---|---|
servicerequest-id | string | Y | サービス要求を識別する英数字の値。 |
要求ヘッダー
名前 | タイプ | Required | 説明 |
---|---|---|---|
IncludeOrganizationRequests | string | N | 存在する場合は、サービス要求の詳細を取得する前に、サポート 要求管理ロールのユーザーを承認するヘッダー。 |
詳細については、「パートナー センター REST ヘッダー」を参照してください。
要求本文
なし
要求の例
GET 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: 0
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": "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"
}
}