Importando atualizações para a Atualização de Dispositivo para o Hub IoT: esquema e outras informações

Se você quiser importar uma atualização para a Atualização de Dispositivo para o Hub IoT, certifique-se de ter revisado os conceitos e o guia de instruções primeiro. Se você estiver interessado nos detalhes do esquema de manifesto de importação em si, veja abaixo.

O esquema JSON do manifesto de importação é hospedado em SchemaStore.org.

Esquema

Propriedades adicionais não são permitidas.

objeto updateId

O objeto updateID é um identificador exclusivo para cada atualização.

Propriedades adicionais não são permitidas.

Por exemplo:

{
  "updateId": {
    "provider": "Contoso",
    "name": "Toaster",
    "version": "1.0"
  }
}

objeto de compatibilidade

O objeto de compatibilidade descreve as propriedades de um dispositivo com o qual esta atualização é compatível.

• Tipo: object
• Propriedades mínimas: 1
• Propriedades máximas: 5

Cada propriedade é um par nome-valor da cadeia de caracteres do tipo.

• Comprimento mínimo do nome da propriedade: 1
• Comprimento máximo do nome da propriedade: 32
• Comprimento mínimo do valor da propriedade: 1
• Comprimento máximo do valor da propriedade: 64

O mesmo conjunto exato de propriedades de compatibilidade não pode ser usado com mais de um provedor de atualização e combinação de nome.

Por exemplo:

{
  "compatibility": [
    {
      "manufacturer": "Contoso",
      "model": "Toaster"
    }
  ]
}

objeto de instruções

O objeto instructions fornece as instruções de instalação da atualização. O objeto instructions contém uma lista de etapas a serem executadas. As etapas podem ser um código para executar ou um ponteiro para outra atualização.

Propriedades adicionais não são permitidas.

Por exemplo:

{
  "instructions": {
    "steps": [
      {
        "type": "inline",
        ...
      },
      {
        "type": "reference",
        ...
      }
    ]
  }
}

objeto inlineStep

Um objeto de etapa embutido é uma etapa de instrução de instalação que executa a execução de código.

Propriedades adicionais não são permitidas.

Por exemplo:

{
  "steps": [
    {
      "description": "pre-install script",
      "handler": "microsoft/script:1",
      "handlerProperties": {
        "arguments": "--pre-install"
      },
      "files": [
        "configure.sh"
      ]
    }
  ]
}

objeto referenceStep

Um objeto de etapa de referência é uma etapa de instrução de instalação que instala outra atualização.

Propriedades adicionais não são permitidas.

Por exemplo:

{
  "steps": [
    {
      "type": "reference",
      "updateId": {
        "provider": "Contoso",
        "name": "Toaster.HeatingElement",
        "version": "1.0"
      }
    }
  ]
}

objeto de arquivo

Um objeto de arquivo é um arquivo de carga útil de atualização, por exemplo, binário, firmware, script, etc. Cada objeto de arquivo deve ser exclusivo dentro de uma atualização.

Propriedades adicionais não são permitidas.

Por exemplo:

{
  "files": [
    {
      "filename": "configure.sh",
      "sizeInBytes": 7558,
      "hashes": {...}
    }
  ]
}

objeto fileHashes

Hashes de arquivo codificados em Base64 com o nome do algoritmo como chave. Pelo menos o algoritmo SHA-256 deve ser especificado, e outros algoritmos podem ser especificados se suportados pelo agente. Para obter um exemplo de como calcular o hash corretamente, consulte a função Get-AduFileHashes no script AduUpdate.psm1.

Propriedades adicionais são permitidas.

Por exemplo:

{
  "hashes": {
    "sha256": "/CD7Sn6fiknWa3NgcFjGlJ+ccA81s1QAXX4oo5GHiFA="
  }
}

objeto relatedFiles

Coleção de arquivos relacionados a um ou mais de seus arquivos de carga primária.

Propriedades adicionais são permitidas.

Por exemplo:

"relatedFiles": [
  {
    "filename": "in1_in2_deltaupdate.dat",
    "sizeInBytes": 102910752,
    "hashes": {
      "sha256": "2MIldV8LkdKenjJasgTHuYi+apgtNQ9FeL2xsV3ikHY="
    },
    "properties": {
      "microsoft.sourceFileHashAlgorithm": "sha256",
      "microsoft.sourceFileHash": "YmFYwnEUddq2nZsBAn5v7gCRKdHx+TUntMz5tLwU+24="
    }
  }
],

Para obter mais informações, consulte Usar o recurso de arquivos relacionados para fazer referência a vários arquivos de atualização.

objeto downloadHandler

Especifica como processar quaisquer arquivos relacionados.

Não são permitidas propriedades adicionais.

Por exemplo:

"downloadHandler": {
  "id": "microsoft/delta:1"
}

Próximos passos

Saiba mais sobre conceitos de importação.

Se você estiver pronto, experimente o guia de instruções de importação, que o orientará pelo processo de importação passo a passo.