Adicionar propriedades personalizadas a um fileStorageContainer

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Adicionar propriedades personalizadas a um objeto fileStorageContainer .

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.

Observação

Além das permissões do Microsoft Graph, seu aplicativo deve ter a permissão ou permissões de nível de tipo de contêiner necessárias para chamar essa API. Para obter mais informações, consulte tipos de contêiner. Para saber mais sobre permissões de nível de tipo de contêiner, consulte Autorização do SharePoint Embedded.

Solicitação HTTP

PATCH /storage/fileStorage/containers/{containerId}/customProperties

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 de um fileStorageContainerCustomPropertyDictionary, que é um mapa com chaves de cadeia de caracteres e valores fileStorageContainerCustomPropertyValue .

Você pode especificar as propriedades a seguir ao criar uma propriedade personalizada.

Propriedade Tipo Descrição
isPatternToken Booliano Indica se o valor é um urlTemplate padrão (por exemplo, um token como {itemId} o usado para configurar o comportamento de redirecionamento ao abrir arquivos), em vez de um valor literal que os consumidores devem resolver antes de usar. Opcional. O valor padrão é false.
isSearchable Booliano Um sinalizador para indicar se a propriedade é pesquisável. Opcional. O valor padrão é false.
valor Cadeia de caracteres O valor da propriedade personalizada. Obrigatório.

Resposta

Se tiver êxito, este método retornará um código de resposta 201 Created.

Exemplos

Exemplo 1: Criar uma propriedade personalizada

Solicitação

O exemplo a seguir mostra como criar uma propriedade personalizada chamada clientUniqueId para um contêiner.

PATCH https://graph.microsoft.com/beta/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties
Content-Type: application/json

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b"
  }
}

Resposta

O exemplo a seguir mostra a resposta. Por padrão, a propriedade não é pesquisável.

HTTP/1.1 201 Created

Exemplo 2: Criar uma propriedade pesquisável personalizada

Solicitação

O exemplo a seguir mostra como criar uma propriedade personalizada pesquisável chamada clientUniqueId para um contêiner.

PATCH https://graph.microsoft.com/beta/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties
Content-Type: application/json

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b",
    "isSearchable": true
  }
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 201 Created
  • Última atualização a