Share via

Tenants - Create

  • Riferimento
Service:
Azure Sphere Public API
API Version:
v2

Avvia un'operazione asincrona per creare un tenant di Azure Sphere.

POST https://prod.core.sphere.azure.net/v2/tenants/create

Corpo della richiesta

Nome Tipo Descrizione
DeviceId

string

ID del dispositivo usato per autorizzare la creazione del tenant. Questo dispositivo non deve essere già richiesto in alcun tenant. Questo campo è obbligatorio.
TenantFriendlyName

string

Nome del tenant: verrà visualizzato agli utenti e può essere usato per disambiguare gli utenti che hanno più tenant di Azure Sphere. Questo campo è obbligatorio.

Risposte

Nome Tipo Descrizione
200 OK

Operation

Avviato correttamente l'operazione.

Definizioni

Nome Descrizione
ErrorResponse
Operation
TenantCreationRequest

ErrorResponse

Nome Tipo Descrizione
Code enum:
  • 0 - OperationFailed
  • 1 - TenantInMigration
  • 2 - TenantMigrationRequired
  • 3 - ClientUpdateRequired
  • 4 - InternalServerError
  • 5 - BadRequest
  • 6 - Forbidden
  • 7 - Conflict
  • 8 - NotFound

Ottiene il codice.
Message

string

Ottiene il messaggio di errore leggibile.

Operation

Nome Tipo Descrizione
CompletedDateUTC

string

Ottiene la data in FORMATO UTC completata dall'operazione.
CreatedDateUTC

string

Ottiene la data di creazione dell'operazione in FORMATO UTC.
DetailsLocation

string

Ottiene il percorso per ottenere i dettagli dell'operazione.
Error

ErrorResponse

OperationId

string

Ottiene l'identificatore di operazione univoco.
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

Ottiene l'identificatore del tipo di operazione.
ResourceLocation

string

Ottiene il percorso delle risorse create durante l'esecuzione dell'operazione.
StartedDateUTC

string

Ottiene la data in formato UTC in cui l'operazione ha avviato l'elaborazione.
State enum:
  • 0 - NotStarted
  • 1 - InProgress
  • 2 - Complete
  • 3 - Failed
  • 4 - CompleteWithErrors

Ottiene lo stato dell'operazione.
TenantId

string

Ottiene l'identificatore del tenant.

TenantCreationRequest

Nome Tipo Descrizione
DeviceId

string

ID del dispositivo usato per autorizzare la creazione del tenant. Questo dispositivo non deve essere già richiesto in alcun tenant. Questo campo è obbligatorio.
TenantFriendlyName

string

Nome del tenant: verrà visualizzato agli utenti e può essere usato per disambiguare gli utenti che hanno più tenant di Azure Sphere. Questo campo è obbligatorio.