Device Update - Delete Update

  • Riferimento
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 hub IoT endpoint dell'account (solo nome host, nessun protocollo).
instanceId
 path True

string

Aggiornamento del dispositivo per hub IoT identificatore dell'istanza dell'account.
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

Versione dell'API da usare con la richiesta client.

Risposte

Nome Tipo Descrizione
202 Accepted

Richiesta di eliminazione degli aggiornamenti accettata; La posizione dell'operazione in background per tenere traccia dello stato viene specificata nell'intestazione della risposta Operation-Location.

Intestazioni

Operation-Location: string
Other Status Codes

ErrorResponse

Risposta predefinita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Ambiti

Nome Descrizione
https://api.adu.microsoft.com/.default Ambito di autorizzazione predefinito.

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

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

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

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore comune.

Nome Tipo Descrizione
error

Error

Dettagli dell'errore.

InnerError

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 che lo contiene.
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.