Поделиться через

Создание fileStorageContainerTypeRegistration

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

Создайте или замените объект fileStorageContainerTypeRegistration . Этот метод регистрирует fileStorageContainerType в клиенте.

Для стандартных контейнеров выставление счетов должно быть допустимым для успешного завершения регистрации.

Важно!

  • Приложение может зарегистрировать только принадлежащий ему файлStorageContainerType , используя только маркеры приложения или делегированные маркеры.
  • Регистрация типа контейнера в только что созданном клиенте может завершиться ошибкой, если клиент еще не полностью готов. Возможно, потребуется подождать не менее часа, прежде чем можно будет зарегистрировать тип контейнера в новом клиенте.

Параметры не могут быть изменены во время регистрации.

Разрешения

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

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

Примечание.

  • При использовании делегированных маркеров требуется роль администратора SharePoint Embedded или роль глобального администратора.
  • Регистрация должна выполняться в контексте приложения, которому принадлежит fileStorageContainerType.

HTTP-запрос

Регистрация fileStorageContainerType в текущем клиенте.

PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}

Примечание: Используйте метод PUT. Этот запрос создает объект fileStorageContainertypeRegistration с указанным идентификатором (fileStorageContainerTypeId).

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

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

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

В тексте запроса укажите представление объекта fileStorageContainerTypeRegistration в формате JSON.

При создании fileStorageContainerTypeRegistration можно указать следующее свойство.

Свойство Тип Описание
applicationPermissionGrants коллекция fileStorageContainerTypeAppPermissionGrant Права доступа приложений к контейнерам определенного файлаStorageContainerType. Необязательный параметр.

Отклик

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

Примеры

Пример 1. Создание файлаStorageContainerTypeRegistration для пробного файлаStorageContainerType

В следующем примере показано, как создать fileStorageContainerTypeRegistration для пробного файлаStorageContainerType с помощью некоторых applicationPermissionGrants.

Запрос

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

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

{
  "applicationPermissionGrants": [
    {
      "appId": "11335700-9a00-4c00-84dd-0c210f203f00",
      "delegatedPermissions": ["readContent", "writeContent"],
      "applicationPermissions": ["full"]
    },
    {
      "appId": "d893fd02-3578-4c7f-bd85-12fc3358af48",
      "delegatedPermissions": ["readContent"],
      "applicationPermissions": ["read"]
    }
  ]
}

Отклик

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

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

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

{
  "@odata.type": "#microsoft.graph.fileStorageContainerTypeRegistration",
  "id": "de988700-d700-020e-0a00-0831f3042f00",
  "name": "Test Trial Container",
  "owningAppId": "11335700-9a00-4c00-84dd-0c210f203f00",
  "billingClassification": "trial",
  "billingStatus": "valid",
  "registeredDateTime": "01/20/2025",
  "expirationDateTime": "02/20/2025",
  "etag": "RVRhZw==",
  "settings": {
    "@odata.type": "microsoft.graph.fileStorageContainerTypeRegistrationSettings",
    "sharingCapability": "disabled",
    "urlTemplate": "https://app.contoso.com/redirect?tenant={tenant-id}&drive={drive-id}&folder={folder-id}&item={item-id}",
    "isDiscoverabilityEnabled": true,
    "isSearchEnabled": true,
    "isItemVersioningEnabled": true,
    "itemMajorVersionLimit": 50,
    "maxStoragePerContainerInBytes": 104857600,
    "isSharingRestricted": false
  },
  "applicationPermissionGrants": [
    {
      "appId": "11335700-9a00-4c00-84dd-0c210f203f00",
      "delegatedPermissions": ["readContent", "writeContent"],
      "applicationPermissions": ["full"]
    },
    {
      "appId": "d893fd02-3578-4c7f-bd85-12fc3358af48",
      "delegatedPermissions": ["readContent"],
      "applicationPermissions": ["read"]
    }
  ]
}

Пример 2. Создание fileStorageContainerTypeRegistration для стандартного fileStorageContainerType, где настройка выставления счетов не завершена

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

Запрос

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

PUT https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypeRegistrations/52a2630c-5e6a-41ff-8645-15406bafe66a
Content-Type: application/json

{
  "applicationPermissionGrants": [
    {
      "appId": "11335700-9a00-4c00-84dd-0c210f203f00",
      "delegatedPermissions": ["readContent", "writeContent"],
      "applicationPermissions": ["full"]
    }
  ]
}

Отклик

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

HTTP/1.1 405 Method Not Allowed
  • Last updated on