Namespace: microsoft.graph
Erstellen Sie einen neuen fileStorageContainerType im besitzenden Mandanten. Die Anzahl der Containertypen in einem Mandanten ist begrenzt.
Wichtig
- Der Mandant muss besitzer der Anwendung sein, die als Besitzer des fileStorageContainerType (owningAppId) zugewiesen ist.
- Die Registrierung eines Containertyps in einem neu erstellten Mandanten kann fehlschlagen, wenn der Mandant noch nicht vollständig bereit ist. Möglicherweise müssen Sie mindestens eine Stunde warten, bevor Sie einen Containertyp in einem neuen Mandanten registrieren können.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
| ✅ |
✅ |
✅ |
✅ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
| Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
| Delegiert (Geschäfts-, Schul- oder Unikonto) |
FileStorageContainerType.Manage.All |
Nicht verfügbar. |
| Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
| Application |
Nicht unterstützt |
Nicht unterstützt |
Hinweis: Zum Aufrufen dieser API ist entweder die SharePoint Embedded-Administratorrolle oder die Globale Administratorrolle erforderlich.
HTTP-Anforderung
POST /storage/fileStorage/containerTypes
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des fileStorageContainerType-Objekts an.
Sie können die folgenden Eigenschaften angeben, wenn Sie eine dateiStorageContainerType erstellen.
| Eigenschaft |
Typ |
Beschreibung |
| billingClassification |
fileStorageContainerBillingClassification |
Der Abrechnungstyp. Mögliche Werte sind: standard, trial, directToCustomer, unknownFutureValue. Der Standardwert ist standard. Optional. |
| name |
Zeichenfolge |
Der Name des fileStorageContainerType.The name of the fileStorageContainerType. Erforderlich. |
| owningAppId |
GUID |
ID der Anwendung, die besitzer des fileStorageContainerType ist. Erforderlich. |
| settings |
fileStorageContainerTypeSettings |
Die Einstellungen von fileStorageContainerType. Optional. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der 201 Created Antwortcode und ein fileStorageContainerType-Objekt im Antworttext zurückgegeben.
Beispiele
Anforderung
Das folgende Beispiel zeigt, wie Sie eine TestdateiStorageContainerType erstellen.
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"]
}
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
using Microsoft.Kiota.Abstractions.Serialization;
var requestBody = new FileStorageContainerType
{
Name = "Test Trial Container",
OwningAppId = Guid.Parse("11335700-9a00-4c00-84dd-0c210f203f00"),
BillingClassification = FileStorageContainerBillingClassification.Trial,
Settings = new FileStorageContainerTypeSettings
{
IsItemVersioningEnabled = true,
IsSharingRestricted = false,
ConsumingTenantOverridables = FileStorageContainerTypeSettingsOverride.IsSearchEnabled | FileStorageContainerTypeSettingsOverride.ItemMajorVersionLimit,
AdditionalData = new Dictionary<string, object>
{
{
"agent" , new UntypedObject(new Dictionary<string, UntypedNode>
{
{
"chatEmbedAllowedHosts", new UntypedArray(new List<UntypedNode>
{
new UntypedString("https://localhost:3000"),
})
},
})
},
},
},
};
// 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.ContainerTypes.PostAsync(requestBody);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
"github.com/google/uuid"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewFileStorageContainerType()
name := "Test Trial Container"
requestBody.SetName(&name)
owningAppId := uuid.MustParse("11335700-9a00-4c00-84dd-0c210f203f00")
requestBody.SetOwningAppId(&owningAppId)
billingClassification := graphmodels.TRIAL_FILESTORAGECONTAINERBILLINGCLASSIFICATION
requestBody.SetBillingClassification(&billingClassification)
settings := graphmodels.NewFileStorageContainerTypeSettings()
isItemVersioningEnabled := true
settings.SetIsItemVersioningEnabled(&isItemVersioningEnabled)
isSharingRestricted := false
settings.SetIsSharingRestricted(&isSharingRestricted)
consumingTenantOverridables := graphmodels.ISSEARCHENABLED,ITEMMAJORVERSIONLIMIT_FILESTORAGECONTAINERTYPESETTINGSOVERRIDE
settings.SetConsumingTenantOverridables(&consumingTenantOverridables)
additionalData := map[string]interface{}{
agent := graph.New()
chatEmbedAllowedHosts := []string {
"https://localhost:3000",
}
agent.SetChatEmbedAllowedHosts(chatEmbedAllowedHosts)
settings.SetAgent(agent)
}
settings.SetAdditionalData(additionalData)
requestBody.SetSettings(settings)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
containerTypes, err := graphClient.Storage().FileStorage().ContainerTypes().Post(context.Background(), requestBody, nil)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
FileStorageContainerType fileStorageContainerType = new FileStorageContainerType();
fileStorageContainerType.setName("Test Trial Container");
fileStorageContainerType.setOwningAppId(UUID.fromString("11335700-9a00-4c00-84dd-0c210f203f00"));
fileStorageContainerType.setBillingClassification(FileStorageContainerBillingClassification.Trial);
FileStorageContainerTypeSettings settings = new FileStorageContainerTypeSettings();
settings.setIsItemVersioningEnabled(true);
settings.setIsSharingRestricted(false);
settings.setConsumingTenantOverridables(EnumSet.of(FileStorageContainerTypeSettingsOverride.IsSearchEnabled, FileStorageContainerTypeSettingsOverride.ItemMajorVersionLimit));
HashMap<String, Object> additionalData = new HashMap<String, Object>();
agent = new ();
LinkedList<String> chatEmbedAllowedHosts = new LinkedList<String>();
chatEmbedAllowedHosts.add("https://localhost:3000");
agent.setChatEmbedAllowedHosts(chatEmbedAllowedHosts);
additionalData.put("agent", agent);
settings.setAdditionalData(additionalData);
fileStorageContainerType.setSettings(settings);
FileStorageContainerType result = graphClient.storage().fileStorage().containerTypes().post(fileStorageContainerType);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
const options = {
authProvider,
};
const client = Client.init(options);
const fileStorageContainerType = {
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']
}
}
};
await client.api('/storage/fileStorage/containerTypes')
.post(fileStorageContainerType);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\FileStorageContainerType;
use Microsoft\Graph\Generated\Models\FileStorageContainerBillingClassification;
use Microsoft\Graph\Generated\Models\FileStorageContainerTypeSettings;
use Microsoft\Graph\Generated\Models\FileStorageContainerTypeSettingsOverride;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new FileStorageContainerType();
$requestBody->setName('Test Trial Container');
$requestBody->setOwningAppId('11335700-9a00-4c00-84dd-0c210f203f00');
$requestBody->setBillingClassification(new FileStorageContainerBillingClassification('trial'));
$settings = new FileStorageContainerTypeSettings();
$settings->setIsItemVersioningEnabled(true);
$settings->setIsSharingRestricted(false);
$settings->setConsumingTenantOverridables(new FileStorageContainerTypeSettingsOverride('isSearchEnabled,itemMajorVersionLimit'));
$additionalData = [
'agent' => [
'chatEmbedAllowedHosts' => [
'https://localhost:3000', ],
],
];
$settings->setAdditionalData($additionalData);
$requestBody->setSettings($settings);
$result = $graphServiceClient->storage()->fileStorage()->containerTypes()->post($requestBody)->wait();
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.file_storage_container_type import FileStorageContainerType
from msgraph.generated.models.file_storage_container_billing_classification import FileStorageContainerBillingClassification
from msgraph.generated.models.file_storage_container_type_settings import FileStorageContainerTypeSettings
from msgraph.generated.models.file_storage_container_type_settings_override import FileStorageContainerTypeSettingsOverride
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = FileStorageContainerType(
name = "Test Trial Container",
owning_app_id = UUID("11335700-9a00-4c00-84dd-0c210f203f00"),
billing_classification = FileStorageContainerBillingClassification.Trial,
settings = FileStorageContainerTypeSettings(
is_item_versioning_enabled = True,
is_sharing_restricted = False,
consuming_tenant_overridables = FileStorageContainerTypeSettingsOverride.IsSearchEnabled | FileStorageContainerTypeSettingsOverride.ItemMajorVersionLimit,
additional_data = {
"agent" : {
"chat_embed_allowed_hosts" : [
"https://localhost:3000",
],
},
}
),
)
result = await graph_client.storage.file_storage.container_types.post(request_body)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
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"]
}
}
}