Freigeben über

Ticket erstellen

  • Artikel

API-Beschreibung

Erstellt ein neues Supportticket.

Das Hinzufügen von Anlagen wird derzeit nicht über die API unterstützt. Um einem vorhandenen Supportticket eine Datei hinzuzufügen, besuchen Sie die Seite Serviceanfragen im Microsoft Intune Admin Center.

Das Anzeigen und Hinzufügen von Inhalten zu Diskussionen wird derzeit nicht über die API unterstützt.

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

POST 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.

Eigenschaft Erforderlich Typ Beschreibung
title Wahr String Kurze Beschreibung der Frage oder des Problems.
description Wahr String Ausführliche Beschreibung.
type Wahr TicketType Tickettyp.
category Wahr TicketCategory Ticketkategorie.
Unterkategorie Wahr String Ticketunterkategorie.
usersOrDevicesImpacted Int32 Anzahl der betroffenen Benutzer/Geräte.
businessImpact String Beschreiben der geschäftlichen Auswirkungen
issueFirstNoticed String Zeitpunkt, zu dem das Problem zum ersten Mal bemerkt wurde.
issueReproduced Boolesch Das Problem ist auf nicht von Microsoft verwalteten Geräten reproduzierbar.
endUserSupportEngaged Boolesch Der Endbenutzersupport wurde aktiviert.
ProblembehandlungSchritte String Beschreibung der ausgeführten Korrekturschritte.
reproSteps String Schritte zum Reproduzieren des Problems.
Schweregrad Wahr Schweregrad Ticketschweregrad.
contact Wahr CaseContact Fallkontaktobjekt.
givenName Wahr String Vorname.
surname Wahr String Nachname.m
email Wahr String Email Adresse.
PhoneNumber Wahr String Telefonnummer

Antwort

Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 200 OK und eine Liste der Geräte im Antworttext zurück.

Beispiel 1: Erstellen eines Supporttickets zum Anfordern von Informationen

Erstellen einer Supportticketanfrage

Es folgt ein Beispiel für die HTTP-Anforderung.

POST https://mmdls.microsoft.com/support/odata/v1/tickets

Es folgt ein Beispiel für die JSON-Anforderung.

{ 
    "title": "Title", 
    "description": "Description of ticket", 
    "type": "RequestForInformation", 
    "category": "Devices", 
    "subcategory": "Hardware", 
    "severity": 4, 
    "contact": { 
        "givenName": "John", 
        "surname": "Doe", 
        "email": "jd@contoso.com", 
        "phoneNumber": "phone number"
    } 
}

Erstellen einer Supportticketantwort

Es folgt ein Beispiel für die JSON-Antwort.

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets/$entity", 
    "title": "Title", 
    "description": "Description", 
    "isPartner": false, 
    "type": "RequestForInformation", 
    "category": "Devices", 
    "subcategory": "Hardware", 
    "compromiseIndicator": null, 
    "usersOrDevicesImpacted": null, 
    "relatedAlerts": null, 
    "businessImpact": null, 
    "issueFirstNoticed": null, 
    "issueReproduced": null, 
    "endUserSupportEngaged": null, 
    "troubleshootingSteps": null, 
    "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: Erstellen eines Supporttickets zum Anfordern einer Änderung

Anfordern einer Änderung

Es folgt ein Beispiel für die HTTP-Anforderung.

POST https://mmdls.microsoft.com/support/odata/v1/tickets

Es folgt ein Beispiel für die JSON-Anforderung.

{ 
    "title": "Title", 
    "description": "Description of ticket", 
    "type": "ChangeRequest", 
    "category": "Devices", 
    "subcategory": " Deployment groups assignment", 
    "severity": 4, 
    "contact": { 
        "givenName": "John", 
        "surname": "Doe", 
        "email": "jd@contoso.com", 
        "phoneNumber": "phone number"
    } 
}

Anfordern einer Änderungsantwort

Es folgt ein Beispiel für die JSON-Antwort.

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets/$entity", 
    "title": "Title", 
    "description": "Description", 
    "isPartner": false, 
    "type": "ChangeRequest", 
    "category": "Devices", 
    "subcategory": " Deployment groups assignment", 
    "compromiseIndicator": null, 
    "usersOrDevicesImpacted": null, 
    "relatedAlerts": null, 
    "businessImpact": null, 
    "issueFirstNoticed": null, 
    "issueReproduced": null, 
    "endUserSupportEngaged": null, 
    "troubleshootingSteps": null, 
    "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: Erstellen eines Supporttickets für einen Incident

Supportticketanfrage für Incidents

Es folgt ein Beispiel für die HTTP-Anforderung:

POST https://mmdls.microsoft.com/support/odata/v1/tickets

Es folgt ein Beispiel für die JSON-Anforderung:

{ 
    "title": "Title", 
    "description": "Description of ticket", 
    "type": "Incident", 
    "category": "Devices", 
    "subcategory": "Configuration/Policy", 
    "usersOrDevicesImpacted": 100, 
    "businessImpact": "Business Impact", 
    "issueFirstNoticed": "2021-10-06T07:00:00Z", 
    "issueReproduced": true, 
    "endUserSupportEngaged": true, 
    "troubleshootingSteps": "Describe any troubleshooting steps performed.", 
    "severity": 4, 
    "contact": { 
        "givenName": "John", 
        "surname": "Doe", 
        "email": "jd@contoso.com", 
        "phoneNumber": "+1 888" 
    } 
}

Reaktion auf Incidentsupporttickets

Es folgt ein Beispiel für die JSON-Antwort.

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#Tickets/$entity", 
    "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 troubleshooting steps performed.", 
    "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": [] 
}