Atualizar as propriedades personalizadas de um ficheiroStorageContainer
Namespace: microsoft.graph
Atualize uma ou várias propriedades personalizadas num ficheiroStorageContainer. Apenas os atributos value e isSearchable das propriedades personalizadas podem ser atualizados. Apenas as propriedades personalizadas especificadas no corpo do pedido são atualizadas. As propriedades personalizadas especificadas no corpo do pedido são criadas se ainda não existirem no contentor.
Atualizar uma propriedade personalizada para um null
valor elimina a propriedade do contentor.
A aplicação que chama esta API tem de ter permissões de leitura/escrita para o fileStorageContainer para o respetivo tipo de contentor.
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) | Sem suporte. | Sem suporte. |
Application | FileStorageContainer.Selected | Indisponível. |
Além das permissões do Microsoft Graph, a sua aplicação também tem de ter as permissões ou permissões necessárias ao nível do contentor para chamar esta API. Para obter detalhes sobre os tipos de contentor, veja Tipos de Contentor. Para saber mais sobre as permissões ao nível do 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 as propriedades personalizadas a atualizar e os novos valores para os campos relevantes.
As seguintes propriedades em propriedades personalizadas podem ser modificadas.
Propriedade | Tipo | Descrição |
---|---|---|
value | Cadeia de caracteres | O valor da propriedade personalizada. |
isSearchable | Booliano | Indica se a propriedade é pesquisável. |
Resposta
Se tiver êxito, esta ação retornará um código de resposta 200 OK
.
Exemplos
Solicitação
O exemplo seguinte atualiza a value
propriedade das propriedades personalizadas clientUniqeId
e color
. Neste exemplo, isSearchable
para foi definido como clientUniqueId
true
antes de chamar a API.
PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties
Content-type: application/json
{
"clientUniqueId": {
"value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b"
},
"color": {
"value": "green"
}
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 Ok
{
"clientUniqueId": {
"value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b",
"isSearchable": true
},
"color": {
"value": "green",
"isSearchable": false
}
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de