共用方式為

Image - Upload

  • 參考
服務:
Azure Sphere Public API
API 版本:
v2

啟動異步操作以上傳提供的影像。

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

URI 參數

名稱 位於 必要 類型 Description
tenantId
 path True

string

uuid

Azure Sphere 租用戶標識符。

要求本文

Media Types: "application/octet-stream"

名稱 類型 Description
body

byte[]

影像數據，格式為位元組陣列。

回應

名稱 類型 Description
200 OK

Operation

具有作業詳細數據的物件。
400 Bad Request

PublicApiErrorDetails[]

錯誤詳細數據的集合。
404 Not Found

PublicApiErrorDetails[]

錯誤詳細數據的集合。
500 Internal Server Error

PublicApiErrorDetails[]

錯誤詳細數據的集合。

定義

名稱 Description
ErrorResponse
Operation
PublicApiErrorDetails

ErrorResponse

名稱 類型 Description
Code enum:
  • 0 - OperationFailed
  • 1 - TenantInMigration
  • 2 - TenantMigrationRequired
  • 3 - ClientUpdateRequired
  • 4 - InternalServerError
  • 5 - BadRequest
  • 6 - Forbidden
  • 7 - Conflict
  • 8 - NotFound

取得程序代碼。
Message

string

取得人類可讀取的錯誤訊息。

Operation

名稱 類型 Description
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

名稱 類型 Description
Detail

string

發生此問題的特定人類可讀說明。
ErrorCode

string

PublicApiErrorCode 定義錯誤的字串表示。
Extensions

取得延伸模組成員的字典。問題類型定義可能會使用其他成員來擴充問題詳細數據物件。 擴充成員會出現在與問題類型其他成員相同的命名空間中。
Instance

string

識別問題特定出現的 URI 參考。如果取值，市長可能不會產生進一步的資訊。
Status

integer

由源伺服器產生的 HTTP 狀態代碼（[RFC7231]，第 6 節就會發生問題。
Title

string

問題類型的簡短人類可讀摘要。除非本地化目的（例如，使用主動式內容交涉，請參閱[RFC7231]，第 3.4 節，否則不應將問題從發生變更為發生問題。
Type

string

識別問題類型的 URI 參考 [RFC3986]。 此規格鼓勵在取值時，它會提供人類可閱讀的問題類型檔（例如，使用 HTML [W3C]。REC-html5-20141028]]。 當這個成員不存在時，其值會假設為空白。