通过

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

Updates - Import Update

服务:
Device Update
API 版本:
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 响应标头中指定。

标头

  • Location: string
  • Operation-Location: string
429 Too Many Requests

请求过多;在一段时间内可以执行多少个作，以及可以执行多少个并发导入和删除后台作的速率限制。

安全性

azure_auth_implicit

Azure Active Directory OAuth2 隐式流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

azure_auth_code

Azure Active Directory OAuth2 AccessCode 流

类型: oauth2
流向: accessCode
授权 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
令牌 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

作用域

名称 说明
user_impersonation 模拟用户帐户

azure_auth_application

Azure Active Directory OAuth2 应用程序流

类型: oauth2
流向: application
令牌 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

作用域

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

azure_auth_password

Azure Active Directory OAuth2 密码流

类型: oauth2
流向: password
令牌 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

Updates_ImportUpdate

示例请求

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

示例响应

状态代码:
202 
Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
Operation-Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
状态代码:
429

定义

名称 说明
FileImportMetadata

描述更新文件的元数据。
ImportAction

导入更新作。
ImportManifestMetadata

描述导入清单的元数据，描述有关更新版本的文件和其他元数据的文档。
ImportUpdateInput

导入更新输入元数据。

FileImportMetadata

Object

描述更新文件的元数据。

名称 类型 说明
filename

string

更新导入清单中指定的文件名。
url

string

可以通过 IoT 中心的设备更新从中下载更新文件的 Azure Blob 位置。 这通常是一个只读受 SAS 保护的 Blob URL，过期时间设置为至少 4 小时。

ImportAction

枚举

导入更新作。

值 说明
import

导入作。

ImportManifestMetadata

Object

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

名称 类型 说明
hashes

object

包含文件的哈希（es）的 JSON 对象。 至少需要 SHA256 哈希。 可以将此对象视为一组键值对，其中键是哈希算法，该值是使用该算法计算的文件的哈希。
sizeInBytes

integer (int64)

文件大小（以字节数为单位）。
url

string

可从中下载导入清单的 Azure Blob 位置，供 IoT 中心的设备更新下载。 这通常是一个只读受 SAS 保护的 Blob URL，过期时间设置为至少 4 小时。

ImportUpdateInput

Object

导入更新输入元数据。

名称 类型 说明
files

FileImportMetadata[]

一个或多个更新文件属性，如文件名和源 URL。
importManifest

ImportManifestMetadata

导入清单元数据，例如源 URL、文件大小/哈希等。