Aktualisieren Sie fileStorageContainerTypeRegistration

Namespace: microsoft.graph

Aktualisieren Sie die Eigenschaften eines fileStorageContainerTypeRegistration-Objekts .

Hinweis

  • Die Einstellungen in fileStorageContainerType steuern, welche Einstellungen aktualisiert werden können.
  • Die aktualisierten Einstellungen ändern das Verhalten neuer fileStorageContainer-Objekte , aber vorhandene Container erfordern möglicherweise, dass ihre Einstellungen direkt aktualisiert werden. Einige Einstellungen können nicht aktualisiert werden, z. B. das Ändern der Speicherfunktion.
  • Für Agent-bezogene Einstellungen gelten zusätzliche Einschränkungen, wenn sie in einem verbrauchenden Mandanten überschrieben werden. Eine Außerkraftsetzung für agent.chatEmbedAllowedHosts muss eine Teilmenge des Werts sein, der im besitzenden Containertyp definiert ist. Wenn beispielsweise der besitzende Containertyp agent.chatEmbedAllowedHosts auf ["https://contoso.com", "https://localhost:5000"]festgelegt ist, kann eine Außerkraftsetzung entweder ["https://contoso.com"], ["https://localhost:5000"]oder sein []. Die Einstellung kann jedoch nicht überschrieben werden.["https://fabrikam.com"] Weitere Informationen zum eingebetteten SharePoint-Agent
  • Es kann bis zu einer Stunde dauern, bis aktualisierte Einstellungen und Berechtigungserteilungen verteilt werden.

ETag wird für die optimistische Parallelitätssteuerung verwendet. Er muss mit dem Wert aus "Erstellen", "Get" oder "Vorheriges Update" übereinstimmen.

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) FileStorageContainerTypeReg.Selected FileStorageContainerTypeReg.Manage.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application FileStorageContainerTypeReg.Selected Nicht verfügbar.

Hinweis

  • Wenn delegierte Token verwendet werden, ist entweder die SharePoint Embedded-Administratorrolle oder die globale Administratorrolle erforderlich.
  • Wenn die FileStorageContainerTypeReg.Selected Berechtigung verwendet wird, sind Änderungen auf Registrierungen beschränkt, die im Besitz der Anwendung sind, die den Aufruf durchführt.

HTTP-Anforderung

PATCH /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeRegistrationId}

Anforderungsheader

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

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die zu aktualisierenden Eigenschaften an. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Eigenschaft Typ Beschreibung
settings fileStorageContainerTypeRegistrationSettings fileStorageContainerTypeRegistration Einstellungen. Die Teilmenge, die aktualisiert werden kann, hängt von den überschreibbaren Einstellungen in den fileStorageContainerTypeSettings ab. Optional.
applicationPermissionGrants fileStorageContainerTypeAppPermissionGrant-Sammlung Definieren Sie die Zugriffsrechte von Anwendungen auf Containern eines bestimmten fileStorageContainerType. Optional.
etag Zeichenfolge Wird für die optimistische Parallelitätssteuerung verwendet. Muss mit dem Wert übereinstimmen, der von einer create - oder get-Anforderung zurückgegeben wird. Erforderlich.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und ein aktualisiertes fileStorageContainerTypeRegistration-Objekt im Antworttext zurück.

Beispiele

Beispiel 1: Aktualisieren einer fileStorageContainerTypeRegistration-Einstellung

Das folgende Beispiel zeigt, wie Sie eine fileStorageContainerTypeRegistration aktualisieren, bei der der besitzende fileStorageContainerTypeisSearchEnabled als überschreibbare Einstellung markiert hat. Die Eigenschaft sharingCapability kann jederzeit überschrieben werden.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00
Content-Type: application/json

{
  "settings": {
    "sharingCapability": "externalUserAndGuestSharing",
    "isSearchEnabled": false
  },
  "applicationPermissionGrants": [
    {
      "appId": "33225700-9a00-4c00-84dd-0c210f203f01",
      "delegatedPermissions": ["full"],
      "applicationPermissions": ["none"]
    }
  ],
  "etag": "RVRhZw=="
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileStorageContainerTypeRegistration",
  "id": "de988700-d700-020e-0a00-0831f3042f00",
  "name": "Container Type Name",
  "owningAppId": "11335700-9a00-4c00-84dd-0c210f203f00",
  "billingClassification": "trial",
  "billingStatus": "valid",
  "registredDateTime": "01/20/2025",
  "expirationDateTime": "02/20/2025",
  "etag": "RVRhZyArIDE=",
  "settings": {
    "sharingCapability": "externalUserAndGuestSharing",
    "urlTemplate": "https://app.contoso.com/redirect?tenant={tenant-id}&drive={drive-id}&folder={folder-id}&item={item-id}",
    "isDiscoverabilityEnabled": true,
    "isSearchEnabled": false,
    "isItemVersioningEnabled": true,
    "itemMajorVersionLimit": 50,
    "maxStoragePerContainerInBytes": 104857600,
    "isSharingRestricted": false
  },
  "applicationPermissionGrants": [
    {
      "appId": "33225700-9a00-4c00-84dd-0c210f203f01",
      "delegatedPermissions": ["full"],
      "applicationPermissions": ["none"]
    }
  ]
}

Beispiel 2: Aktualisieren einer fileStorageContainerTypeRegistration ohne ETag

Das folgende Beispiel zeigt, wie Sie eine fileStorageContainerTypeRegistration ohne ein Etag aktualisieren, das zu einer .400 Bad Request

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00
Content-Type: application/json

{
  "settings": {
    "sharingCapability": "externalUserAndGuestSharing"
  },
  "applicationPermissionGrants": [
    {
      "appId": "33225700-9a00-4c00-84dd-0c210f203f01",
      "delegatedPermissions": ["full"],
      "applicationPermissions": ["none"]
    }
  ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 400 Bad Request

Beispiel 3: Aktualisieren einer nicht überschreibbaren fileStorageContainerTypeRegistration-Einstellung

Im folgenden Beispiel wird gezeigt, wie Sie eine fileStorageContainerTypeRegistration-Einstellung aktualisieren, die im fileStorageContainerType nicht überschrieben werden kann. In diesem Beispiel kann die urlTemplate-Eigenschaft nicht überschrieben werden.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00
Content-Type: application/json

{
  "settings": {
    "urlTemplate": "https://fabrikam.example.com/{0}"
  },
  "applicationPermissionGrants": [
    {
      "appId": "33225700-9a00-4c00-84dd-0c210f203f01",
      "delegatedPermissions": ["full"],
      "applicationPermissions": ["none"]
    }
  ]
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 400 Bad Request