Partilhar via


Tenants - Create

Inicia uma operação assíncrona para criar um locatário do Azure Sphere.

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

Corpo do Pedido

Name Tipo Description
DeviceId

string

A ID do dispositivo que está sendo usado para autorizar a criação desse locatário. Este dispositivo não deve já ser reivindicado em nenhum inquilino. Este é um campo obrigatório.

TenantFriendlyName

string

O nome do locatário - ele será exibido para os usuários e pode ser usado para desambiguar para usuários que têm vários locatários do Azure Sphere. Este é um campo obrigatório.

Respostas

Name Tipo Description
200 OK

Operation

Iniciou a operação com sucesso.

Definições

Name Description
ErrorResponse
Operation
TenantCreationRequest

ErrorResponse

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

Obtém o código.

Message

string

Obtém a mensagem de erro legível por humanos.

Operation

Name Tipo Description
CompletedDateUTC

string

Obtém a data em UTC que a operação foi concluída.

CreatedDateUTC

string

Obtém a data de criação da operação em UTC.

DetailsLocation

string

Obtém o local para obter detalhes da operação.

Error

ErrorResponse

OperationId

string

Obtém o identificador de operação exclusivo.

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

Obtém o identificador de tipo de operação.

ResourceLocation

string

Obtém a localização dos recursos criados durante a execução da operação.

StartedDateUTC

string

Obtém a data em UTC que a operação começou a processar.

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

Obtém o estado da operação.

TenantId

string

Obtém o identificador de locatário.

TenantCreationRequest

Name Tipo Description
DeviceId

string

A ID do dispositivo que está sendo usado para autorizar a criação desse locatário. Este dispositivo não deve já ser reivindicado em nenhum inquilino. Este é um campo obrigatório.

TenantFriendlyName

string

O nome do locatário - ele será exibido para os usuários e pode ser usado para desambiguar para usuários que têm vários locatários do Azure Sphere. Este é um campo obrigatório.