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 de URI

Nome	Em	Obrigatório	Tipo	Description
accountEndpoint	path	True	string	Ponto de extremidade da conta.
instanceId	path	True	string	Identificador de instância de conta.
action	query	True	ImportAction	Importar ação de atualização.

Corpo da solicitação

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

Respostas

Nome	Tipo	Description
202 Accepted		Solicitação de importação de atualização aceita; O local da operação em segundo plano para acompanhar status é especificado em Operation-Location cabeçalho de resposta. Cabeçalhos Location: string Operation-Location: string
429 Too Many Requests		Muitas solicitações; há um limite de taxa em quantas operações podem ser executadas em um período de tempo e também há um limite para quantas operações simultâneas de importação e exclusão em segundo plano podem ser executadas.

Segurança

azure_auth_implicit

Fluxo Implícito do OAuth2 do Azure Active Directory

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

azure_auth_code

Fluxo do AccessCode do OAuth2 do Azure Active Directory

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

azure_auth_application

Fluxo de Aplicativo OAuth2 do Azure Active Directory

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

Escopos

Nome	Description
.default	escopo da credencial do cliente

azure_auth_password

Fluxo de senha OAuth2 do Azure Active Directory

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Updates_ImportUpdate

Solicitação de exemplo

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 de exemplo

Código de status:

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 status:

429

Definições

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

FileImportMetadata

Metadados que descrevem um arquivo de atualização.

Nome	Tipo	Description
filename	string	Atualize o nome do arquivo conforme especificado dentro do manifesto de importação.
url	string	Local do Blob do Azure do qual o arquivo de atualização pode ser baixado pela Atualização de Dispositivo para Hub IoT. Normalmente, essa é uma URL de blob protegida por SAS somente leitura com uma expiração definida como pelo menos 4 horas.

ImportAction

Importar ação de atualização.

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

ImportManifestMetadata

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

Nome	Tipo	Description
hashes	object	Um objeto JSON que contém o hash(es) do arquivo. Pelo menos o hash SHA256 é necessário. Esse objeto pode ser considerado como um conjunto de pares chave-valor em que a chave é o algoritmo de hash e o valor é o hash do arquivo calculado usando esse algoritmo.
sizeInBytes	integer	Tamanho do arquivo em número de bytes.
url	string	Local do Blob do Azure do qual o manifesto de importação pode ser baixado pela Atualização de Dispositivo para Hub IoT. Normalmente, essa é uma URL de blob protegida por SAS somente leitura com uma expiração definida como pelo menos 4 horas.

ImportUpdateInput

Importar metadados de entrada de atualização.

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