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

Updates - Get Operations

获取所有导入更新操作的列表。 在自动删除之前,已完成的操作将保留 7 天。 此 API 版本不返回删除操作。

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations
GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations?$filter={$filter}&$top={$top}

URI 参数

名称 必需 类型 说明
accountEndpoint
path True

string

帐户终结点。

instanceId
path True

string

帐户实例标识符。

$filter
query

string

限制返回的操作集。 仅支持一个特定筛选器:“status eq 'NotStarted' 或 status eq 'Running'”

$top
query

integer

int32

指定一个非负整数 n,用于限制从集合返回的项数。 服务返回的可用项数不超过指定的值 n。

响应

名称 类型 说明
200 OK

PageableListOfOperations

操作详细信息。

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_GetOperations

示例请求

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/operations

示例响应

{
  "value": [
    {
      "operationId": "e4491c54-916f-443d-9094-bcca546ace2f",
      "status": "Succeeded",
      "resourceLocation": "/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0",
      "traceId": "2b881ef9deaf5d45b0a716ca5b4145ec",
      "createdDateTime": "2020-04-22T21:00:53.2548897+00:00",
      "lastActionDateTime": "2020-04-22T21:01:43.9401420+00:00",
      "etag": "\"a0f7b6f2-3f6c-4eb6-8a59-2f5411c23888\""
    }
  ]
}

定义

名称 说明
Error

错误详细信息。

InnerError

一个 对象,该对象包含比当前对象更具体的错误信息。

Operation

操作元数据。

OperationStatus

操作状态。

PageableListOfOperations

支持服务器分页的操作列表。

UpdateId

更新标识符。

Error

错误详细信息。

名称 类型 说明
code

string

服务器定义的错误代码。

details

Error[]

导致报告错误的错误的数组。

innererror

InnerError

一个 对象,该对象包含比当前对象更具体的错误信息。

message

string

错误的用户可读表示形式。

occurredDateTime

string

发生错误的日期和时间(UTC)。

target

string

错误的目标。

InnerError

一个 对象,该对象包含比当前对象更具体的错误信息。

名称 类型 说明
code

string

比包含错误所提供的代码更具体的错误代码。

errorDetail

string

内部错误或异常消息。

innerError

InnerError

一个 对象,该对象包含比当前对象更具体的错误信息。

message

string

错误的用户可读表示形式。

Operation

操作元数据。

名称 类型 说明
createdDateTime

string

创建操作时的 UTC 日期和时间。

error

Error

遇到操作错误(如果有)。

etag

string

操作 ETag。

lastActionDateTime

string

上次更新操作状态的 UTC 日期和时间。

operationId

string

操作 ID。

resourceLocation

string

操作成功时导入的更新的位置。

status

OperationStatus

操作状态。

traceId

string

Microsoft 支持部门可用于故障排除的操作相关标识。

updateId

UpdateId

正在导入或删除的更新的标识。 对于导入,只有在成功处理导入清单后,才会填充此属性。

OperationStatus

操作状态。

名称 类型 说明
Failed

string

后台操作已完成,但失败。

NotStarted

string

后台操作已创建,但尚未启动。

Running

string

后台操作当前正在运行。

Succeeded

string

后台操作成功完成。

Undefined

string

未定义的操作状态。

PageableListOfOperations

支持服务器分页的操作列表。

名称 类型 说明
nextLink

string

指向项的下一页的链接。

value

Operation[]

可分页项的集合。

UpdateId

更新标识符。

名称 类型 说明
name

string

更新名称。

provider

string

更新提供程序。

version

string

更新版本。