Image - Upload

Dienst:

Azure Sphere Public API

API-Version:

v2

Startet einen asynchronen Vorgang zum Hochladen des bereitgestellten Bilds.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
tenantId	path	True	string uuid	Die Azure Sphere-Mandanten-ID.

Anforderungstext

Media Types: "application/octet-stream"

Name	Typ	Beschreibung
body	byte[]	Die Bilddaten in Form eines Bytearrays.

Antworten

Name	Typ	Beschreibung
200 OK	Operation	Ein Objekt mit Vorgangsdetails.
400 Bad Request	PublicApiErrorDetails[]	Eine Sammlung von Fehlerdetails.
404 Not Found	PublicApiErrorDetails[]	Eine Sammlung von Fehlerdetails.
500 Internal Server Error	PublicApiErrorDetails[]	Eine Sammlung von Fehlerdetails.

Definitionen

Name	Beschreibung
ErrorResponse
Operation
PublicApiErrorDetails

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 des Menschen 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.

PublicApiErrorDetails

Name	Typ	Beschreibung
Detail	string	Eine menschlichen lesbare Erklärung, die für dieses Auftreten des Problems spezifisch ist.
ErrorCode	string	Eine Zeichenfolgendarstellung von PublicApiErrorCode, die den Fehler definiert.
Extensions		Ruft das Wörterbuch für Erweiterungsmitglieder ab. Problemtypdefinitionen KÖNNEN das Problemdetails-Objekt mit zusätzlichen Membern erweitern. Erweiterungsmember werden im selben Namespace wie andere Member eines Problemtyps angezeigt.
Instance	string	Ein URI-Verweis, der das spezifische Auftreten des Problems identifiziert. Der Bürgermeister kann keine weiteren Informationen liefern, wenn dies ableitend ist.
Status	integer	Der HTTP-Statuscode([RFC7231], Abschnitt 6), der vom Ursprungsserver für dieses Auftreten des Problems generiert wurde.
Title	string	Eine kurze, vom Menschen lesbare Zusammenfassung des Problemtyps. Es SOLLTE sich nicht von Auftreten zu Auftreten des Problems ändern, mit Ausnahme der Lokalisierung (z. B. die Verwendung proaktiver Inhaltsaushandlung; siehe[RFC7231], Abschnitt 3.4).
Type	string	Ein URI-Verweis [RFC3986], der den Problemtyp identifiziert. Diese Spezifikation empfiehlt, dass sie, wenn sie abgeleitet wird, eine lesbare Dokumentation für den Problemtyp bereitstellt (z. B. mit HTML [W3C). REC-html5-20141028]). Wenn dieses Element nicht vorhanden ist, wird davon ausgegangen, dass sein Wert leer ist.