Device Update - Get Update

Serviço:: Device Update

Versão da API:: 2022-10-01

Obtenha uma versão de atualização específica.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string (url)	O ponto de extremidade da conta da Atualização de Dispositivo para Hub IoT (somente nome do host, sem protocolo).
instanceId	path	True	string	O identificador da instância da conta do Device Update para Hub IoT.
name	path	True	string	Nome da atualização.
provider	path	True	string	Atualizar o provedor.
version	path	True	string	Atualizar versão.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
If-None-Match		string	Define a condição If-None-Match. A operação será executada somente se a ETag no servidor não corresponder a esse valor.

Respostas

Nome	Tipo	Description
200 OK	Update	A solicitação foi bem-sucedida.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

OAuth2Auth

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

Escopos

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

Exemplos

DeviceUpdate_GetUpdate

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 200

{
  "updateId": {
    "provider": "microsoft",
    "name": "adu",
    "version": "1.0.0.0"
  },
  "friendlyName": "Lab Sensor Update v1",
  "description": "Fix for critical vulnerability",
  "compatibility": [
    {
      "deviceManufacturer": "Microsoft",
      "deviceModel": "Toaster"
    }
  ],
  "instructions": {
    "steps": [
      {
        "description": "pre-install script",
        "handler": "microsoft/script:1",
        "handlerProperties": {
          "arguments": "--pre-install"
        },
        "files": [
          "configure.sh"
        ]
      },
      {
        "type": "reference",
        "updateId": {
          "provider": "microsoft",
          "name": "sensor",
          "version": "1.0"
        }
      }
    ]
  },
  "manifestVersion": "5.0",
  "importedDateTime": "2020-04-22T14:01:43.8408797-07:00",
  "createdDateTime": "2019-09-11T17:00:00-07:00",
  "etag": "\"3fed3378-0c67-47d2-b796-296962c66cbb\""
}

Definições

Nome	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.
Instructions	Atualizar o contêiner de instruções de instalação.
Step	Atualizar a etapa de instrução de instalação.
StepType	Tipo de etapa.
Update	Atualizar metadados.
UpdateId	Identificador de atualização.

Error

Objeto

Detalhes do erro.

Nome	Tipo	Description
code	string	Código de erro definido pelo servidor.
details	Error[]	Uma matriz de erros que levou 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 pelo ser humano do erro.
occurredDateTime	string (date-time)	Data e hora em UTC quando o erro ocorreu.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro comum.

Nome	Tipo	Description
error	Error	Os detalhes do erro.

InnerError

Objeto

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

Nome	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 pelo ser humano do erro.

Instructions

Objeto

Atualizar o contêiner de instruções de instalação.

Nome	Tipo	Description
steps	Step[]	Coleção de etapas de instalação.

Step

Objeto

Atualizar a etapa de instrução de instalação.

Nome	Tipo	Valor padrão	Description
description	string minLength: 1 maxLength: 64		Descrição da etapa.
files	string[]		Coleção de nomes de arquivo a serem passados para o manipulador durante a execução. Obrigatório se o tipo de etapa estiver embutido.
handler	string minLength: 1 maxLength: 32		Identidade do manipulador que executará esta etapa. Obrigatório se o tipo de etapa estiver embutido.
handlerProperties			Parâmetros a serem passados para o manipulador durante a execução.
type	StepType	inline	Tipo de etapa.
updateId	UpdateId		Identidade de atualização filho referenciada. Obrigatório se o tipo de etapa for referência.

StepType

Enumeração

Tipo de etapa.

Valor	Description
inline	Tipo de passo que executa código.
reference	Tipo de passo que instala outra atualização.

Update

Objeto

Atualizar metadados.

Nome	Tipo	Valor padrão	Description
compatibility	object[]		Lista de informações de compatibilidade de atualização.
createdDateTime	string (date-time)		Data e hora em UTC quando a atualização foi criada.
description	string minLength: 1 maxLength: 512		Descrição da atualização especificada pelo criador.
etag	string		Atualizar eTag.
friendlyName	string minLength: 1 maxLength: 512		Nome de atualização amigável especificado pelo importador.
importedDateTime	string (date-time)		Data e hora em UTC quando a atualização foi importada.
installedCriteria	string		Cadeia de caracteres interpretada pelo cliente de Atualização de Dispositivo para determinar se a atualização está instalada no dispositivo. Preterido no esquema de manifesto de importação mais recente.
instructions	Instructions		Atualize as instruções de instalação.
isDeployable	boolean	True	Se a atualização pode ser implantada em um dispositivo por conta própria.
manifestVersion	string		Versão de esquema do manifesto usada para importar a atualização.
referencedBy	UpdateId[]		Lista de identidades de atualização que fazem referência a essa atualização.
scanResult	string		Atualizar o resultado da verificação agregada (calculado com base nos resultados da verificação de arquivo de conteúdo).
updateId	UpdateId		Atualizar identidade.
updateType	string		Tipo de atualização. Preterido no esquema de manifesto de importação mais recente.

UpdateId

Objeto

Identificador de atualização.

Nome	Tipo	Description
name	string	Nome da atualização.
provider	string	Atualizar o provedor.
version	string	Atualizar versão.