Creare una richiesta di elevazione dei privilegi

Articolo
04/26/2022

Descrizione DELL'API

Creare una richiesta di elevazione dei privilegi per un dispositivo specifico.

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

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

Intestazioni della richiesta

Intestazione	Valore
Autorizzazione	Bearer {token} (Obbligatorio)
Accept	application/json

Corpo della richiesta

Proprietà	Tipo	Descrizione
partnerTicketId	Stringa	ID ticket del ticket di supporto collegato alla richiesta di elevazione.
deviceName	Stringa	Nome del dispositivo.
title	Stringa	Titolo.
categoria	Stringa	Categoria di richieste.
sottocategoria	Stringa	Sottocategoria richiesta.
planOfAction	Stringa	Piano di azione per risolvere il caso.

Risposta

In caso di esito positivo, questo metodo restituisce un codice di risposta 201 Created e un elenco di dispositivi nel corpo della risposta.

Esempio

Richiesta di esempio

Di seguito è riportato un esempio della richiesta HTTP.

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

Di seguito è riportato un esempio della richiesta JSON.

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

Risposta di esempio

Di seguito è riportato un esempio della risposta JSON.

{ 
    "@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 
}

Risposte non riuscite

Di seguito sono riportati esempi di risposte non riuscite.

Esempio 1

Di seguito è riportato un esempio di risposta JSON non riuscita.

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

Esempio due