Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.
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. Se uma propriedade personalizada especificada no corpo do pedido não existir no contentor, será criada.
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 e 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) | 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 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. Tenha em atenção que isSearchable para foi definido como clientUniqueIdtrue antes de chamar esta API.
PATCH https://graph.microsoft.com/beta/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
}
}