Update fileStorageContainerTypeRegistration

Пространство имен: microsoft.graph

Обновление свойств объекта fileStorageContainerTypeRegistration .

Примечание.

  • Параметры в fileStorageContainerType определяют, какие параметры можно обновлять.
  • Обновленные параметры изменяют поведение новых объектов fileStorageContainer , но для существующих контейнеров может потребоваться непосредственное обновление их параметров . Некоторые параметры вообще нельзя обновить, например, при изменении возможностей хранилища.
  • Параметры, связанные с агентом, имеют дополнительные ограничения при их переопределении в клиенте-потребителе. Переопределение agent.chatEmbedAllowedHosts должно быть подмножеством значения, определенного в типе контейнера-владельца. Например, если тип контейнера-владельца имеет agent.chatEmbedAllowedHosts значение ["https://contoso.com", "https://localhost:5000"], переопределением может быть либо ["https://contoso.com"], ["https://localhost:5000"], либо даже []. Однако этот параметр нельзя переопределить в ["https://fabrikam.com"]. Подробнее об агенте SharePoint Embedded
  • Распространение обновленных параметров и предоставленных разрешений может занять до одного часа.

ETag используется для управления оптимистичным параллелизмом. Оно должно совпадать со значением из команды "Создать", "Получить " или предыдущего обновления.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальное обслуживание Правительство США L4 Правительство США L5 (DOD) Китай, обслуживаемый 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшим объемом привилегий Разрешения с более высоким уровнем привилегий
Делегированные (рабочая или учебная учетная запись) FileStorageContainerTypeReg.Selected FileStorageContainerTypeReg.Manage.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Приложение FileStorageContainerTypeReg.Selected Недоступно.

Примечание.

  • При использовании делегированных маркеров требуется роль администратора SharePoint Embedded или глобального администратора.
  • Если FileStorageContainerTypeReg.Selected разрешение используется, изменения ограничиваются регистрациями , принадлежащими приложению, которое выполняет вызов.

HTTP-запрос

PATCH /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeRegistrationId}

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

В тексте запроса укажите только значения обновляемых свойств. Существующие свойства, не включенные в текст запроса, сохраняют свои прежние значения или пересчитываются на основе изменений других значений свойств.

В следующей таблице указаны свойства, которые можно обновить.

Свойство Тип Описание
settings fileStorageContainerTypeRegistrationSettings fileStorageContainerTypeRegistration settings. Подмножество, которое можно обновить, зависит от переопределяемых параметров в fileStorageContainerTypeSettings. Необязательный параметр.
applicationPermissionGrants Коллекция fileStorageContainerTypeAppPermissionGrant определить права доступа приложений в контейнерах определенного fileStorageContainerType. Необязательный параметр.
etag String Используется для управления оптимистичным параллелизмом. Должно совпадать со значением, возвращаемым из запроса Create или Get . Обязательно.

Отклик

В случае успеха этот метод возвращает код ответа 200 OK и обновленный объект fileStorageContainerTypeRegistration в тексте ответа.

Примеры

Пример 1. Обновление параметра fileStorageContainerTypeRegistration

В следующем примере показано, как обновить fileStorageContainerTypeRegistration , где свойственный fileStorageContainerType помечен как isSearchEnabled в качестве переопределяемого параметра. Свойство sharingCapability всегда можно переопределить.

Запрос

Ниже показан пример запроса.

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=="
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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"]
    }
  ]
}

Пример 2. Обновление fileStorageContainerTypeRegistration без ETag

В следующем примере показано, как обновить fileStorageContainerTypeRegistration без etag , который приводит к ошибке 400 Bad Request.

Запрос

Ниже показан пример запроса.

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"]
    }
  ]
}

Отклик

Ниже показан пример отклика.

HTTP/1.1 400 Bad Request

Пример 3. Обновление непереопределяемого параметра fileStorageContainerTypeRegistration

В следующем примере показано, как обновить параметр fileStorageContainerTypeRegistration , который не переопределяется в fileStorageContainerType. В этом примере свойство urlTemplate невозможно переопределить.

Запрос

Ниже показан пример запроса.

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"]
    }
  ]
}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 400 Bad Request