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

Device Management - List Deployments For Group

获取组的部署列表。

GET https://{endpoint}/deviceupdate/{instanceId}/management/groups/{groupId}/deployments?api-version=2021-06-01-preview
GET https://{endpoint}/deviceupdate/{instanceId}/management/groups/{groupId}/deployments?$filter={$filter}&api-version=2021-06-01-preview

URI 参数

Name In Required Type Description
endpoint
path True
  • string

帐户终结点。

groupId
path True
  • string

组标识。

instanceId
path True
  • string

帐户实例标识符。

api-version
query True
  • string

要用于客户端请求的 API 的版本。

$filter
query
  • string

限制返回的部署集。 可以筛选更新提供程序、名称和版本属性。

响应

Name Type Description
200 OK

部署。

Other Status Codes

默认响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

DeviceManagement_ListDeploymentsForGroup

Sample Request

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/management/groups/TestGroup/deployments?api-version=2021-06-01-preview

Sample Response

{
  "value": [
    {
      "deploymentId": "deploymentId1",
      "groupId": "TestGroup",
      "startDateTime": "2020-07-01T12:13:14Z",
      "updateId": {
        "provider": "provider1",
        "name": "name1",
        "version": "1.0.0.0"
      },
      "isCanceled": false,
      "isRetried": false
    },
    {
      "deploymentId": "deploymentId2",
      "groupId": "TestGroup",
      "startDateTime": "2020-08-01T12:13:14Z",
      "updateId": {
        "provider": "provider2",
        "name": "name2",
        "version": "2.0.0.0"
      },
      "isCanceled": false,
      "isRetried": false
    }
  ]
}

定义

Deployment

部署元数据。

DeploymentsList

部署列表。

Error

错误详细信息。

ErrorResponse

常见错误响应。

InnerError

包含与当前对象有关错误的更具体信息的对象。

UpdateId

更新标识符。

Deployment

部署元数据。

Name Type Description
deploymentId
  • string

部署标识符。

groupId
  • string

组标识

isCanceled
  • boolean

指示部署是否已取消的布尔标志。

isRetried
  • boolean

指示是否已重试部署的布尔标志。

startDateTime
  • string

部署开始日期时间。

updateId

更新标识。

DeploymentsList

部署列表。

Name Type Description
nextLink
  • string

指向下一页项的链接。

value

可分页项的集合。

Error

错误详细信息。

Name Type Description
code
  • string

服务器定义的错误代码。

details

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

innererror

包含与当前对象有关错误的更具体信息的对象。

message
  • string

错误的可读表示形式。

occurredDateTime
  • string

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

target
  • string

错误的目标。

ErrorResponse

常见错误响应。

Name Type Description
error

错误详细信息。

InnerError

包含与当前对象有关错误的更具体信息的对象。

Name Type Description
code
  • string

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

errorDetail
  • string

内部错误或异常消息。

innerError

包含与当前对象有关错误的更具体信息的对象。

message
  • string

错误的可读表示形式。

UpdateId

更新标识符。

Name Type Description
name
  • string

更新名称。

provider
  • string

更新提供程序。

version
  • string

更新版本。