Sdílet prostřednictvím

Image - Upload

  • Reference
Služba:
Azure Sphere Public API
Verze rozhraní API:
v2

Spustí asynchronní operaci pro nahrání poskytnuté image.

POST https://prod.core.sphere.azure.net/v2/tenants/{tenantId}/images

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
tenantId
 path True

string

uuid

ID tenanta Azure Sphere.

Text požadavku

Media Types: "application/octet-stream"

Name Typ Description
body

byte[]

Data obrázku ve formě bajtového pole.

Odpovědi

Name Typ Description
200 OK

Operation

Objekt s podrobnostmi o operaci.
400 Bad Request

PublicApiErrorDetails[]

Kolekce podrobností o chybě.
404 Not Found

PublicApiErrorDetails[]

Kolekce podrobností o chybě.
500 Internal Server Error

PublicApiErrorDetails[]

Kolekce podrobností o chybě.

Definice

Name Description
ErrorResponse
Operation
PublicApiErrorDetails

ErrorResponse

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

Získá kód.
Message

string

Získá chybovou zprávu, která je čitelná pro člověka.

Operation

Name Typ Description
CompletedDateUTC

string

Získá datum v UTC, že operace byla dokončena.
CreatedDateUTC

string

Získá datum vytvoření operace v UTC.
DetailsLocation

string

Získá umístění pro získání podrobností o operaci.
Error

ErrorResponse

OperationId

string

Získá jedinečný identifikátor operace.
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

Získá identifikátor typu operace.
ResourceLocation

string

Získá umístění prostředků vytvořených během provádění operace.
StartedDateUTC

string

Získá datum ve standardu UTC, kdy operace začala zpracovávat.
State enum:
  • 0 - NotStarted
  • 1 - InProgress
  • 2 - Complete
  • 3 - Failed
  • 4 - CompleteWithErrors

Získá stav operace.
TenantId

string

Získá identifikátor tenanta.

PublicApiErrorDetails

Name Typ Description
Detail

string

Popis, který je čitelný pro člověka specifický pro tento výskyt problému.
ErrorCode

string

Řetězcová reprezentace PublicApiErrorCode definující chybu.
Extensions

Získá slovník pro členy rozšíření. Definice typu problému mohou rozšířit objekt podrobností o problému s dalšími členy. Členy rozšíření se zobrazují ve stejném oboru názvů jako ostatní členové typu problému.
Instance

string

Odkaz na identifikátor URI, který identifikuje konkrétní výskyt problému. Starosta nemusí poskytovat další informace v případě, že dojde k dereference.
Status

integer

Stavový kód HTTP([RFC7231], oddíl 6) vygenerovaný počátečním serverem na základě výskytu problému.
Title

string

Krátký přehled typu problému čitelný člověkem. Nemělo by se měnit z výskytu na výskyt problému, s výjimkou účelů lokalizace (např. použití proaktivního vyjednávání obsahu; viz[RFC7231], oddíl 3.4).
Type

string

Odkaz na identifikátor URI [RFC3986], který identifikuje typ problému. Tato specifikace doporučuje, aby při dereferencování poskytovala pro typ problému čitelný dokument pro člověka (např. pomocí HTML [W3C). REC-html5-20141028]). Pokud tento člen neexistuje, předpokládá se, že jeho hodnota bude prázdná.