Image - Upload

Servizio:

Azure Sphere Public API

Versione API:

v2

Avvia un'operazione asincrona per caricare l'immagine fornita.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
tenantId	path	True	string uuid	ID tenant di Azure Sphere.

Corpo della richiesta

Media Types: "application/octet-stream"

Nome	Tipo	Descrizione
body	byte[]	Dati dell'immagine, sotto forma di matrice di byte.

Risposte

Nome	Tipo	Descrizione
200 OK	Operation	Oggetto con i dettagli dell'operazione.
400 Bad Request	PublicApiErrorDetails[]	Raccolta di dettagli dell'errore.
404 Not Found	PublicApiErrorDetails[]	Raccolta di dettagli dell'errore.
500 Internal Server Error	PublicApiErrorDetails[]	Raccolta di dettagli dell'errore.

Definizioni

Nome	Descrizione
ErrorResponse
Operation
PublicApiErrorDetails

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 univoco dell'operazione.
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 la posizione delle risorse create durante l'esecuzione dell'operazione.
StartedDateUTC	string	Ottiene la data in formato UTC in cui l'operazione ha iniziato 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.

PublicApiErrorDetails

Nome	Tipo	Descrizione
Detail	string	Spiegazione leggibile specifica di questa occorrenza del problema.
ErrorCode	string	Rappresentazione di stringa di PublicApiErrorCode che definisce l'errore.
Extensions		Ottiene il dizionario per i membri dell'estensione. Le definizioni dei tipi di problema POSSONO estendere l'oggetto dettagli del problema con membri aggiuntivi. I membri dell'estensione vengono visualizzati nello stesso spazio dei nomi degli altri membri di un tipo di problema.
Instance	string	Riferimento URI che identifica l'occorrenza specifica del problema. Il sindaco potrebbe non produrre ulteriori informazioni se dereferenziato.
Status	integer	Codice di stato HTTP([RFC7231], sezione 6) generato dal server di origine per questa occorrenza del problema.
Title	string	Breve riepilogo leggibile del tipo di problema. NON DEVE passare da occorrenza a occorrenza del problema, ad eccezione dei fini della localizzazione(ad esempio, uso della negoziazione proattiva del contenuto; vedere[RFC7231], sezione 3.4).
Type	string	Riferimento URI [RFC3986] che identifica il tipo di problema. Questa specifica incoraggia che, quando viene dereferenziata, fornisce documentazione leggibile per il tipo di problema (ad esempio, usando HTML [W3C. REC-html5-20141028]). Quando questo membro non è presente, si presuppone che il relativo valore sia vuoto.