通过

Image - Upload

  • 参考
服务:
Azure Sphere Public API
API 版本:
v2

启动异步操作以上传提供的图像。

POST https://prod.core.sphere.azure.net/v2/tenants/{tenantId}/images

URI 参数

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

string

uuid

Azure Sphere 租户 ID。

请求正文

Media Types: "application/octet-stream"

名称 类型 说明
body

byte[]

图像数据，采用字节数组的形式。

响应

名称 类型 说明
200 OK

Operation

具有操作详细信息的对象。
400 Bad Request

PublicApiErrorDetails[]

错误详细信息的集合。
404 Not Found

PublicApiErrorDetails[]

错误详细信息的集合。
500 Internal Server Error

PublicApiErrorDetails[]

错误详细信息的集合。

定义

名称 说明
ErrorResponse
Operation
PublicApiErrorDetails

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

获取租户标识符。

PublicApiErrorDetails

名称 类型 说明
Detail

string

特定于此问题的可读说明。
ErrorCode

string

定义错误的 PublicApiErrorCode 的字符串表示形式。
Extensions

获取扩展成员的字典。问题类型定义可能会使用其他成员扩展问题详细信息对象。 扩展成员与问题类型的其他成员位于同一命名空间中。
Instance

string

一个 URI 引用，用于标识问题的特定匹配项。如果取消引用，市长可能不会产生进一步的信息。
Status

integer

源服务器第 6 节生成的 HTTP 状态代码（[RFC7231]）出现问题。
Title

string

问题类型的简短、可读摘要。除非本地化目的（例如，使用主动内容协商）;请参阅[RFC7231]，第 3.4 节除外，否则它不应从问题发生更改为出现问题。
Type

string

标识问题类型的 URI 引用 [RFC3986]。 此规范鼓励在取消引用时为问题类型（例如，使用 HTML [W3C）提供可读文档。REC-html5-20141028]。 当此成员不存在时，其值假定为空。