Erstellen von „mobileAppContentFile“
Namespace: microsoft.graph
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Diese Methode erstellt ein neues Objekt des Typs mobileAppContentFile.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | DeviceManagementApps.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | DeviceManagementApps.ReadWrite.All |
HTTP-Anforderung
POST /deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs „mobileAppContentFile“ an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs „mobileAppContentFile“ erstellen.
Eigenschaft | Typ | Beschreibung |
---|---|---|
azureStorageUri | String | Gibt den Azure Storage-URI an, in den die Datei hochgeladen wird. Wird vom Dienst beim Empfang einer gültigen mobileAppContentFile erstellt. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. |
isCommitted | Boolean | Ein Wert, der angibt, ob für die Datei ein Commit ausgeführt wurde. Eine App-Inhaltsdatei mit Commit wurde vollständig hochgeladen und vom Intune-Dienst überprüft. TRUE bedeutet, dass die App-Inhaltsdatei committet wird. FALSE bedeutet, dass die App-Inhaltsdatei nicht committet wird. Der Standardwert ist FALSE. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. |
id | String | Der eindeutige Bezeichner für diese mobileAppContentFile. Diese ID wird während der Erstellung der mobileAppContentFile zugewiesen. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. |
createdDateTime | DateTimeOffset | Gibt das Erstellungsdatum und die Erstellungszeit für die App-Inhaltsdatei im ISO 8601-Format an. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. |
name | String | Gibt den Namen der Datei an. |
size | Int64 | Die Größe der Datei vor der Verschlüsselung. Um als veraltet zu gelten, verwenden Sie stattdessen die SizeInBytes-Eigenschaft. |
sizeEncrypted | Int64 | Die Größe der Datei nach der Verschlüsselung. Um als veraltet zu gelten, verwenden Sie stattdessen die SizeEncryptedInBytes-Eigenschaft. |
sizeInBytes | Int64 | Gibt die ursprüngliche Größe der Datei in Bytes an. Gültige Werte 0 bis 9,22337203685478E+18 |
sizeEncryptedInBytes | Int64 | Gibt die Größe der Datei nach der Verschlüsselung in Bytes an. Gültige Werte 0 bis 9,22337203685478E+18 |
azureStorageUriExpirationDateTime | DateTimeOffset | Gibt das Datum und die Uhrzeit des Ablaufs des Azure-Speicher-URI im ISO 8601-Format an. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. |
manifest | Binär | Gibt die Manifestinformationen an, die Dateimetadaten enthalten. |
uploadState | mobileAppContentFileUploadState | Gibt den Status der aktuellen Uploadanforderung an. Mögliche Werte sind: success, transientError, error, unknown, azureStorageUriRequestSuccess, azureStorageUriRequestPending, azureStorageUriRequestFailed, azureStorageUriRequestTimedOut, azureStorageUriRenewalSuccess, azureStorageUriRenewalPending, azureStorageUriRenewalFailed, azureStorageUriRenewalTimedOut, commitFileSuccess, commitFilePending, commitFileFailed, commitFileTimedOut. Der Standardwert ist success. Diese Eigenschaft ist schreibgeschützt. Mögliche Werte sind: success , transientError , error , unknown , azureStorageUriRequestSuccess , azureStorageUriRequestPending , azureStorageUriRequestFailed , azureStorageUriRequestTimedOut , azureStorageUriRenewalSuccess , azureStorageUriRenewalPending , azureStorageUriRenewalFailed , azureStorageUriRenewalTimedOut , commitFileSuccess , commitFilePending , commitFileFailed , commitFileTimedOut . |
isDependency | Boolesch | Gibt an, ob diese Inhaltsdatei eine Abhängigkeit für die Standard Inhaltsdatei ist. TRUE bedeutet, dass die Inhaltsdatei eine Abhängigkeit ist, FALSE bedeutet, dass die Inhaltsdatei keine Abhängigkeit ist und die Standard Inhaltsdatei ist. Der Standardwert ist FALSE. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 201 Created
und ein Objekt des Typs mobileAppContentFile im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
POST https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}/contentVersions/{mobileAppContentId}/files
Content-type: application/json
Content-length: 419
{
"@odata.type": "#microsoft.graph.mobileAppContentFile",
"azureStorageUri": "Azure Storage Uri value",
"isCommitted": true,
"name": "Name value",
"size": 4,
"sizeEncrypted": 13,
"sizeInBytes": 11,
"sizeEncryptedInBytes": 4,
"azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00",
"manifest": "bWFuaWZlc3Q=",
"uploadState": "transientError",
"isDependency": true
}
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 527
{
"@odata.type": "#microsoft.graph.mobileAppContentFile",
"azureStorageUri": "Azure Storage Uri value",
"isCommitted": true,
"id": "eab2e29b-e29b-eab2-9be2-b2ea9be2b2ea",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"name": "Name value",
"size": 4,
"sizeEncrypted": 13,
"sizeInBytes": 11,
"sizeEncryptedInBytes": 4,
"azureStorageUriExpirationDateTime": "2017-01-01T00:00:08.4940464-08:00",
"manifest": "bWFuaWZlc3Q=",
"uploadState": "transientError",
"isDependency": true
}