你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Updates - Import Update

Service:

Device Update

API Version:

2020-09-01

导入新的更新版本。

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

URI 参数

名称	在	必需	类型	说明
accountEndpoint	path	True	string	帐户终结点。
instanceId	path	True	string	帐户实例标识符。
action	query	True	ImportAction	导入更新操作。

请求正文

名称	必需	类型	说明
files	True	FileImportMetadata[]	一个或多个更新文件属性，例如文件名和源 URL。
importManifest	True	ImportManifestMetadata	导入清单元数据，例如源 URL、文件大小/哈希等。

响应

名称	类型	说明
202 Accepted		接受的更新导入请求;用于跟踪状态的后台操作位置在 Operation-Location 响应标头中指定。 Headers Location: string Operation-Location: string
429 Too Many Requests		请求过多;在一段时间内可以执行多少个操作存在速率限制，并且对可以执行多少个并发导入和删除后台操作也有限制。

安全性

azure_auth_implicit

Azure Active Directory OAuth2 隐式流

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

azure_auth_code

Azure Active Directory OAuth2 AccessCode 流

Type: oauth2
Flow: accessCode
Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Scopes

名称	说明
user_impersonation	模拟用户帐户

azure_auth_application

Azure Active Directory OAuth2 应用程序流

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

Scopes

名称	说明
.default	客户端凭据范围

azure_auth_password

Azure Active Directory OAuth2 密码流

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

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

Updates_ImportUpdate

Sample Request

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"
    }
  ]
}

Sample Response

Status code:

202

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

Status code:

429

定义

名称	说明
FileImportMetadata	描述更新文件的元数据。
ImportAction	导入更新操作。
ImportManifestMetadata	描述导入清单的元数据，一个描述文件的文档，以及有关更新版本的其他元数据。
ImportUpdateInput	导入更新输入元数据。

FileImportMetadata

描述更新文件的元数据。

名称	类型	说明
filename	string	更新导入清单中指定的文件名。
url	string	Azure Blob 位置，设备更新可从中下载更新文件，以便IoT 中心。 这通常是受 SAS 保护的只读 Blob URL，其过期时间设置为至少 4 小时。

ImportAction

导入更新操作。

名称	类型	说明
import	string	导入操作。

ImportManifestMetadata

描述导入清单的元数据，一个描述文件的文档，以及有关更新版本的其他元数据。

名称	类型	说明
hashes	object	一个 JSON 对象，其中包含文件的哈希 (es) 。 至少需要 SHA256 哈希。 可以将此对象视为一组键值对，其中键是哈希算法，值是使用该算法计算的文件的哈希。
sizeInBytes	integer	文件大小（字节数）。
url	string	IoT 中心设备更新可以从中下载导入清单的 Azure Blob 位置。 这通常是受 SAS 保护的只读 Blob URL，其过期时间设置为至少 4 小时。

ImportUpdateInput

导入更新输入元数据。

名称	类型	说明
files	FileImportMetadata[]	一个或多个更新文件属性，例如文件名和源 URL。
importManifest	ImportManifestMetadata	导入清单元数据，例如源 URL、文件大小/哈希等。