fileStorageContainer resource type

Article
2025-03-27

Namespace: microsoft.graph

Represents a location where multiple users or a group of users can store files and access them via an application. All file system objects in a fileStorageContainer are returned as driveItem resources.

Methods

Method	Return type	Description
List	fileStorageContainer	Get a list of the fileStorageContainer objects and their properties.
Create	fileStorageContainer	Create a new fileStorageContainer object.
Get	fileStorageContainer	Read the properties and relationships of a fileStorageContainer object.
Update	fileStorageContainer	Update the properties of a fileStorageContainer object.
Delete	None	Delete a fileStorageContainer object.
Activate	None	Activate a fileStorageContainer object.
Restore deleted container	fileStorageContainer	Restore a deleted fileStorageContainer object.
Remove deleted containers	None	Remove a deleted fileStorageContainer object.
Permanently delete	None	Permanently delete a fileStorageContainer object.
Get drive	drive	Get the drive resource from a fileStorageContainer object.
List permissions	permission	List permissions on a fileStorageContainer.
Add permissions	permission	Add permission to a fileStorageContainer.
Update permissions	permission	Update permission on a fileStorageContainer.
Delete permissions	permission	Delete permission from a fileStorageContainer.
List custom property	filestoragecontainercustompropertyvalue	List custom properties of the fileStorageContainer.
Add custom property	filestoragecontainercustompropertyvalue	Add custom property to the fileStorageContainer.
List columns	columnDefinition collection	List columns in a fileStorageContainer.
Update custom property	filestoragecontainercustompropertyvalue	Update custom property on a fileStorageContainer.
Delete custom property	filestoragecontainercustompropertyvalue	Delete custom property from a fileStorageContainer.
Update recycle bin settings	recyclebinsettings	Update recycleBin settings for a fileStorageContainer.
Restore recycle bin items	recycleBinItem collection	Restore recycle bin items in a fileStorageContainer.
Delete recycle bin items	None	Delete recycle bin items from a fileStorageContainer.
Get recycle bin items	recycleBinItem collection	List recycle bin items in a fileStorageContainer.
Lock	None	Lock a fileStorageContainer.
Unlock	None	Unlock a fileStorageContainer.

Properties

Property	Type	Description
containerTypeId	Guid	Container type ID of the fileStorageContainer. For details about container types, see Container Types. Each container must have only one container type. Read-only.
createdDateTime	DateTimeOffset	Date and time of the fileStorageContainer creation. Read-only.
customProperties	fileStorageContainerCustomPropertyDictionary	Custom property collection for the fileStorageContainer. Read-write.
description	String	Provides a user-visible description of the fileStorageContainer. Read-write.
displayName	String	The display name of the fileStorageContainer. Read-write.
id	String	The unique stable identifier of the filerStorageContainer. Read-only.
lockState	siteLockState	Indicates the lock state of the fileStorageContainer. The possible values are `unlocked` and `lockedReadOnly`. Read-only.
settings	fileStorageContainerSettings	Settings associated with a fileStorageContainer. Read-write.
status	fileStorageContainerStatus	Status of the fileStorageContainer. Containers are created as inactive and require activation. Inactive containers are subjected to automatic deletion in 24 hours. The possible values are: `inactive` , `active` . Read-only.
viewpoint	fileStorageContainerViewpoint	Data specific to the current user. Read-only.

Relationships

Relationship	Type	Description
drive	drive	The drive of the resource fileStorageContainer. Read-only.
permissions	permission collection	The set of permissions for users in the fileStorageContainer. Permission for each user is set by the roles property. The possible values are: `reader`, `writer`, `manager`, and `owner`. Read-write.
recycleBin	recycleBin	Recycle bin of the fileStorageContainer. Read-only.

roles property values

Value	Description
reader	Readers can read fileStorageContainer metadata and the contents inside.
writer	Writers can read and modify fileStorageContainer metadata and contents inside.
manager	Managers can read and modify fileStorageContainer metadata and contents inside and manage the permissions to the container.
owner	Owners can read and modify fileStorageContainer metadata and contents inside, manage container permissions, and delete and restore containers.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.fileStorageContainer",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "containerTypeId": "Guid",
  "customProperties": {
    "@odata.type": "microsoft.graph.fileStorageContainerCustomPropertyDictionary"
  },
  "viewpoint": {
    "@odata.type": "microsoft.graph.fileStorageContainerViewpoint"
  },
  "status": "String",
  "createdDateTime": "String (timestamp)",
  "settings": { "@odata.type": "microsoft.graph.fileStorageContainerSettings" }
}

Share via