Compartir a través de


Creación de fileStorageContainer

Espacio de nombres: microsoft.graph

Cree un nuevo objeto fileStorageContainer .

El tipo de contenedor identificado por containerTypeId debe registrarse en el inquilino.

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

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores 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) No admitida. No admitida.
Aplicación FileStorageContainer.Selected No disponible.

Además de los permisos de Microsoft Graph, la aplicación también debe tener los permisos o permisos de nivel de tipo de contenedor necesarios para llamar a esta API. Para obtener más información sobre los tipos de contenedor, consulte Tipos de contenedor. Para obtener más información sobre los permisos de nivel de tipo contenedor, vea 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 de 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 obtener más información, consulte regiones multigeográficas disponibles y sus códigos de ubicación.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la 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 archivoStorageContainer.

Propiedad Tipo Descripción
displayName Cadena Nombre para mostrar del contenedor. Obligatorio.
description Cadena Descripción visible del usuario del contenedor. Opcional.
containerTypeId GUID Tipo de contenedor de la instancia de contenedor. Obligatorio.
configuración fileStorageContainerSettings Configuración asociada al contenedor. Opcional.

Respuesta

Si se ejecuta 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 archivoStorageContainer.

POST https://graph.microsoft.com/v1.0/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
  }
}

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