Namespace: microsoft.graph
Crie um novo objeto fileStorageContainer .
O tipo de contêiner identificado por containerTypeId deve ser registrado no locatário.
Para chamadas delegadas, o usuário de chamada é definido como o proprietário do fileStorageContainer.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global |
Governo dos EUA L4 |
US Government L5 (DOD) |
China operada pela 21Vianet |
| ✅ |
✅ |
✅ |
✅ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão |
Permissões menos privilegiadas |
Permissões com privilégios mais elevados |
| Delegado (conta corporativa ou de estudante) |
FileStorageContainer.Selected |
Indisponível. |
| Delegado (conta pessoal da Microsoft) |
FileStorageContainer.Selected |
Indisponível. |
| Application |
FileStorageContainer.Selected |
Indisponível. |
Além das permissões do Microsoft Graph, seu aplicativo também deve ter a permissão ou permissões de nível de tipo de contêiner necessárias para chamar essa API. Para obter detalhes sobre tipos de contêiner, consulte Tipos de contêiner. Para saber mais sobre permissões de nível de tipo de contêiner, consulte Autorização Incorporada do SharePoint.
Solicitação HTTP
POST /storage/fileStorage/containers
Parâmetros de consulta opcionais
Esse método dá suporte aos seguintes parâmetros de consulta OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
| Nome |
Descrição |
| dataLocation |
Especifica o local de dados desejado para a criação de contêiner em locatários Multi-Geo. A omissão do dataLocation parâmetro na solicitação cria o contêiner no local padrão do locatário. Para obter mais informações, consulte regiões Multi-Geo disponíveis e seus códigos de localização. |
| Nome |
Descrição |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type |
application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON do objeto fileStorageContainer .
Você pode especificar as propriedades a seguir ao criar um fileStorageContainer.
| Propriedade |
Tipo |
Descrição |
| displayName |
Cadeia de caracteres |
O nome de exibição do contêiner. Obrigatório. |
| description |
Cadeia de caracteres |
Descrição visível do contêiner para o usuário. Opcional. |
| containerTypeId |
GUID |
O tipo de contêiner da instância de contêiner. Obrigatório. |
| settings |
fileStorageContainerSettings |
Configurações associadas ao contêiner. Opcional. |
Resposta
Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto fileStorageContainer no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra como criar um fileStorageContainer.
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
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new FileStorageContainer
{
DisplayName = "My Application Storage Container",
Description = "Description of My Application Storage Container",
ContainerTypeId = Guid.Parse("91710488-5756-407f-9046-fbe5f0b4de73"),
Settings = new FileStorageContainerSettings
{
IsOcrEnabled = true,
},
};
// 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.Containers.PostAsync(requestBody);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// 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.NewFileStorageContainer()
displayName := "My Application Storage Container"
requestBody.SetDisplayName(&displayName)
description := "Description of My Application Storage Container"
requestBody.SetDescription(&description)
containerTypeId := uuid.MustParse("91710488-5756-407f-9046-fbe5f0b4de73")
requestBody.SetContainerTypeId(&containerTypeId)
settings := graphmodels.NewFileStorageContainerSettings()
isOcrEnabled := true
settings.SetIsOcrEnabled(&isOcrEnabled)
requestBody.SetSettings(settings)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
containers, err := graphClient.Storage().FileStorage().Containers().Post(context.Background(), requestBody, nil)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
FileStorageContainer fileStorageContainer = new FileStorageContainer();
fileStorageContainer.setDisplayName("My Application Storage Container");
fileStorageContainer.setDescription("Description of My Application Storage Container");
fileStorageContainer.setContainerTypeId(UUID.fromString("91710488-5756-407f-9046-fbe5f0b4de73"));
FileStorageContainerSettings settings = new FileStorageContainerSettings();
settings.setIsOcrEnabled(true);
fileStorageContainer.setSettings(settings);
FileStorageContainer result = graphClient.storage().fileStorage().containers().post(fileStorageContainer);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
const options = {
authProvider,
};
const client = Client.init(options);
const fileStorageContainer = {
displayName: 'My Application Storage Container',
description: 'Description of My Application Storage Container',
containerTypeId: '91710488-5756-407f-9046-fbe5f0b4de73',
settings: {
isOcrEnabled: true
}
};
await client.api('/storage/fileStorage/containers')
.post(fileStorageContainer);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\FileStorageContainer;
use Microsoft\Graph\Generated\Models\FileStorageContainerSettings;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new FileStorageContainer();
$requestBody->setDisplayName('My Application Storage Container');
$requestBody->setDescription('Description of My Application Storage Container');
$requestBody->setContainerTypeId('91710488-5756-407f-9046-fbe5f0b4de73');
$settings = new FileStorageContainerSettings();
$settings->setIsOcrEnabled(true);
$requestBody->setSettings($settings);
$result = $graphServiceClient->storage()->fileStorage()->containers()->post($requestBody)->wait();
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
# 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 import FileStorageContainer
from msgraph.generated.models.file_storage_container_settings import FileStorageContainerSettings
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = FileStorageContainer(
display_name = "My Application Storage Container",
description = "Description of My Application Storage Container",
container_type_id = UUID("91710488-5756-407f-9046-fbe5f0b4de73"),
settings = FileStorageContainerSettings(
is_ocr_enabled = True,
),
)
result = await graph_client.storage.file_storage.containers.post(request_body)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
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": false,
"itemMajorVersionLimit": 50,
"isItemVersioningEnabled": true
}
}