Ajouter des propriétés personnalisées à un fichierStorageContainer

Espace de noms: microsoft.graph

Ajoutez des propriétés personnalisées à un objet fileStorageContainer .

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.

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

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 une représentation JSON d’un fileStorageContainerCustomPropertyDictionary, qui est un mappage avec des clés de chaîne et des valeurs fileStorageContainerCustomPropertyValue .

Vous pouvez spécifier les propriétés suivantes lorsque vous créez une propriété personnalisée.

Propriété Type Description
value String Valeur de la propriété personnalisée. Obligatoire.
isSearchable Boolean Indicateur pour indiquer si la propriété peut faire l’objet d’une recherche. Optional. La valeur par défaut est false.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 Created.

Exemples

Exemple 1 : Créer une propriété personnalisée

Demande

L’exemple suivant montre comment créer une propriété personnalisée appelée clientUniqueId pour un conteneur.

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/{containerId}/customProperties
Content-Type: application/json

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

Réponse

L’exemple suivant illustre la réponse. Par défaut, la propriété ne peut pas faire l’objet d’une recherche.

HTTP/1.1 200 Created

Exemple 2 : Créer une propriété personnalisée pouvant faire l’objet d’une recherche

Demande

L’exemple suivant montre comment créer une propriété personnalisée pouvant faire l’objet d’une recherche appelée clientUniqueId pour un conteneur.

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",
    "isSearchable": true
  }
}

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 200 Created