Freigeben über


Devices - Bulk Claim

Startet einen asynchronen Vorgang zum Massenanspruch von Geräten an den angegebenen Mandanten.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
tenantId
path True

string

uuid

Die Azure Sphere-Mandanten-ID.

Anforderungstext

Name Typ Beschreibung
body

string[]

Die Liste der Geräte-IDs, die beansprucht werden sollen. In einer Anforderung können maximal 1000 Geräte-IDs übergeben werden.

Antworten

Name Typ Beschreibung
202 Accepted

Operation

Der Vorgang wurde erfolgreich gestartet.

Definitionen

Name Beschreibung
ErrorResponse
Operation

ErrorResponse

Name Typ Beschreibung
Code enum:
  • 0 - OperationFailed
  • 1 - TenantInMigration
  • 2 - TenantMigrationRequired
  • 3 - ClientUpdateRequired
  • 4 - InternalServerError
  • 5 - BadRequest
  • 6 - Forbidden
  • 7 - Conflict
  • 8 - NotFound

Ruft den Code ab.

Message

string

Ruft die lesbare Fehlermeldung ab.

Operation

Name Typ Beschreibung
CompletedDateUTC

string

Ruft das Datum in UTC ab, an dem der Vorgang abgeschlossen wurde.

CreatedDateUTC

string

Ruft das Erstellungsdatum des Vorgangs in UTC ab.

DetailsLocation

string

Ruft den Speicherort zum Abrufen von Details des Vorgangs ab.

Error

ErrorResponse

OperationId

string

Ruft den eindeutigen Vorgangsbezeichner ab.

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

Ruft den Vorgangstypbezeichner ab.

ResourceLocation

string

Ruft den Speicherort der Ressourcen ab, die während der Ausführung des Vorgangs erstellt wurden.

StartedDateUTC

string

Ruft das Datum in UTC ab, an dem der Vorgang mit der Verarbeitung begonnen hat.

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

Ruft den Status des Vorgangs ab.

TenantId

string

Ruft den Mandantenbezeichner ab.