Partilhar via

Adicionar propriedades personalizadas a um ficheiroStorageContainer

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.

Adicione propriedades personalizadas a um objeto fileStorageContainer .

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) 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, a sua aplicação tem de ter as permissões ou permissões necessárias ao nível do tipo de contentor para chamar esta API. Para obter mais informações, veja Tipos de contentor. Para saber mais sobre as permissões ao nível do tipo de contentor, veja 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 do pedido, forneça uma representação JSON de um fileStorageContainerCustomPropertyDictionary, que é um mapa com chaves de cadeia e valores fileStorageContainerCustomPropertyValue .

Pode especificar as seguintes propriedades quando criar uma propriedade personalizada.

Propriedade Tipo Descrição
value Cadeia de caracteres O valor da propriedade personalizada. Obrigatório.
isSearchable Booliano Um sinalizador para indicar se a propriedade é pesquisável. Opcional. O valor padrão é false.

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 seguinte mostra como criar uma propriedade personalizada chamada clientUniqueId para um contentor.

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 predefinição, a propriedade não é pesquisável.

HTTP/1.1 201 Created

Exemplo 2: Criar uma propriedade pesquisável personalizada

Solicitação

O exemplo seguinte mostra como criar uma propriedade personalizada pesquisável chamada clientUniqueId para um contentor.

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
  • Last updated on