Mettre à jour les propriétés personnalisées d’un fileStorageContainer

Espace de noms: microsoft.graph

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.

En plus des autorisations Microsoft Graph, votre application doit également disposer de l’autorisation ou des autorisations nécessaires au niveau du type conteneur pour appeler cette API. Pour plus d’informations sur les types de conteneurs, consultez Types de conteneurs. Pour en savoir plus sur les autorisations au niveau du type conteneur, voir Autorisation incorporée SharePoint.

Requête HTTP

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

En-têtes de demande

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.

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/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties
Content-type: application/json

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

const options = {
	authProvider,
};

const client = Client.init(options);

const fileStorageContainerCustomPropertyDictionary = {
  clientUniqueId: {
    value: 'c5d88310-1fc7-49be-80ca-e7d7a11e638b'
  },
  color: {
    value: 'green'
  }
};

await client.api('/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties')
	.update(fileStorageContainerCustomPropertyDictionary);

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
  }
}