Tickets auflisten
API-Beschreibung
Listen alle Supporttickets.
Unterstützte OData V4-Abfrageoperatoren :
$filter
$skip
$top
$orderby
Voraussetzungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
| Berechtigungstyp | Berechtigungen |
|---|---|
| Delegiert | Nicht zutreffend |
| App | MmdSupport.ReadWrite |
HTTP-Anforderung
GET https://mmdls.microsoft.com/support/odata/v1/tickets
Anforderungsheader
| Kopfzeile | Wert |
|---|---|
| Authorization | Bearer {token} (erforderlich) |
| Annehmen | application/json |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 200 OK und eine Liste von Tickets im Antworttext zurück.
Beispiel 1: Auflisten von Tickets
Ticketanforderung auflisten
Im Folgenden sehen Sie ein HTTP-Beispiel zum Auflisten der ersten 50 Tickets, die von der createdDateTime-Eigenschaft in absteigender Reihenfolge zurückgegeben werden.
GET https://mmdls.microsoft.com/support/odata/v1/tickets?$skip=0&$top=50&$orderby=createdDateTime desc
Ticketantwort auflisten
Es folgt ein Beispiel für die JSON-Antwort.
Hinweis
Die angezeigte Antwortliste kann aus Gründen der Kürze abgeschnitten werden. Alle Tickets werden von einem tatsächlichen Anruf zurückgegeben.
{
"@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets",
"value": [
{
"title": "Title",
"description": "Description",
"isPartner": true,
"type": "Incident",
"category": "Devices",
"subcategory": "Configuration/Policy",
"compromiseIndicator": null,
"usersOrDevicesImpacted": 100,
"relatedAlerts": null,
"businessImpact": "Business Impact",
"issueFirstNoticed": "2021-10-06T07:00:00Z",
"issueReproduced": true,
"endUserSupportEngaged": true,
"troubleshootingSteps": "Describe any performed remediation steps.",
"nextActionOwner": "Microsoft",
"nextActionTime": null,
"reproSteps": null,
"id": "Ticket Number",
"severity": 4,
"state": "active",
"createdDateTime": "2021-12-14T04:28:18Z",
"resolvedDateTime": null,
"contact": {
"id": "Unique Id",
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number",
"preferredLanguageId": ""
},
"emails": [],
"attachments": [],
"notes": []
},
{
"title": "Title",
"description": "Description",
"isPartner": true,
"type": "Incident",
"category": "Devices",
"subcategory": "Configuration/Policy",
"compromiseIndicator": null,
"usersOrDevicesImpacted": 100,
"relatedAlerts": null,
"businessImpact": "Business Impact",
"issueFirstNoticed": "2021-10-06T07:00:00Z",
"issueReproduced": true,
"endUserSupportEngaged": true,
"troubleshootingSteps": "Describe any performed remediation steps.",
"nextActionOwner": "Microsoft",
"nextActionTime": null,
"reproSteps": null,
"id": "Ticket Number",
"severity": 4,
"state": "active",
"createdDateTime": "2021-12-14T04:28:18Z",
"resolvedDateTime": null,
"contact": {
"id": "Unique Id",
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number",
"preferredLanguageId": ""
},
"emails": [],
"attachments": [],
"notes": []
},
....
]
}
Beispiel 2: Nach Titel gefilterte Tickets auflisten
Tickets nach Titelanforderung gefiltert auflisten
Im Folgenden finden Sie ein HTTP-Beispiel zum Auflisten aller Tickets, die im Tickettitel enthalten Test sind.
GET https://mmdls.microsoft.com/support/odata/v1/tickets?$filter=contains(title,'Test')
Tickets nach Titelantwort gefiltert auflisten
Es folgt ein Beispiel für die JSON-Antwort.
Hinweis
Die angezeigte Antwortliste kann aus Gründen der Kürze abgeschnitten werden. Alle Tickets werden von einem tatsächlichen Anruf zurückgegeben.
{
"@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets",
"value": [
{
"title": "Test ticket 1",
"description": "Description",
"isPartner": true,
"type": "Incident",
"category": "Devices",
"subcategory": "Configuration/Policy",
"compromiseIndicator": null,
"usersOrDevicesImpacted": 100,
"relatedAlerts": null,
"businessImpact": "Business Impact",
"issueFirstNoticed": "2021-10-06T07:00:00Z",
"issueReproduced": true,
"endUserSupportEngaged": true,
"troubleshootingSteps": "Describe any performed remediation steps.",
"nextActionOwner": "Microsoft",
"nextActionTime": null,
"reproSteps": null,
"id": "Ticket Number",
"severity": 4,
"state": "active",
"createdDateTime": "2021-12-14T04:28:18Z",
"resolvedDateTime": null,
"contact": {
"id": "Unique Id",
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number",
"preferredLanguageId": ""
},
"emails": [],
"attachments": [],
"notes": []
},
{
"title": "Test ticket 2",
"description": "Description",
"isPartner": true,
"type": "Change Request",
"category": "Apps",
"subcategory": "Other ",
"compromiseIndicator": null,
"usersOrDevicesImpacted": 100,
"relatedAlerts": null,
"businessImpact": "Business Impact",
"issueFirstNoticed": "2021-10-06T07:00:00Z",
"issueReproduced": true,
"endUserSupportEngaged": true,
"troubleshootingSteps": "Describe any performed remediation steps.",
"nextActionOwner": "Microsoft",
"nextActionTime": null,
"reproSteps": null,
"id": "Ticket Number",
"severity": 4,
"state": "active",
"createdDateTime": "2021-12-14T04:28:18Z",
"resolvedDateTime": null,
"contact": {
"id": "Unique Id",
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number",
"preferredLanguageId": ""
},
"emails": [],
"attachments": [],
"notes": []
},
....
]
}
Beispiel 3: Nach Status und Schweregrad gefilterte Tickets auflisten
Auflisten von Tickets, gefiltert nach Status und Schweregradanforderung
Es folgt ein HTTP-Beispiel zum Auflisten aller Tickets mit hohem Schweregrad, die aufgelöst werden.
GET https://mmdls.microsoft.com/support/odata/v1/tickets?$filter=state eq 'resolved' and severity eq 2
Auflisten von Tickets, gefiltert nach Status- und Schweregradantwort
Es folgt ein Beispiel für die JSON-Antwort.
Hinweis
Die angezeigte Antwortliste kann aus Gründen der Kürze abgeschnitten werden. Alle Tickets werden von einem tatsächlichen Anruf zurückgegeben.
{
"@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets",
"value": [
{
"title": "Test ticket 1",
"description": "Description",
"isPartner": true,
"type": "Incident",
"category": "Devices",
"subcategory": "Configuration/Policy",
"compromiseIndicator": null,
"usersOrDevicesImpacted": 100,
"relatedAlerts": null,
"businessImpact": "Business Impact",
"issueFirstNoticed": "2021-10-06T07:00:00Z",
"issueReproduced": true,
"endUserSupportEngaged": true,
"troubleshootingSteps": "Describe any performed remediation steps.",
"nextActionOwner": "Microsoft",
"nextActionTime": null,
"reproSteps": null,
"id": "Ticket Number",
"severity": 2,
"state": "resolved",
"createdDateTime": "2021-12-14T04:28:18Z",
"resolvedDateTime": null,
"contact": {
"id": "Unique Id",
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number",
"preferredLanguageId": ""
},
"emails": [],
"attachments": [],
"notes": []
},
{
"title": "Test ticket 2",
"description": "Description",
"isPartner": true,
"type": "Change Request",
"category": "Apps",
"subcategory": "Other ",
"compromiseIndicator": null,
"usersOrDevicesImpacted": 100,
"relatedAlerts": null,
"businessImpact": "Business Impact",
"issueFirstNoticed": "2021-10-06T07:00:00Z",
"issueReproduced": true,
"endUserSupportEngaged": true,
"troubleshootingSteps": "Describe any performed remediation steps.",
"nextActionOwner": "Microsoft",
"nextActionTime": null,
"reproSteps": null,
"id": "Ticket Number",
"severity": 2,
"state": "resolved",
"createdDateTime": "2021-12-14T04:28:18Z",
"resolvedDateTime": null,
"contact": {
"id": "Unique Id",
"givenName": "John",
"surname": "Doe",
"email": "jd@contoso.com",
"phoneNumber": "phone number",
"preferredLanguageId": ""
},
"emails": [],
"attachments": [],
"notes": []
},
....
]
}