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

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

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

Esquema

Não são permitidas propriedades adicionais.

Objeto updateId

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

Não são permitidas propriedades adicionais.

Por exemplo:

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

objeto compatibility

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

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

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

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

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

Por exemplo:

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

Objeto instructions

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 o código a ser executado ou um ponteiro para outra atualização.

Não são permitidas propriedades adicionais.

Por exemplo:

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

Objeto inlineStep

Um objeto de etapa inline é uma etapa de instrução de instalação que realiza a execução do código.

Não são permitidas propriedades adicionais.

Por exemplo:

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

Objeto referenceStep

Um objeto de etapa reference é uma etapa de instrução de instalação que instala outra atualização.

Não são permitidas propriedades adicionais.

Por exemplo:

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

Objeto file

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

Não são permitidas propriedades adicionais.

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 poderão ser especificados se forem compatíveis com o agente. Para obter um exemplo de como calcular o hash corretamente, consulte a função Get-AduFileHashes no script AduUpdate.psm1.

São permitidas propriedades adicionais.

Por exemplo:

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

objeto relatedFiles

Coleção de arquivos relacionados a um ou mais de seus arquivos de conteúdo primários.

São permitidas propriedades adicionais.

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, confira Usar o recurso de arquivos relacionados para referenciar vários arquivos de atualização.

Objeto downloadHandler

Especifica como processar qualquer arquivo relacionado.

Não são permitidas propriedades adicionais.

Por exemplo:

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

Próximas etapas

Saiba mais sobre os conceitos de importação.

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