Freigeben über


Erstellen von fileStorageContainer

Namespace: microsoft.graph

Erstellen Sie ein neues fileStorageContainer-Objekt .

Der durch containerTypeId identifizierte Containertyp muss im Mandanten registriert werden.

Bei delegierten Aufrufen wird der aufrufende Benutzer als Besitzer des fileStorageContainer festgelegt.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) FileStorageContainer.Selected Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung FileStorageContainer.Selected Nicht verfügbar.

Zusätzlich zu Den Microsoft Graph-Berechtigungen muss Ihre App auch über die erforderlichen Berechtigungen auf Containertypebene verfügen, um diese API aufzurufen. Ausführliche Informationen zu Containertypen finden Sie unter Containertypen. Weitere Informationen zu Berechtigungen auf Containertypebene finden Sie unter SharePoint Embedded Authorization.

HTTP-Anforderung

POST /storage/fileStorage/containers

Optionale Abfrageparameter

Diese Methode unterstützt die folgenden OData-Abfrageparameter, um die Antwort anzupassen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.

Name Beschreibung
dataLocation Gibt den gewünschten Datenspeicherort für die Containererstellung in Multi-Geo-Mandanten an. Durch Weglassen des $dataLocation Parameters in der Anforderung wird der Container am Standardspeicherort des Mandanten erstellt. Weitere Informationen finden Sie unter Verfügbare Multi-Geo-Regionen und deren Standortcodes.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des fileStorageContainer-Objekts an.

Sie können die folgenden Eigenschaften angeben, wenn Sie einen fileStorageContainer erstellen.

Eigenschaft Typ Beschreibung
displayName String Der Anzeigename des Containers. Erforderlich.
description String Vom Benutzer sichtbare Beschreibung des Containers. Optional.
containerTypeId GUID Der Containertyp des containers instance. Erforderlich.
settings fileStorageContainerSettings Dem Container zugeordnete Einstellungen. Optional.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein fileStorageContainer-Objekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt, wie Sie einen fileStorageContainer erstellen.

POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers
Content-Type: application/json

{
  "displayName": "My Application Storage Container",
  "description": "Description of My Application Storage Container",
  "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73",
  "settings": {
    "isOcrEnabled": true
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-type: application/json

{
  "@odata.type": "#microsoft.graph.fileStorageContainer",
  "id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z",
  "displayName": "My Application Storage Container",
  "description": "Description of My Application Storage Container",
  "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73",
  "status": "inactive",
  "createdDateTime": "2021-11-24T15:41:52.347Z",
  "settings": {
    "isOcrEnabled": true
  }
}