Updates - Import Update

Serviço:

Device Update

Versão da API:

2020-09-01

Importar nova versão de atualização.

POST https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates?action=import

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
accountEndpoint	path	True	string	Ponto final da conta.
instanceId	path	True	string	Identificador de instância de conta.
action	query	True	ImportAction	Importar ação de atualização.

Corpo do Pedido

Name	Necessário	Tipo	Description
files	True	FileImportMetadata[]	Uma ou mais propriedades do ficheiro de atualização, como nome de ficheiro e URL de origem.
importManifest	True	ImportManifestMetadata	Importar metadados de manifesto, como URL de origem, tamanho do ficheiro/hashes, etc.

Respostas

Name	Tipo	Description
202 Accepted		Pedido de importação de atualização aceite; A localização da operação em segundo plano para controlar o estado é especificada no cabeçalho de resposta Operation-Location. Cabeçalhos Location: string Operation-Location: string
429 Too Many Requests		Demasiados pedidos; Existe um limite de taxa sobre quantas operações podem ser executadas num período de tempo e também existe um limite para quantas operações em segundo plano de importação e eliminação simultâneas podem ser executadas.

Segurança

azure_auth_implicit

Fluxo Implícito OAuth2 do Azure Active Directory

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

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

azure_auth_code

Fluxo do AccessCode do Azure Active Directory OAuth2

Tipo: oauth2
Fluxo: accessCode
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

azure_auth_application

Fluxo de Aplicação OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: application
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Âmbitos

Name	Description
.default	âmbito das credenciais do cliente

azure_auth_password

Fluxo de Palavras-passe do OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: password
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

Updates_ImportUpdate

Pedido de amostra

HTTP

POST https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates?action=import

{
  "importManifest": {
    "url": "http://test.blob.core.windows.net/test/uploadimportMan.json",
    "sizeInBytes": 816,
    "hashes": {
      "sha256": "O19LyyncPe1AGstOdkcmozLV8pSbBdqrE18HdYVohRc="
    }
  },
  "files": [
    {
      "filename": "file1.bin",
      "url": "http://test.blob.core.windows.net/test/upload1v5uww1q"
    },
    {
      "filename": "file2.bin",
      "url": "http://test.blob.core.windows.net/test/uploadkrmn5yw0"
    },
    {
      "filename": "file3.bin",
      "url": "http://test.blob.core.windows.net/test/uploaddq52ky5m"
    }
  ]
}

Resposta da amostra

Código de estado:

202

Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
Operation-Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f

Código de estado:

429

Definições

Name	Description
FileImportMetadata	Metadados que descrevem um ficheiro de atualização.
ImportAction	Importar ação de atualização.
ImportManifestMetadata	Metadados que descrevem o manifesto de importação, um documento que descreve os ficheiros e outros metadados sobre uma versão de atualização.
ImportUpdateInput	Importar metadados de entrada de atualização.

FileImportMetadata

Metadados que descrevem um ficheiro de atualização.

Name	Tipo	Description
filename	string	Atualize o nome do ficheiro conforme especificado no manifesto de importação.
url	string	Localização do Blob do Azure a partir da qual o ficheiro de atualização pode ser transferido pela Atualização de Dispositivos para Hub IoT. Normalmente, trata-se de um URL de blob protegido por SAS só de leitura com uma expiração definida para, pelo menos, 4 horas.

ImportAction

Importar ação de atualização.

Name	Tipo	Description
import	string	Ação de importação.

ImportManifestMetadata

Metadados que descrevem o manifesto de importação, um documento que descreve os ficheiros e outros metadados sobre uma versão de atualização.

Name	Tipo	Description
hashes	object	Um objeto JSON que contém o hash(es) do ficheiro. Pelo menos é necessário hash SHA256. Este objeto pode ser considerado como um conjunto de pares de valor-chave onde a chave é o algoritmo de hash, e o valor é o hash do ficheiro calculado usando esse algoritmo.
sizeInBytes	integer	Tamanho do ficheiro em número de bytes.
url	string	Localização dos Blobs do Azure a partir da qual o manifesto de importação pode ser transferido pela Atualização de Dispositivos para Hub IoT. Normalmente, trata-se de um URL de blob protegido por SAS só de leitura com uma expiração definida para, pelo menos, 4 horas.

ImportUpdateInput

Importar metadados de entrada de atualização.

Name	Tipo	Description
files	FileImportMetadata[]	Uma ou mais propriedades do ficheiro de atualização, como nome de ficheiro e URL de origem.
importManifest	ImportManifestMetadata	Importar metadados de manifesto, como URL de origem, tamanho do ficheiro/hashes, etc.