Update fileStorageContainerTypeRegistration

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Update the properties of a fileStorageContainerTypeRegistration object.

Note

• The settings in the fileStorageContainerType control which settings can be updated.
• The updated settings change the behavior of new fileStorageContainer objects, but existing containers might require their settings to be updated directly. Some settings can't be updated at all, for example, changing the storage capability.
• Agent-related settings have additional restrictions when overriding them in a consuming tenant. An override for agent.chatEmbedAllowedHosts must be a subset of the value defined in the owning container type. For example, if the owning container type sets agent.chatEmbedAllowedHosts to ["https://contoso.com", "https://localhost:5000"], an override can be either ["https://contoso.com"], ["https://localhost:5000"], or even []. However, the setting cannot be overridden to ["https://fabrikam.com"]. Learn more about SharePoint Embedded agent

ETag is used for optimistic concurrency control. It must match the value from Create, Get or the previous Update.

This API is available in the following national cloud deployments.

Global service	US Government L4	US Government L5 (DOD)	China operated by 21Vianet
✅	✅	✅	✅

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

Permission type	Least privileged permissions	Higher privileged permissions
Delegated (work or school account)	FileStorageContainerTypeReg.Selected	FileStorageContainerTypeReg.Manage.All
Delegated (personal Microsoft account)	Not supported.	Not supported.
Application	FileStorageContainerTypeReg.Selected	Not available.

Note:

• When delegated tokens are used, either the SharePoint Embedded admin role or the Global admin role is required.
• If the FileStorageContainerTypeReg.Selected permission is used, changes are limited to registrations owned by the application that makes the call.

HTTP request

PATCH /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeRegistrationId}

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type	application/json. Required.

Request body

In the request body, supply only the values for properties to update. Existing properties that aren't included in the request body maintain their previous values or are recalculated based on changes to other property values.

The following table specifies the properties that can be updated.

Property	Type	Description
settings	fileStorageContainerTypeRegistrationSettings	fileStorageContainerTypeRegistration settings. The subset that can be updated depends on the overridable settings in the fileStorageContainerTypeSettings. Optional.
applicationPermissionGrants	fileStorageContainerTypeAppPermissionGrant collection	define the access privileges of applications on containers of a specific fileStorageContainerType. Optional.
etag	String	Used for optimistic concurrency control. Must match the value returned from a Create or Get request. Required.

Response

If successful, this method returns a 200 OK response code and an updated fileStorageContainerTypeRegistration object in the response body.

Examples

Example 1: Update a fileStorageContainerTypeRegistration setting

The following example shows how to update a fileStorageContainerTypeRegistration where the owning fileStorageContainerType marked isSearchEnabled as an overridable setting. The sharingCapability property can always be overridden.

Request

The following example shows a request.

HTTP

PATCH https://graph.microsoft.com/beta/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00
Content-Type: application/json

