Create fileStorageContainer

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.

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

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