Creación de fileStorageContainerType

Espacio de nombres: microsoft.graph

Cree un nuevo archivoStorageContainerType en el inquilino propietario. El número de tipos de contenedor en un inquilino es limitado.

Importante

• El inquilino debe ser el propietario de la aplicación que se asigna como propietario del archivoStorageContainerType (owningAppId).
• El registro de un tipo de contenedor en un inquilino recién creado puede producir un error si el inquilino aún no está totalmente listo. Es posible que tenga que esperar al menos una hora para poder registrar un tipo de contenedor en un nuevo inquilino.

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)	FileStorageContainerType.Manage.All	No disponible.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	No admitida.	No admitida.

Nota: Se requiere el rol de administrador de SharePoint Embedded o el rol de administrador global para llamar a esta API.

Solicitud HTTP

POST /storage/fileStorage/containerTypes

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 fileStorageContainerType .

Puede especificar las siguientes propiedades al crear un archivoStorageContainerType.

Propiedad	Tipo	Description
billingClassification	fileStorageContainerBillingClassification	Tipo de facturación. Los valores posibles son: standard, trial, directToCustomer y unknownFutureValue El valor predeterminado es standard. Opcional.
name	Cadena	Nombre del archivoStorageContainerType. Obligatorio.
owningAppId	Guid	Identificador de la aplicación propietaria del archivoStorageContainerType. Obligatorio.
configuración	fileStorageContainerTypeSettings	La configuración del archivoStorageContainerType. Opcional.

Respuesta

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

Ejemplos

Solicitud

En el ejemplo siguiente se muestra cómo crear un archivo de pruebaStorageContainerType.

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

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.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"]
    }
  }
}