Criar fileStorageContainerType

Namespace: microsoft.graph

Crie um novo fileStorageContainerType no inquilino proprietário. O número de tipos de contentor num inquilino é limitado.

Importante

• O inquilino tem de ser proprietário da aplicação atribuída como o proprietário do ficheiroStorageContainerType (proprietário doAppId).
• O registo de um tipo de contentor num inquilino recentemente criado pode falhar se o inquilino ainda não estiver totalmente pronto. Poderá ter de esperar pelo menos uma hora para poder registar um tipo de contentor num novo inquilino.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão	Permissões com menos privilégios	Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)	FileStorageContainerType.Manage.All	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Aplicativo	Sem suporte.	Sem suporte.

Nota: A função de administrador do SharePoint Embedded ou a função de Administrador global são necessárias para chamar esta API.

Solicitação HTTP

POST /storage/fileStorage/containerTypes

Cabeçalhos de solicitaçã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 do pedido, forneça uma representação JSON do objeto fileStorageContainerType .

Pode especificar as seguintes propriedades quando criar um fileStorageContainerType.

Propriedade	Tipo	Descrição
faturaçãoClassificação	fileStorageContainerBillingClassification	O tipo de faturação. Os valores possíveis são: standard, trial, directToCustomer, unknownFutureValue. O valor padrão é standard. Opcional.
nome	Cadeia de caracteres	O nome do fileStorageContainerType. Obrigatório.
owningAppId	Guid	ID da aplicação proprietária do ficheiroStorageContainerType. Obrigatório.
settings	fileStorageContainerTypeSettings	As definições de fileStorageContainerType. Opcional.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto fileStorageContainerType no corpo da resposta.

Exemplos

Solicitação

O exemplo seguinte mostra como criar um ficheiro de avaliaçãoStorageContainerType.

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

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