Deployments - Create

启动异步操作,将指定的映像集部署到指定的 DeviceGroup。

POST https://prod.core.sphere.azure.net/v2/tenants/{tenantId}/devicegroups/{deviceGroupId}/deployments

URI 参数

名称 必需 类型 说明
deviceGroupId
path True

string

uuid

映像要部署到的设备组对象的唯一 ID。

tenantId
path True

string

uuid

Azure Sphere 租户 ID。

请求正文

名称 类型 说明
body

string[]

要部署的唯一映像 ID () 的列表。

响应

名称 类型 说明
202 Accepted

Operation

已成功启动操作。

定义

名称 说明
ErrorResponse
Operation

ErrorResponse

名称 类型 说明
Code enum:
  • 0 - OperationFailed
  • 1 - TenantInMigration
  • 2 - TenantMigrationRequired
  • 3 - ClientUpdateRequired
  • 4 - InternalServerError
  • 5 - BadRequest
  • 6 - Forbidden
  • 7 - Conflict
  • 8 - NotFound

获取代码。

Message

string

获取人类可读的错误消息。

Operation

名称 类型 说明
CompletedDateUTC

string

获取操作完成的 UTC 日期。

CreatedDateUTC

string

获取 UTC 格式的操作创建日期。

DetailsLocation

string

获取用于获取操作详细信息的位置。

Error

ErrorResponse

OperationId

string

获取唯一的操作标识符。

OperationType enum:
  • 0 - DeviceClaim
  • 1 - DeviceUnclaim
  • 10 - DeleteProduct
  • 11 - BulkDeviceClaim
  • 2 - DeviceUpdateDeviceGroup
  • 3 - MigrateTenant
  • 4 - CreateProduct
  • 5 - DeployToDeviceGroup
  • 6 - DeployToOSFeed
  • 7 - ImageUpload
  • 8 - TenantCreation
  • 9 - DeleteDeviceGroup

获取操作类型标识符。

ResourceLocation

string

获取在执行操作期间创建的资源的位置。

StartedDateUTC

string

获取操作开始处理的 UTC 日期。

State enum:
  • 0 - NotStarted
  • 1 - InProgress
  • 2 - Complete
  • 3 - Failed
  • 4 - CompleteWithErrors

获取操作的状态。

TenantId

string

获取租户标识符。