Создание fileStorageContainerType

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

Создайте файлStorageContainerType в арендаторе-владельце. Количество типов контейнеров в клиенте ограничено.

Важно!

• Клиенту должно принадлежать приложение, назначенное в качестве владельца fileStorageContainerType (owningAppId).
• Регистрация типа контейнера в только что созданном клиенте может завершиться ошибкой, если клиент еще не полностью готов. Возможно, потребуется подождать не менее часа, прежде чем можно будет зарегистрировать тип контейнера в новом клиенте.

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

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

Разрешения

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

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

Примечание: Для вызова этого API требуется роль администратора SharePoint Embedded или глобальный администратор.

HTTP-запрос

POST /storage/fileStorage/containerTypes

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

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

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

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

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

Свойство	Тип	Описание
billingClassification	fileStorageContainerBillingClassification	Тип выставления счетов. Допустимые значения: standard, trial, directToCustomer, unknownFutureValue. Значение по умолчанию — standard. Необязательный параметр.
name	String	Имя fileStorageContainerType. Обязательно.
owningAppId	GUID	Идентификатор приложения, которому принадлежит fileStorageContainerType. Обязательно.
settings	fileStorageContainerTypeSettings	Параметры fileStorageContainerType. Необязательный параметр.

Отклик

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

Примеры

Запрос

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

POST https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypes
Content-Type: application/json

{
  "name": "Test Trial Container",
  "owningAppId": "11335700-9a00-4c00-84dd-0c210f203f00",
  "billingClassification": "trial",
  "settings": {
    "isItemVersioningEnabled": true,
    "isSharingRestricted": false,
    "consumingTenantOverridables": "isSearchEnabled,itemMajorVersionLimit",
    "agent": {
      "chatEmbedAllowedHosts": ["https://localhost:3000"]
    }
  }
}

Отклик

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

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

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

{
  "@odata.type": "#microsoft.graph.fileStorageContainerType",
  "id": "de988700-d700-020e-0a00-0831f3042f00",
  "name": "Test Trial Container",
  "owningAppId": "11335700-9a00-4c00-84dd-0c210f203f00",
  "billingClassification": "trial",
  "billingStatus": "valid",
  "createdDateTime": "01/20/2025",
  "expirationDateTime": "02/20/2025",
  "etag": "RVRhZw==",
  "settings": {
    "urlTemplate": "",
    "isDiscoverabilityEnabled": true,
    "isSearchEnabled": true,
    "isItemVersioningEnabled": true,
    "itemMajorVersionLimit": 50,
    "maxStoragePerContainerInBytes": 104857600,
    "isSharingRestricted": false,
    "consumingTenantOverridables": "isSearchEnabled,itemMajorVersionLimit",
    "agent": {
      "chatEmbedAllowedHosts": ["https://localhost:3000"]
    }
  }
}