{
  "settings": {
    "sharingCapability": "externalUserAndGuestSharing",
    "isSearchEnabled": false
  },
  "applicationPermissionGrants": [
    {
      "appId": "33225700-9a00-4c00-84dd-0c210f203f01",
      "delegatedPermissions": ["full"],
      "applicationPermissions": ["none"]
    }
  ],
  "etag": "RVRhZw=="
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new FileStorageContainerTypeRegistration
{
	Settings = new FileStorageContainerTypeRegistrationSettings
	{
		SharingCapability = SharingCapabilities.ExternalUserAndGuestSharing,
		IsSearchEnabled = false,
	},
	ApplicationPermissionGrants = new List<FileStorageContainerTypeAppPermissionGrant>
	{
		new FileStorageContainerTypeAppPermissionGrant
		{
			AppId = "33225700-9a00-4c00-84dd-0c210f203f01",
			DelegatedPermissions = new List<FileStorageContainerTypeAppPermission?>
			{
				FileStorageContainerTypeAppPermission.Full,
			},
			ApplicationPermissions = new List<FileStorageContainerTypeAppPermission?>
			{
				FileStorageContainerTypeAppPermission.None,
			},
		},
	},
	Etag = "RVRhZw==",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Storage.FileStorage.ContainerTypeRegistrations["{fileStorageContainerTypeRegistration-id}"].PatchAsync(requestBody);

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Go

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewFileStorageContainerTypeRegistration()
settings := graphmodels.NewFileStorageContainerTypeRegistrationSettings()
sharingCapability := graphmodels.EXTERNALUSERANDGUESTSHARING_SHARINGCAPABILITIES 
settings.SetSharingCapability(&sharingCapability) 
isSearchEnabled := false
settings.SetIsSearchEnabled(&isSearchEnabled) 
requestBody.SetSettings(settings)


fileStorageContainerTypeAppPermissionGrant := graphmodels.NewFileStorageContainerTypeAppPermissionGrant()
appId := "33225700-9a00-4c00-84dd-0c210f203f01"
fileStorageContainerTypeAppPermissionGrant.SetAppId(&appId) 
delegatedPermissions := []graphmodels.FileStorageContainerTypeAppPermissionable {
	fileStorageContainerTypeAppPermission := graphmodels.FULL_FILESTORAGECONTAINERTYPEAPPPERMISSION 
	fileStorageContainerTypeAppPermissionGrant.SetFileStorageContainerTypeAppPermission(&fileStorageContainerTypeAppPermission)
}
fileStorageContainerTypeAppPermissionGrant.SetDelegatedPermissions(delegatedPermissions)
applicationPermissions := []graphmodels.FileStorageContainerTypeAppPermissionable {
	fileStorageContainerTypeAppPermission := graphmodels.NONE_FILESTORAGECONTAINERTYPEAPPPERMISSION 
	fileStorageContainerTypeAppPermissionGrant.SetFileStorageContainerTypeAppPermission(&fileStorageContainerTypeAppPermission)
}
fileStorageContainerTypeAppPermissionGrant.SetApplicationPermissions(applicationPermissions)

applicationPermissionGrants := []graphmodels.FileStorageContainerTypeAppPermissionGrantable {
	fileStorageContainerTypeAppPermissionGrant,
}
requestBody.SetApplicationPermissionGrants(applicationPermissionGrants)
etag := "RVRhZw=="
requestBody.SetEtag(&etag) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
containerTypeRegistrations, err := graphClient.Storage().FileStorage().ContainerTypeRegistrations().ByFileStorageContainerTypeRegistrationId("fileStorageContainerTypeRegistration-id").Patch(context.Background(), requestBody, nil)

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

FileStorageContainerTypeRegistration fileStorageContainerTypeRegistration = new FileStorageContainerTypeRegistration();
FileStorageContainerTypeRegistrationSettings settings = new FileStorageContainerTypeRegistrationSettings();
settings.setSharingCapability(SharingCapabilities.ExternalUserAndGuestSharing);
settings.setIsSearchEnabled(false);
fileStorageContainerTypeRegistration.setSettings(settings);
LinkedList<FileStorageContainerTypeAppPermissionGrant> applicationPermissionGrants = new LinkedList<FileStorageContainerTypeAppPermissionGrant>();
FileStorageContainerTypeAppPermissionGrant fileStorageContainerTypeAppPermissionGrant = new FileStorageContainerTypeAppPermissionGrant();
fileStorageContainerTypeAppPermissionGrant.setAppId("33225700-9a00-4c00-84dd-0c210f203f01");
LinkedList<FileStorageContainerTypeAppPermission> delegatedPermissions = new LinkedList<FileStorageContainerTypeAppPermission>();
delegatedPermissions.add(FileStorageContainerTypeAppPermission.Full);
fileStorageContainerTypeAppPermissionGrant.setDelegatedPermissions(delegatedPermissions);
LinkedList<FileStorageContainerTypeAppPermission> applicationPermissions = new LinkedList<FileStorageContainerTypeAppPermission>();
applicationPermissions.add(FileStorageContainerTypeAppPermission.None);
fileStorageContainerTypeAppPermissionGrant.setApplicationPermissions(applicationPermissions);
applicationPermissionGrants.add(fileStorageContainerTypeAppPermissionGrant);
fileStorageContainerTypeRegistration.setApplicationPermissionGrants(applicationPermissionGrants);
fileStorageContainerTypeRegistration.setEtag("RVRhZw==");
FileStorageContainerTypeRegistration result = graphClient.storage().fileStorage().containerTypeRegistrations().byFileStorageContainerTypeRegistrationId("{fileStorageContainerTypeRegistration-id}").patch(fileStorageContainerTypeRegistration);

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const fileStorageContainerTypeRegistration = {
  settings: {
    sharingCapability: 'externalUserAndGuestSharing',
    isSearchEnabled: false
  },
  applicationPermissionGrants: [
    {
      appId: '33225700-9a00-4c00-84dd-0c210f203f01',
      delegatedPermissions: ['full'],
      applicationPermissions: ['none']
    }
  ],
  etag: 'RVRhZw=='
};

await client.api('/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00')
	.version('beta')
	.update(fileStorageContainerTypeRegistration);

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeRegistration;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeRegistrationSettings;
use Microsoft\Graph\Beta\Generated\Models\SharingCapabilities;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeAppPermissionGrant;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeAppPermission;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new FileStorageContainerTypeRegistration();
$settings = new FileStorageContainerTypeRegistrationSettings();
$settings->setSharingCapability(new SharingCapabilities('externalUserAndGuestSharing'));
$settings->setIsSearchEnabled(false);
$requestBody->setSettings($settings);
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1 = new FileStorageContainerTypeAppPermissionGrant();
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1->setAppId('33225700-9a00-4c00-84dd-0c210f203f01');
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1->setDelegatedPermissions([new FileStorageContainerTypeAppPermission('full'),	]);
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1->setApplicationPermissions([new FileStorageContainerTypeAppPermission('none'),	]);
$applicationPermissionGrantsArray []= $applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1;
$requestBody->setApplicationPermissionGrants($applicationPermissionGrantsArray);

$requestBody->setEtag('RVRhZw==');

$result = $graphServiceClient->storage()->fileStorage()->containerTypeRegistrations()->byFileStorageContainerTypeRegistrationId('fileStorageContainerTypeRegistration-id')->patch($requestBody)->wait();

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.file_storage_container_type_registration import FileStorageContainerTypeRegistration
from msgraph_beta.generated.models.file_storage_container_type_registration_settings import FileStorageContainerTypeRegistrationSettings
from msgraph_beta.generated.models.sharing_capabilities import SharingCapabilities
from msgraph_beta.generated.models.file_storage_container_type_app_permission_grant import FileStorageContainerTypeAppPermissionGrant
from msgraph_beta.generated.models.file_storage_container_type_app_permission import FileStorageContainerTypeAppPermission
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = FileStorageContainerTypeRegistration(
	settings = FileStorageContainerTypeRegistrationSettings(
		sharing_capability = SharingCapabilities.ExternalUserAndGuestSharing,
		is_search_enabled = False,
	),
	application_permission_grants = [
		FileStorageContainerTypeAppPermissionGrant(
			app_id = "33225700-9a00-4c00-84dd-0c210f203f01",
			delegated_permissions = [
				FileStorageContainerTypeAppPermission.Full,
			],
			application_permissions = [
				FileStorageContainerTypeAppPermission.None,
			],
		),
	],
	etag = "RVRhZw==",
)

result = await graph_client.storage.file_storage.container_type_registrations.by_file_storage_container_type_registration_id('fileStorageContainerTypeRegistration-id').patch(request_body)

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileStorageContainerTypeRegistration",
  "id": "de988700-d700-020e-0a00-0831f3042f00",
  "name": "Container Type Name",
  "owningAppId": "11335700-9a00-4c00-84dd-0c210f203f00",
  "billingClassification": "trial",
  "billingStatus": "valid",
  "registredDateTime": "01/20/2025",
  "expirationDateTime": "02/20/2025",
  "etag": "RVRhZyArIDE=",
  "settings": {
    "sharingCapability": "externalUserAndGuestSharing",
    "urlTemplate": "https://app.contoso.com/redirect?tenant={tenant-id}&drive={drive-id}&folder={folder-id}&item={item-id}",
    "isDiscoverabilityEnabled": true,
    "isSearchEnabled": false,
    "isItemVersioningEnabled": true,
    "itemMajorVersionLimit": 50,
    "maxStoragePerContainerInBytes": 104857600,
    "isSharingRestricted": false
  },
  "applicationPermissionGrants": [
    {
      "appId": "33225700-9a00-4c00-84dd-0c210f203f01",
      "delegatedPermissions": ["full"],
      "applicationPermissions": ["none"]
    }
  ]
}

Example 2: Update a fileStorageContainerTypeRegistration without ETag

The following example shows how to update a fileStorageContainerTypeRegistration without an etag that results in a 400 Bad Request.

Request

The following example shows a request.

HTTP

PATCH https://graph.microsoft.com/beta/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00
Content-Type: application/json

{
  "settings": {
    "sharingCapability": "externalUserAndGuestSharing"
  },
  "applicationPermissionGrants": [
    {
      "appId": "33225700-9a00-4c00-84dd-0c210f203f01",
      "delegatedPermissions": ["full"],
      "applicationPermissions": ["none"]
    }
  ]
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new FileStorageContainerTypeRegistration
{
	Settings = new FileStorageContainerTypeRegistrationSettings
	{
		SharingCapability = SharingCapabilities.ExternalUserAndGuestSharing,
	},
	ApplicationPermissionGrants = new List<FileStorageContainerTypeAppPermissionGrant>
	{
		new FileStorageContainerTypeAppPermissionGrant
		{
			AppId = "33225700-9a00-4c00-84dd-0c210f203f01",
			DelegatedPermissions = new List<FileStorageContainerTypeAppPermission?>
			{
				FileStorageContainerTypeAppPermission.Full,
			},
			ApplicationPermissions = new List<FileStorageContainerTypeAppPermission?>
			{
				FileStorageContainerTypeAppPermission.None,
			},
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Storage.FileStorage.ContainerTypeRegistrations["{fileStorageContainerTypeRegistration-id}"].PatchAsync(requestBody);

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Go

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewFileStorageContainerTypeRegistration()
settings := graphmodels.NewFileStorageContainerTypeRegistrationSettings()
sharingCapability := graphmodels.EXTERNALUSERANDGUESTSHARING_SHARINGCAPABILITIES 
settings.SetSharingCapability(&sharingCapability) 
requestBody.SetSettings(settings)


fileStorageContainerTypeAppPermissionGrant := graphmodels.NewFileStorageContainerTypeAppPermissionGrant()
appId := "33225700-9a00-4c00-84dd-0c210f203f01"
fileStorageContainerTypeAppPermissionGrant.SetAppId(&appId) 
delegatedPermissions := []graphmodels.FileStorageContainerTypeAppPermissionable {
	fileStorageContainerTypeAppPermission := graphmodels.FULL_FILESTORAGECONTAINERTYPEAPPPERMISSION 
	fileStorageContainerTypeAppPermissionGrant.SetFileStorageContainerTypeAppPermission(&fileStorageContainerTypeAppPermission)
}
fileStorageContainerTypeAppPermissionGrant.SetDelegatedPermissions(delegatedPermissions)
applicationPermissions := []graphmodels.FileStorageContainerTypeAppPermissionable {
	fileStorageContainerTypeAppPermission := graphmodels.NONE_FILESTORAGECONTAINERTYPEAPPPERMISSION 
	fileStorageContainerTypeAppPermissionGrant.SetFileStorageContainerTypeAppPermission(&fileStorageContainerTypeAppPermission)
}
fileStorageContainerTypeAppPermissionGrant.SetApplicationPermissions(applicationPermissions)

applicationPermissionGrants := []graphmodels.FileStorageContainerTypeAppPermissionGrantable {
	fileStorageContainerTypeAppPermissionGrant,
}
requestBody.SetApplicationPermissionGrants(applicationPermissionGrants)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
containerTypeRegistrations, err := graphClient.Storage().FileStorage().ContainerTypeRegistrations().ByFileStorageContainerTypeRegistrationId("fileStorageContainerTypeRegistration-id").Patch(context.Background(), requestBody, nil)

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

FileStorageContainerTypeRegistration fileStorageContainerTypeRegistration = new FileStorageContainerTypeRegistration();
FileStorageContainerTypeRegistrationSettings settings = new FileStorageContainerTypeRegistrationSettings();
settings.setSharingCapability(SharingCapabilities.ExternalUserAndGuestSharing);
fileStorageContainerTypeRegistration.setSettings(settings);
LinkedList<FileStorageContainerTypeAppPermissionGrant> applicationPermissionGrants = new LinkedList<FileStorageContainerTypeAppPermissionGrant>();
FileStorageContainerTypeAppPermissionGrant fileStorageContainerTypeAppPermissionGrant = new FileStorageContainerTypeAppPermissionGrant();
fileStorageContainerTypeAppPermissionGrant.setAppId("33225700-9a00-4c00-84dd-0c210f203f01");
LinkedList<FileStorageContainerTypeAppPermission> delegatedPermissions = new LinkedList<FileStorageContainerTypeAppPermission>();
delegatedPermissions.add(FileStorageContainerTypeAppPermission.Full);
fileStorageContainerTypeAppPermissionGrant.setDelegatedPermissions(delegatedPermissions);
LinkedList<FileStorageContainerTypeAppPermission> applicationPermissions = new LinkedList<FileStorageContainerTypeAppPermission>();
applicationPermissions.add(FileStorageContainerTypeAppPermission.None);
fileStorageContainerTypeAppPermissionGrant.setApplicationPermissions(applicationPermissions);
applicationPermissionGrants.add(fileStorageContainerTypeAppPermissionGrant);
fileStorageContainerTypeRegistration.setApplicationPermissionGrants(applicationPermissionGrants);
FileStorageContainerTypeRegistration result = graphClient.storage().fileStorage().containerTypeRegistrations().byFileStorageContainerTypeRegistrationId("{fileStorageContainerTypeRegistration-id}").patch(fileStorageContainerTypeRegistration);

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const fileStorageContainerTypeRegistration = {
  settings: {
    sharingCapability: 'externalUserAndGuestSharing'
  },
  applicationPermissionGrants: [
    {
      appId: '33225700-9a00-4c00-84dd-0c210f203f01',
      delegatedPermissions: ['full'],
      applicationPermissions: ['none']
    }
  ]
};

await client.api('/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00')
	.version('beta')
	.update(fileStorageContainerTypeRegistration);

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeRegistration;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeRegistrationSettings;
use Microsoft\Graph\Beta\Generated\Models\SharingCapabilities;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeAppPermissionGrant;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeAppPermission;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new FileStorageContainerTypeRegistration();
$settings = new FileStorageContainerTypeRegistrationSettings();
$settings->setSharingCapability(new SharingCapabilities('externalUserAndGuestSharing'));
$requestBody->setSettings($settings);
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1 = new FileStorageContainerTypeAppPermissionGrant();
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1->setAppId('33225700-9a00-4c00-84dd-0c210f203f01');
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1->setDelegatedPermissions([new FileStorageContainerTypeAppPermission('full'),	]);
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1->setApplicationPermissions([new FileStorageContainerTypeAppPermission('none'),	]);
$applicationPermissionGrantsArray []= $applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1;
$requestBody->setApplicationPermissionGrants($applicationPermissionGrantsArray);


$result = $graphServiceClient->storage()->fileStorage()->containerTypeRegistrations()->byFileStorageContainerTypeRegistrationId('fileStorageContainerTypeRegistration-id')->patch($requestBody)->wait();

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.file_storage_container_type_registration import FileStorageContainerTypeRegistration
from msgraph_beta.generated.models.file_storage_container_type_registration_settings import FileStorageContainerTypeRegistrationSettings
from msgraph_beta.generated.models.sharing_capabilities import SharingCapabilities
from msgraph_beta.generated.models.file_storage_container_type_app_permission_grant import FileStorageContainerTypeAppPermissionGrant
from msgraph_beta.generated.models.file_storage_container_type_app_permission import FileStorageContainerTypeAppPermission
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = FileStorageContainerTypeRegistration(
	settings = FileStorageContainerTypeRegistrationSettings(
		sharing_capability = SharingCapabilities.ExternalUserAndGuestSharing,
	),
	application_permission_grants = [
		FileStorageContainerTypeAppPermissionGrant(
			app_id = "33225700-9a00-4c00-84dd-0c210f203f01",
			delegated_permissions = [
				FileStorageContainerTypeAppPermission.Full,
			],
			application_permissions = [
				FileStorageContainerTypeAppPermission.None,
			],
		),
	],
)

result = await graph_client.storage.file_storage.container_type_registrations.by_file_storage_container_type_registration_id('fileStorageContainerTypeRegistration-id').patch(request_body)

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Response

The following example shows the response.

HTTP/1.1 400 Bad Request

Example 3: Update a non-overridable fileStorageContainerTypeRegistration setting

The following example shows how to update a fileStorageContainerTypeRegistration setting that isn't overridable in the fileStorageContainerType. In this example, the urlTemplate property isn't overridable.

Request

The following example shows a request.

HTTP

PATCH https://graph.microsoft.com/beta/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00
Content-Type: application/json

{
  "settings": {
    "urlTemplate": "https://fabrikam.example.com/{0}"
  },
  "applicationPermissionGrants": [
    {
      "appId": "33225700-9a00-4c00-84dd-0c210f203f01",
      "delegatedPermissions": ["full"],
      "applicationPermissions": ["none"]
    }
  ]
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new FileStorageContainerTypeRegistration
{
	Settings = new FileStorageContainerTypeRegistrationSettings
	{
		UrlTemplate = "https://fabrikam.example.com/{0}",
	},
	ApplicationPermissionGrants = new List<FileStorageContainerTypeAppPermissionGrant>
	{
		new FileStorageContainerTypeAppPermissionGrant
		{
			AppId = "33225700-9a00-4c00-84dd-0c210f203f01",
			DelegatedPermissions = new List<FileStorageContainerTypeAppPermission?>
			{
				FileStorageContainerTypeAppPermission.Full,
			},
			ApplicationPermissions = new List<FileStorageContainerTypeAppPermission?>
			{
				FileStorageContainerTypeAppPermission.None,
			},
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Storage.FileStorage.ContainerTypeRegistrations["{fileStorageContainerTypeRegistration-id}"].PatchAsync(requestBody);

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Go

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewFileStorageContainerTypeRegistration()
settings := graphmodels.NewFileStorageContainerTypeRegistrationSettings()
urlTemplate := "https://fabrikam.example.com/{0}"
settings.SetUrlTemplate(&urlTemplate) 
requestBody.SetSettings(settings)


fileStorageContainerTypeAppPermissionGrant := graphmodels.NewFileStorageContainerTypeAppPermissionGrant()
appId := "33225700-9a00-4c00-84dd-0c210f203f01"
fileStorageContainerTypeAppPermissionGrant.SetAppId(&appId) 
delegatedPermissions := []graphmodels.FileStorageContainerTypeAppPermissionable {
	fileStorageContainerTypeAppPermission := graphmodels.FULL_FILESTORAGECONTAINERTYPEAPPPERMISSION 
	fileStorageContainerTypeAppPermissionGrant.SetFileStorageContainerTypeAppPermission(&fileStorageContainerTypeAppPermission)
}
fileStorageContainerTypeAppPermissionGrant.SetDelegatedPermissions(delegatedPermissions)
applicationPermissions := []graphmodels.FileStorageContainerTypeAppPermissionable {
	fileStorageContainerTypeAppPermission := graphmodels.NONE_FILESTORAGECONTAINERTYPEAPPPERMISSION 
	fileStorageContainerTypeAppPermissionGrant.SetFileStorageContainerTypeAppPermission(&fileStorageContainerTypeAppPermission)
}
fileStorageContainerTypeAppPermissionGrant.SetApplicationPermissions(applicationPermissions)

applicationPermissionGrants := []graphmodels.FileStorageContainerTypeAppPermissionGrantable {
	fileStorageContainerTypeAppPermissionGrant,
}
requestBody.SetApplicationPermissionGrants(applicationPermissionGrants)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
containerTypeRegistrations, err := graphClient.Storage().FileStorage().ContainerTypeRegistrations().ByFileStorageContainerTypeRegistrationId("fileStorageContainerTypeRegistration-id").Patch(context.Background(), requestBody, nil)

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

FileStorageContainerTypeRegistration fileStorageContainerTypeRegistration = new FileStorageContainerTypeRegistration();
FileStorageContainerTypeRegistrationSettings settings = new FileStorageContainerTypeRegistrationSettings();
settings.setUrlTemplate("https://fabrikam.example.com/{0}");
fileStorageContainerTypeRegistration.setSettings(settings);
LinkedList<FileStorageContainerTypeAppPermissionGrant> applicationPermissionGrants = new LinkedList<FileStorageContainerTypeAppPermissionGrant>();
FileStorageContainerTypeAppPermissionGrant fileStorageContainerTypeAppPermissionGrant = new FileStorageContainerTypeAppPermissionGrant();
fileStorageContainerTypeAppPermissionGrant.setAppId("33225700-9a00-4c00-84dd-0c210f203f01");
LinkedList<FileStorageContainerTypeAppPermission> delegatedPermissions = new LinkedList<FileStorageContainerTypeAppPermission>();
delegatedPermissions.add(FileStorageContainerTypeAppPermission.Full);
fileStorageContainerTypeAppPermissionGrant.setDelegatedPermissions(delegatedPermissions);
LinkedList<FileStorageContainerTypeAppPermission> applicationPermissions = new LinkedList<FileStorageContainerTypeAppPermission>();
applicationPermissions.add(FileStorageContainerTypeAppPermission.None);
fileStorageContainerTypeAppPermissionGrant.setApplicationPermissions(applicationPermissions);
applicationPermissionGrants.add(fileStorageContainerTypeAppPermissionGrant);
fileStorageContainerTypeRegistration.setApplicationPermissionGrants(applicationPermissionGrants);
FileStorageContainerTypeRegistration result = graphClient.storage().fileStorage().containerTypeRegistrations().byFileStorageContainerTypeRegistrationId("{fileStorageContainerTypeRegistration-id}").patch(fileStorageContainerTypeRegistration);

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const fileStorageContainerTypeRegistration = {
  settings: {
    urlTemplate: 'https://fabrikam.example.com/{0}'
  },
  applicationPermissionGrants: [
    {
      appId: '33225700-9a00-4c00-84dd-0c210f203f01',
      delegatedPermissions: ['full'],
      applicationPermissions: ['none']
    }
  ]
};

await client.api('/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00')
	.version('beta')
	.update(fileStorageContainerTypeRegistration);

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeRegistration;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeRegistrationSettings;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeAppPermissionGrant;
use Microsoft\Graph\Beta\Generated\Models\FileStorageContainerTypeAppPermission;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new FileStorageContainerTypeRegistration();
$settings = new FileStorageContainerTypeRegistrationSettings();
$settings->setUrlTemplate('https://fabrikam.example.com/{0}');
$requestBody->setSettings($settings);
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1 = new FileStorageContainerTypeAppPermissionGrant();
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1->setAppId('33225700-9a00-4c00-84dd-0c210f203f01');
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1->setDelegatedPermissions([new FileStorageContainerTypeAppPermission('full'),	]);
$applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1->setApplicationPermissions([new FileStorageContainerTypeAppPermission('none'),	]);
$applicationPermissionGrantsArray []= $applicationPermissionGrantsFileStorageContainerTypeAppPermissionGrant1;
$requestBody->setApplicationPermissionGrants($applicationPermissionGrantsArray);


$result = $graphServiceClient->storage()->fileStorage()->containerTypeRegistrations()->byFileStorageContainerTypeRegistrationId('fileStorageContainerTypeRegistration-id')->patch($requestBody)->wait();

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.file_storage_container_type_registration import FileStorageContainerTypeRegistration
from msgraph_beta.generated.models.file_storage_container_type_registration_settings import FileStorageContainerTypeRegistrationSettings
from msgraph_beta.generated.models.file_storage_container_type_app_permission_grant import FileStorageContainerTypeAppPermissionGrant
from msgraph_beta.generated.models.file_storage_container_type_app_permission import FileStorageContainerTypeAppPermission
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = FileStorageContainerTypeRegistration(
	settings = FileStorageContainerTypeRegistrationSettings(
		url_template = "https://fabrikam.example.com/{0}",
	),
	application_permission_grants = [
		FileStorageContainerTypeAppPermissionGrant(
			app_id = "33225700-9a00-4c00-84dd-0c210f203f01",
			delegated_permissions = [
				FileStorageContainerTypeAppPermission.Full,
			],
			application_permissions = [
				FileStorageContainerTypeAppPermission.None,
			],
		),
	],
)

result = await graph_client.storage.file_storage.container_type_registrations.by_file_storage_container_type_registration_id('fileStorageContainerTypeRegistration-id').patch(request_body)

Important

Microsoft Graph SDKs use the v1.0 version of the API by default, and do not support all the types, properties, and APIs available in the beta version. For details about accessing the beta API with the SDK, see Use the Microsoft Graph SDKs with the beta API.

For details about how to add the SDK to your project and create an authProvider instance, see the SDK documentation.

Response

The following example shows the response.

HTTP/1.1 400 Bad Request