Mettre à jour les propriétés personnalisées d’un fileStorageContainer
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta
dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Mettez à jour une ou plusieurs propriétés personnalisées sur un fileStorageContainer. Seuls les attributs value et isSearchable des propriétés personnalisées peuvent être mis à jour. Seules les propriétés personnalisées spécifiées dans le corps de la demande sont mises à jour. Si une propriété personnalisée spécifiée dans le corps de la demande n’existe pas sur le conteneur, elle est créée.
La mise à jour d’une propriété personnalisée vers une null
valeur supprime la propriété du conteneur.
L’application appelant cette API doit disposer d’autorisations de lecture et d’écriture sur fileStorageContainer pour le type de conteneur respectif.
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | FileStorageContainer.Selected | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | FileStorageContainer.Selected | Non disponible. |
Remarque
En plus des autorisations Microsoft Graph, votre application doit disposer de l’autorisation ou des autorisations nécessaires au niveau du type de conteneur pour appeler cette API. Pour plus d’informations, consultez Types de conteneurs. Pour en savoir plus sur les autorisations au niveau du type de conteneur, voir Autorisation SharePoint Embedded.
Requête HTTP
PATCH /storage/fileStorage/containers/{containerId}/customProperties
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Content-Type | application/json. Obligatoire. |
Corps de la demande
Dans le corps de la demande, fournissez les propriétés personnalisées à mettre à jour et les nouvelles valeurs pour les champs appropriés.
Les propriétés suivantes sur les propriétés personnalisées peuvent être modifiées.
Propriété | Type | Description |
---|---|---|
value | String | Valeur de la propriété personnalisée. |
isSearchable | Boolean | Indique si la propriété peut faire l’objet d’une recherche. |
Réponse
Si elle réussit, cette action renvoie un code de réponse 200 OK
.
Exemples
Demande
L’exemple suivant met à jour la value
propriété des propriétés personnalisées clientUniqeId
et color
. Notez que isSearchable
pour clientUniqueId
a été défini sur true
avant d’appeler cette 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"
}
}
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 200 Ok
{
"clientUniqueId": {
"value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b",
"isSearchable": true
},
"color": {
"value": "green",
"isSearchable": false
}
}