Atualizar fileStorageContainerType

Namespace: microsoft.graph

Atualize as propriedades de um objeto fileStorageContainerType . As propriedades atualizadas refletem-se em cada ficheiro registadoStorageContainerTypeRegistration num máximo de 24 horas. As definições substituídas num inquilino não são atualizadas.

Nota: quando as definições são atualizadas, o comportamento de qualquer novo ficheiroStorageContainer é alterado, mas os contentores existentes podem exigir que as definições sejam atualizadas diretamente ou poderão não ser atualizadas; por exemplo, o tamanho do armazenamento.

A ETag é utilizada para o controlo de simultaneidade otimista. Tem de corresponder ao valor de Criar, Obter ou da Atualização anterior.

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.

Solicitação HTTP

PATCH /storage/fileStorage/containerTypes/{fileStorageContainerTypeId}

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 apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

Propriedade	Tipo	Descrição
name	Cadeia de caracteres	Nome do fileStorageContainerType. Opcional.
settings	fileStorageContainerTypeSettings	fileStorageContainerType settings. Opcional.
etag	Cadeia de caracteres	Utilizado para controlo de simultaneidade otimista. Tem de corresponder ao valor devolvido de um pedido Criar ou Obter . Obrigatório.

Resposta

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

Exemplos

Exemplo 1: Atualizar um ficheiroStorageContainerType

O exemplo seguinte mostra como atualizar um fileStorageContainerType.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

{
  "settings": {
    "urlTemplate": "https://app.contoso.com/redirect?tenant={tenant-id}&drive={drive-id}&folder={folder-id}&item={item-id}",
    "isItemVersioningEnabled": true,
    "isSharingRestricted": false
  },
  "etag": "RVRhZw=="
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

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

Exemplo 2: Atualizar um ficheiroStorageContainerType sem ETag

O exemplo seguinte mostra como atualizar um fileStorageContainerType sem uma etag.

Solicitação

O exemplo a seguir mostra uma solicitação.

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

{
  "@odata.type": "#microsoft.graph.fileStorageContainerType",
  "settings": {
    "urlTemplate": "https://app.contoso.com/redirect?tenant={tenant-id}&drive={drive-id}&folder={folder-id}&item={item-id}",
    "isItemVersioningEnabled": true,
    "isSharingRestricted": false
  }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 400 Bad Request