Compartilhar via

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 da instância da 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 o 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 de 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 Aplicativos 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 do 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

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

Objeto

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

Enumeração

Importar ação de atualização.

Valor Description
import

Ação de importação.

ImportManifestMetadata

Objeto

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 (int64)

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

Objeto

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.