Обновление fileStorageContainerTypeRegistration

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

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

Примечание.

  • Параметры в fileStorageContainerType определяют, какие параметры можно обновить.
  • Обновленные параметры изменяют поведение новых объектов fileStorageContainer , но существующие контейнеры могут потребовать непосредственного обновления их параметров . Некоторые параметры не могут быть обновлены вообще, например при изменении возможности хранилища.
  • Параметры, связанные с агентом, имеют дополнительные ограничения при их переопределении в потребляющем клиенте. Переопределение для agent.chatEmbedAllowedHosts должно быть подмножеством значения, определенного в типе контейнера-владения. Например, если тип контейнера-владельцем задано значение ["https://contoso.com", "https://localhost:5000"]agent.chatEmbedAllowedHosts , переопределение может быть равно ["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. Подмножество, которое можно обновить, зависит от переопределяемых параметров в fileStorageContainerTypeSettings. Необязательный параметр.
applicationPermissionGrants коллекция fileStorageContainerTypeAppPermissionGrant определяют права доступа приложений к контейнерам определенного файлаStorageContainerType. Необязательный параметр.
etag String Используется для управления оптимистическим параллелизмом. Должно соответствовать значению, возвращенное запросом Create или Get . Обязательно.

Отклик

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

Примеры

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

В следующем примере показано, как обновить fileStorageContainerTypeRegistration , где принадлежащий файлStorageContainerType помечает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