Device Update - Get Update

Referência

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	A Atualização de Dispositivo para Hub IoT ponto de extremidade da conta (somente nome do host, sem protocolo).
instanceId	path	True	string	A Atualização de Dispositivo para Hub IoT identificador de instância da conta.
name	path	True	string	Nome da atualização.
provider	path	True	string	Atualizar provedor.
version	path	True	string	Atualizar versão.
api-version	query	True	string	Versão da API a ser usada com a solicitação do cliente.

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 versão de atualização solicitada.
Other Status Codes	ErrorResponse	Resposta padrão.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Escopos

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

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-22T21:01:43.8408797+00:00",
  "createdDateTime": "2019-09-12T00:00:00.0000000+00: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
Step	Atualizar a etapa de instrução de instalação.
StepType	Tipo de etapa.
Update	Atualizar metadados.
UpdateId	Atualizar identificador.

Error

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 do erro.
occurredDateTime	string	Data e hora em UTC em que o erro ocorreu.
target	string	O destino do erro.

ErrorResponse

Resposta de erro comum.

Nome	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.

Nome	Tipo	Description
code	string	Um código de erro mais específico do que o fornecido pelo erro que o 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 do erro.

Instructions

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

Step

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

Nome	Tipo	Valor padrão	Description
description	string		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		Identidade do manipulador que executará esta etapa. Obrigatório se o tipo de etapa estiver embutido.
handlerProperties	object		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

Tipo de etapa.

Nome	Tipo	Description
inline	string
reference	string

Update

Atualizar metadados.

Nome	Tipo	Valor padrão	Description
compatibility	object[]		Lista de informações de compatibilidade de atualização.
createdDateTime	string		Data e hora em UTC em que a atualização foi criada.
description	string		Descrição da atualização especificada pelo criador.
etag	string		Atualize a ETag.
friendlyName	string		Nome de atualização amigável especificado pelo importador.
importedDateTime	string		Data e hora em UTC em que 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 do 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 de agregação (calculado com base nos resultados da verificação de arquivo de conteúdo).
updateId	UpdateId		Atualizar a identidade.
updateType	string		Tipo de atualização. Preterido no esquema de manifesto de importação mais recente.

UpdateId

Atualizar identificador.

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

Compartilhar via