Freigeben über

Erstellen einer Erhöhungsanforderung

  • Artikel

API-Beschreibung

Erstellen Sie eine Erhöhungsanforderung für ein bestimmtes Gerät.

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/tenants/{tenantId}/elevationRequests

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token} (erforderlich)
Annehmen application/json

Anforderungstext

Eigenschaft Typ Beschreibung
partnerTicketId String Ticket-ID des Supporttickets, das mit der Erhöhungsanforderung verknüpft ist.
deviceName String Gerätename
title String Titel.
category String Anforderungskategorie.
Unterkategorie String Anforderungsunterkategorie.
planOfAction String Aktionsplan zur Lösung des Falls.

Antwort

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

Beispiel

Beispielanforderung

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

POST https://mmdls.microsoft.com/support/odata/v1/tenants/{tenantId}/elevationRequests

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

{ 
    "PartnerTicketId": "Support Ticket Id", 
    "DeviceName": "DeviceName", 
    "Title": "Elevation request title", 
    "Category": "Office", 
    "Subcategory": "Excel", 
    "PlanOfAction": "Plan of action using elevation." 
}

Beispielantwort

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

{ 
    "@odata.context": "https://mmd-support-prod-nam.trafficmanager.net/odata/v1/$metadata#ElevationRequests/$entity", 
    "id": "Elevation Request Id", 
    "tenantId": "Tenant Id", 
    "partnerId": "Tenant Id", 
    "requestingAgentUpn": "user UPN email", 
    "partnerTicketId": "Support Ticket Id", 
    "deviceName": "DeviceName", 
    "title": "Elevation request title", 
    "category": "Office", 
    "subcategory": "Excel", 
    "planOfAction": "Plan of action using elevation.", 
    "actionsTaken": "", 
    "closingAgentUpn": "", 
    "requestCreationTime": "2021-12-14T14:06:25.0338102Z", 
    "requestClosureTime": null, 
    "requestRenewTime": null, 
    "isSuccessfulRequest": true, 
    "viewerUpns": [], 
    "passwordLastUpdatedTime": "2021-03-16T15:10:36.2066667Z", 
    "isDeleted": false, 
    "ttl": 7776000, 
    "eTag": null 
}

Fehlgeschlagene Antworten

Im Folgenden sind Beispiele für fehlgeschlagene Antworten aufgeführt.

Beispiel 1

Es folgt ein Beispiel für eine fehlgeschlagene JSON-Antwort.

{ 
    "error": { 
        "code": "403", 
        "message": "This device has too many open elevation requests." 
    } 
}

Beispiel 2

Es folgt ein Beispiel für eine fehlgeschlagene JSON-Antwort.

{ 
    "error": { 
        "code": "404", 
        "message": "This device does not exist." 
    } 
}