Device Update - List Versions

Obtenha uma lista de todas as versões de atualização que correspondem ao provedor e ao nome especificados.

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

Parâmetros do URI

Name Em Necessário Tipo Description
endpoint
path True

string (url)

O ponto de extremidade da conta da Atualização de Dispositivo para o Hub IoT (somente nome do host, sem protocolo).

instanceId
path True

string

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

name
path True

string

Nome da atualização.

provider
path True

string

Provedor de atualização.

api-version
query True

string

Versão da API a ser usada com a solicitação do cliente.

filter
query

string

Opcional para filtrar atualizações por propriedade isDeployable.

Respostas

Name Tipo Description
200 OK

StringsList

Todas as versões de atualização que correspondam ao provedor e nome especificados, ou lista vazia, se não houver nenhuma.

Other Status Codes

ErrorResponse

Resposta padrão.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Âmbitos

Name Description
https://api.adu.microsoft.com/.default Escopo de autorização padrão.

Exemplos

DeviceUpdate_ListVersions

Pedido de amostra

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

Resposta da amostra

{
  "value": [
    "1.0.0.0",
    "1.0.0.1"
  ]
}

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.

StringsList

A lista de cadeias de caracteres com suporte à paginação do servidor.

Error

Detalhes do erro.

Name Tipo Description
code

string

Código de erro definido pelo servidor.

details

Error[]

Uma matriz de erros que levaram ao erro relatado.

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 (date-time)

Data e hora em UTC quando o erro ocorreu.

target

string

O alvo 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 contido.

errorDetail

string

A mensagem interna de erro ou 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.

StringsList

A lista de cadeias de caracteres com suporte à paginação do servidor.

Name Tipo Description
nextLink

string

O link para a próxima página de itens.

value

string[]

A coleção de itens pagináveis.