通过

Devices - Bulk Claim

  • 参考
Service:
Azure Sphere Public API
API Version:
v2

启动异步操作，将设备批量声明到指定租户。

PUT https://prod.core.sphere.azure.net/v2/tenants/{tenantId}/devices

URI 参数

名称 在 必需 类型 说明
tenantId
 path True

string

uuid

Azure Sphere 租户 ID。

请求正文

名称 类型 说明
body

string[]

要声明的设备 ID 列表。 一个请求中最多可以传递 1000 个设备 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

获取租户标识符。