Freigeben über

Tenants - Create

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

Startet einen asynchronen Vorgang, um einen Azure Sphere-Mandanten zu erstellen.

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

Anforderungstext

Name Typ Beschreibung
DeviceId

string

Die ID des Geräts, das zum Autorisieren dieser Mandantenerstellung verwendet wird. Dieses Gerät darf nicht bereits in einem Mandanten beansprucht werden. Dies ist ein Pflichtfeld.
TenantFriendlyName

string

Der Name des Mandanten: Dieser wird Benutzern angezeigt und kann verwendet werden, um für Benutzer mit mehreren Azure Sphere-Mandanten mehrdeutig zu machen. Dies ist ein Pflichtfeld.

Antworten

Name Typ Beschreibung
200 OK

Operation

Der Vorgang wurde erfolgreich gestartet.

Definitionen

Name Beschreibung
ErrorResponse
Operation
TenantCreationRequest

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.

TenantCreationRequest

Name Typ Beschreibung
DeviceId

string

Die ID des Geräts, das zum Autorisieren dieser Mandantenerstellung verwendet wird. Dieses Gerät darf nicht bereits in einem Mandanten beansprucht werden. Dies ist ein Pflichtfeld.
TenantFriendlyName

string

Der Name des Mandanten: Dieser wird Benutzern angezeigt und kann verwendet werden, um für Benutzer mit mehreren Azure Sphere-Mandanten mehrdeutig zu machen. Dies ist ein Pflichtfeld.