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

Deployments - Get Deployment Devices

服务:

Device Update

API 版本:

2020-09-01

获取部署中的设备及其状态的列表。 可用于获取失败设备的列表。

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}/devicestates

具有可选参数:

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}/devicestates?$filter={$filter}

URI 参数

名称	在	必需	类型	说明
accountEndpoint	path	True	string	帐户终结点。
deploymentId	path	True	string	部署标识符。
instanceId	path	True	string	帐户实例标识符。
$filter	query		string	限制返回的部署设备状态集。 可以筛选 deviceId 和/或 deviceState。

响应

名称	类型	说明
200 OK	PageableListOfDeploymentDeviceStates	部署中的设备及其状态。
404 Not Found		未找到。

安全性

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	模拟用户帐户

示例

Deployments_GetDeploymentDevices

示例请求

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/management/deployments/deploymentId/devicestates

示例响应

状态代码:

200

{
  "value": [
    {
      "deviceId": "deviceId1",
      "retryCount": 1,
      "movedOnToNewDeployment": false,
      "deviceState": "Succeeded"
    },
    {
      "deviceId": "deviceId2",
      "retryCount": 1,
      "movedOnToNewDeployment": false,
      "deviceState": "Succeeded"
    }
  ]
}

状态代码:

404

定义

名称	说明
DeploymentDeviceState	部署设备状态。
DeviceDeploymentState	部署状态。
PageableListOfDeploymentDeviceStates	部署设备状态的列表。

DeploymentDeviceState

部署设备状态。

名称	类型	说明
deviceId	string	设备标识。
deviceState	DeviceDeploymentState	部署设备状态。
movedOnToNewDeployment	boolean	指示此设备是否处于较新部署中且无法再重试此部署的布尔标志。
retryCount	integer	在此设备上重试此部署的次数。

DeviceDeploymentState

部署状态。

名称	类型	说明
Canceled	string	已取消部署。
Failed	string	部署已完成但失败。
InProgress	string	部署正在进行中。
Incompatible	string	部署与设备不兼容。
Succeeded	string	部署已成功完成。

PageableListOfDeploymentDeviceStates

部署设备状态的列表。

名称	类型	说明
nextLink	string	指向项的下一页的链接。
value	DeploymentDeviceState[]	可分页项的集合。