共用方式為


Devices - Move

啟動非同步作業,將指定的裝置移至指定的 DeviceGroup。

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

URI 參數

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

string

裝置的識別碼。

tenantId
path True

string

uuid

Azure Sphere 租使用者識別碼。

要求本文

名稱 類型 Description
body

string

要指派裝置的 DeviceGroup 識別碼。

回應

名稱 類型 Description
202 Accepted

Operation

已成功啟動作業。

定義

名稱 Description
ErrorResponse
Operation

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

取得租使用者識別碼。