Partilhar via


Device Update - Delete Update

Eliminar uma versão de atualização específica. Trata-se de uma operação de execução prolongada; utilize Operation-Location valor do cabeçalho de resposta para verificar o estado da operação.

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

Parâmetros do URI

Name Em Necessário Tipo Description
endpoint
path True

string

url

A Atualização de Dispositivos para Hub IoT ponto final da conta (apenas nome do anfitrião, sem protocolo).

instanceId
path True

string

O identificador da instância da conta de Hub IoT Atualização de Dispositivos.

name
path True

string

Nome da atualização.

provider
path True

string

Atualizar fornecedor.

version
path True

string

Atualizar versão.

api-version
query True

string

Versão da API a utilizar com o pedido de cliente.

Respostas

Name Tipo Description
202 Accepted

Pedido de eliminação de atualização aceite; A localização da operação em segundo plano para controlar o estado é especificada no cabeçalho de resposta Operation-Location.

Cabeçalhos

Operation-Location: string

Other Status Codes

ErrorResponse

Resposta predefinida.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
https://api.adu.microsoft.com/.default Âmbito de autorização predefinido.

Exemplos

DeviceUpdate_DeleteUpdate

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
Error

Detalhes do erro.

ErrorResponse

Resposta de erro comum.

InnerError

Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.

Error

Detalhes do erro.

Name Tipo Description
code

string

Código de erro definido pelo servidor.

details

Error[]

Uma matriz de erros que levou ao erro comunicado.

innererror

InnerError

Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.

message

string

Uma representação legível por humanos do erro.

occurredDateTime

string

Data e hora em UTC em que ocorreu o erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro comum.

Name Tipo Description
error

Error

Os detalhes do erro.

InnerError

Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.

Name Tipo Description
code

string

Um código de erro mais específico do que o fornecido pelo erro que contém.

errorDetail

string

O erro interno ou a mensagem de exceção.

innerError

InnerError

Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.

message

string

Uma representação legível por humanos do erro.