Hinzufügen benutzerdefinierter Eigenschaften zu einem fileStorageContainer

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Hinzufügen benutzerdefinierter Eigenschaften zu einem fileStorageContainer-Objekt .

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) FileStorageContainer.Selected Nicht verfügbar.
Application FileStorageContainer.Selected Nicht verfügbar.

Hinweis

Zusätzlich zu den Microsoft Graph-Berechtigungen muss Ihre App über die erforderliche Berechtigung auf Containertypebene verfügen, um diese API aufzurufen. Weitere Informationen finden Sie unter Containertypen. Weitere Informationen zu Berechtigungen auf Containertypebene finden Sie unter SharePoint Embedded-Autorisierung.

HTTP-Anforderung

PATCH /storage/fileStorage/containers/{containerId}/customProperties

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 eines fileStorageContainerCustomPropertyDictionary an, bei dem es sich um eine Zuordnung mit Zeichenfolgenschlüsseln und fileStorageContainerCustomPropertyValue-Werten handelt.

Sie können die folgenden Eigenschaften angeben, wenn Sie eine benutzerdefinierte Eigenschaft erstellen.

Eigenschaft Typ Beschreibung
isPatternToken Boolean Gibt an, ob es sich bei dem Wert um ein urlTemplate Muster handelt (z. B. ein {itemId} Token wie zum Konfigurieren des Umleitungsverhaltens beim Öffnen von Dateien) und nicht um einen Literalwert, den Verbraucher vor der Verwendung auflösen müssen. Optional. Der Standardwert ist false.
isSearchable Boolean Ein Flag, das angibt, ob die Immobilie durchsuchbar ist. Optional. Der Standardwert ist false.
Wert Zeichenfolge Der Wert der benutzerdefinierten Eigenschaft. Erforderlich.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 201 Created zurückgegeben.

Beispiele

Beispiel 1: Erstellen einer benutzerdefinierten Eigenschaft

Anforderung

Im folgenden Beispiel wird gezeigt, wie Sie eine benutzerdefinierte Eigenschaft erstellen, die für einen Container aufgerufen clientUniqueId wird.

PATCH https://graph.microsoft.com/beta/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties
Content-Type: application/json

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort. Standardmäßig kann die Eigenschaft nicht durchsucht werden.

HTTP/1.1 201 Created

Beispiel 2: Erstellen einer benutzerdefinierten durchsuchbaren Eigenschaft

Anforderung

Im folgenden Beispiel wird gezeigt, wie Sie eine durchsuchbare benutzerdefinierte Eigenschaft erstellen, die für einen Container aufgerufen clientUniqueId wird.

PATCH https://graph.microsoft.com/beta/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties
Content-Type: application/json

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b",
    "isSearchable": true
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 201 Created
  • Last updated on