Crear fileStorageContainer

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Cree un nuevo objeto fileStorageContainer .

El tipo de contenedor respectivo identificado por containerTypeId debe estar habilitado en el inquilino.

En el caso de las llamadas delegadas, el usuario que realiza la llamada se establece como propietario del fileStorageContainer.

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) FileStorageContainer.Selected No disponible.
Delegado (cuenta personal de Microsoft) FileStorageContainer.Selected No disponible.
Aplicación FileStorageContainer.Selected No disponible.

Nota:

Además de los permisos de Microsoft Graph, la aplicación debe tener los permisos de nivel de contenedor necesarios para llamar a esta API. Para obtener más información, consulte Tipos de contenedor. Para obtener más información sobre los permisos de nivel de tipo de contenedor, consulte Autorización de SharePoint Embedded.

Solicitud HTTP

POST /storage/fileStorage/containers

Parámetros de consulta opcionales

Este método admite los siguientes parámetros de consulta OData para ayudar a personalizar la respuesta. Para obtener información general, vea Parámetros de consulta OData.

Nombre Descripción
dataLocation Especifica la ubicación de datos deseada para la creación de contenedores en inquilinos multigeográficos. Si se omite el dataLocation parámetro en la solicitud, se crea el contenedor en la ubicación predeterminada del inquilino. Para más información, vea Microsoft 365 Multi-Geo.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto fileStorageContainer .

Puede especificar las siguientes propiedades al crear un fileStorageContainer.

Propiedad Tipo Descripción
displayName Cadena El nombre para mostrar del contenedor. Obligatorio.
description String Proporciona una descripción del elemento visible para el usuario. Opcional.
containerTypeId GUID El tipo de contenedor de la instancia del contenedor. Obligatorio.
configuración fileStorageContainerSettings Configuración asociada con el contenedor. Opcional.

Respuesta

Si se realiza correctamente, este método devuelve un 201 Created código de respuesta y un objeto fileStorageContainer en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra cómo crear un fileStorageContainer.

POST https://graph.microsoft.com/beta/storage/fileStorage/containers
Content-Type: application/json

{
  "displayName": "My Application Storage Container",
  "description": "Description of My Application Storage Container",
  "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73",
  "settings": {
    "isOcrEnabled": true,
    "itemMajorVersionLimit": 50,
    "isItemVersioningEnabled": true,
    "itemDefaultSensitivityLabelId": "3d8789ae-7375-4ded-8eeb-d6bc226e42fb"
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "@odata.type": "#microsoft.graph.fileStorageContainer",
  "id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z",
  "displayName": "My Application Storage Container",
  "description": "Description of My Application Storage Container",
  "containerTypeId": "91710488-5756-407f-9046-fbe5f0b4de73",
  "status": "inactive",
  "createdDateTime": "2021-11-24T15:41:52.347Z",
  "settings": {
    "isOcrEnabled": true,
    "itemMajorVersionLimit": 50,
    "isItemVersioningEnabled": true,
    "itemDefaultSensitivityLabelId": "3d8789ae-7375-4ded-8eeb-d6bc226e42fb"
  }
}