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, isSearchable et isPatternToken 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, il est créé.

La mise à jour d’une propriété personnalisée en valeur null supprime la propriété du conteneur.

L’application appelant cette API doit disposer des autorisations de lecture et d’écriture sur fileStorageContainer pour le type de conteneur respectif.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Outre les 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 de conteneur, consultez Autorisation SharePoint Embedded.

Requête HTTP

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

En-têtes de demande

Corps de la demande

Dans le corps de la demande, indiquez les propriétés personnalisées à mettre à jour et les nouvelles valeurs pour les champs concerné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 clientUniqeId personnalisées et color. Notez que isSearchable for clientUniqueId a été défini sur avant d’appeler true 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
  }
}