Elenca ticket
Descrizione DELL'API
Elenchi tutti i ticket di supporto.
Operatori di query OData V4 supportati:
$filter
$skip
$top
$orderby
Prerequisiti
Per chiamare questa API è necessaria una delle autorizzazioni seguenti. Per altre informazioni, incluso come scegliere le autorizzazioni, vedere Autorizzazioni.
| Tipo di autorizzazione | Autorizzazioni |
|---|---|
| Delegato | Non applicabile |
| Applicazione | MmdSupport.ReadWrite |
Richiesta HTTP
GET https://mmdls.microsoft.com/support/odata/v1/tickets
Intestazioni della richiesta
| Intestazione | Valore |
|---|---|
| Autorizzazione | Bearer {token} (Obbligatorio) |
| Accept | application/json |
Corpo della richiesta
Non specificare un corpo della richiesta per questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un codice di risposta 200 OK e un elenco di ticket nel corpo della risposta.
Esempio 1: Elencare i ticket
Elencare la richiesta di ticket
Di seguito è riportato un esempio HTTP per elencare i primi 50 ticket restituiti in ordine decrescente dalla proprietà createdDateTime .
GET https://mmdls.microsoft.com/support/odata/v1/tickets?$skip=0&$top=50&$orderby=createdDateTime desc
Elencare la risposta dei ticket
Di seguito è riportato un esempio della risposta JSON.
Nota
L'elenco di risposte visualizzato può essere troncato per brevità. Tutti i ticket verranno restituiti da una chiamata effettiva.
{
"@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": []
},
....
]
}
Esempio 2: Elencare i ticket filtrati in base al titolo
Elencare i ticket filtrati in base alla richiesta di titolo
Di seguito è riportato un esempio HTTP per elencare tutti i ticket che contengono Test nel titolo del ticket
GET https://mmdls.microsoft.com/support/odata/v1/tickets?$filter=contains(title,'Test')
Elencare i ticket filtrati in base alla risposta del titolo
Di seguito è riportato un esempio della risposta JSON.
Nota
L'elenco di risposte visualizzato può essere troncato per brevità. Tutti i ticket verranno restituiti da una chiamata effettiva.
{
"@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": []
},
....
]
}
Esempio 3: Elencare i ticket filtrati in base allo stato e alla gravità
Elencare i ticket filtrati in base allo stato e alla richiesta di gravità
Di seguito è riportato un esempio HTTP per elencare tutti i ticket con gravità elevata risolti.
GET https://mmdls.microsoft.com/support/odata/v1/tickets?$filter=state eq 'resolved' and severity eq 2
Elencare i ticket filtrati in base allo stato e alla risposta di gravità
Di seguito è riportato un esempio della risposta JSON.
Nota
L'elenco di risposte visualizzato può essere troncato per brevità. Tutti i ticket verranno restituiti da una chiamata effettiva.
{
"@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": []
},
....
]
}