File Uploads - Get

Service:

IoT Central

API Version:

2022-07-31

Rufen Sie die Konfiguration des Speicherkontos für den Dateiupload ab.

GET https://{subdomain}.{baseDomain}/api/fileUploads?api-version=2022-07-31

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
baseDomain	path	True	string	Die Basisdomäne für alle Azure IoT Central-Dienstanforderungen.
subdomain	path	True	string	Die Unterdomäne der Anwendung.
api-version	query	True	string	Die Version der aufgerufenen API.

Antworten

Name	Typ	Beschreibung
200 OK	FileUpload	Erfolg
Other Status Codes	Error	Eine vom IoT Central-Dienst empfangene Fehlerantwort. Headers x-ms-error-code: string

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Get file upload storage account configuration

Sample Request

HTTP

GET https://appsubdomain.azureiotcentral.com/api/fileUploads?api-version=2022-07-31

Sample Response

Status code:

200

{
  "account": "contoso-account",
  "connectionString": "DefaultEndpointsProtocol=https;AccountName=MyAccountName;AccountKey=*****;EndpointSuffix=core.windows.net",
  "container": "container",
  "state": "succeeded"
}

Definitionen

Name	Beschreibung
Error	Die Antwortfehlerdefinition.
ErrorDetails	Die Detailinformationen des Fehlers.
FileUpload	Die Konfigurationsdefinition für den Dateiupload.
FileUploadState	Der Status der Dateiuploadkonfiguration

Error

Die Antwortfehlerdefinition.

Name	Typ	Beschreibung
error	ErrorDetails	Fehlerdetails für die aktuelle Anforderung.

ErrorDetails

Die Detailinformationen des Fehlers.

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Fehlermeldungsdetails.
requestId	string	Korrelations-ID für die aktuelle Anforderung.
time	string	Der Zeitpunkt, zu dem bei der Fehleranforderung ein Fehler aufgetreten ist.

FileUpload

Die Konfigurationsdefinition für den Dateiupload.

Name	Typ	Beschreibung
account	string	Der Speicherkontoname, in den die Datei hochgeladen werden soll.
connectionString	string	Die zum Konfigurieren des Speicherkontos verwendete Verbindungszeichenfolge
container	string	Der Name des Containers im Speicherkonto
etag	string	ETag zur Vermeidung von Konflikten mit mehreren Uploads
sasTtl	string	ISO 8601 duration standard, The time the request of device's request to upload a file is valid before it expires.
state	FileUploadState	Der Status der Dateiuploadkonfiguration

FileUploadState

Der Status der Dateiuploadkonfiguration

Name	Typ	Beschreibung
deleting	string
failed	string
pending	string
succeeded	string
updating	string