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). |
|
instance
|
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 |
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 |
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. |
|
Error |
Resposta de erro comum. |
|
Inner |
Um objeto que contém informações mais específicas do que o objeto atual sobre o erro. |
|
Strings |
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 |
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 |
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 |
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. |