Device Update - Delete Update

Servizio:
Device Update
Versione API:
2022-10-01

Eliminare una versione di aggiornamento specifica. Si tratta di un'operazione a esecuzione prolungata; usare Operation-Location valore dell'intestazione della risposta per verificare lo stato dell'operazione.

DELETE https://{endpoint}/deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions/{version}?api-version=2022-10-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
endpoint
 path True

string (url)

Aggiornamento del dispositivo per l'endpoint dell'account dell'hub IoT (solo nome host, nessun protocollo).
instanceId
 path True

string

Identificatore dell'istanza dell'account dell'hub IoT aggiornamento del dispositivo.
name
 path True

string

Aggiornare il nome.
provider
 path True

string

Provider di aggiornamento.
version
 path True

string

Aggiornare la versione.
api-version
 query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Risposte

Nome Tipo Descrizione
202 Accepted

La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata.

Intestazioni

Operation-Location: string
Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
https://api.adu.microsoft.com/.default

Esempio

DeviceUpdate_DeleteUpdate

Esempio di richiesta

DELETE https://contoso.api.adu.microsoft.com/deviceUpdate/blue/updates/providers/microsoft/names/adu/versions/1.0.0.0?api-version=2022-10-01

Risposta di esempio

Codice di stato:
202 
Operation-Location: /deviceUpdate/blue/operations/e4491c54-916f-443d-9094-bcca546ace2f?api-version=2022-10-01

Definizioni

Nome Descrizione
Error

Dettagli errore.
ErrorResponse

Risposta di errore comune.
InnerError

Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.

Error

Oggetto

Dettagli errore.

Nome Tipo Descrizione
code

string

Codice di errore definito dal server.
details

Error[]

Matrice di errori che hanno causato l'errore segnalato.
innererror

InnerError

Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message

string

Rappresentazione leggibile dell'errore.
occurredDateTime

string (date-time)

Data e ora in formato UTC in cui si è verificato l'errore.
target

string

Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore comune.

Nome Tipo Descrizione
error

Error

Dettagli dell'errore.

InnerError

Oggetto

Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.

Nome Tipo Descrizione
code

string

Codice di errore più specifico di quello fornito dall'errore contenitore.
errorDetail

string

Messaggio di errore interno o eccezione.
innerError

InnerError

Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message

string

Rappresentazione leggibile dell'errore.