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

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 é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.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) FileStorageContainer.Selected Non disponible.
Déléguée (compte Microsoft personnel) FileStorageContainer.Selected Non disponible.
Application FileStorageContainer.Selected Non disponible.

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

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
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 une carte 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
isPatternToken Booléen Indique si la valeur est un urlTemplate modèle (par exemple, un jeton tel qu’utilisé {itemId} pour configurer le comportement de redirection lors de l’ouverture de fichiers), plutôt qu’une valeur littérale que les consommateurs doivent résoudre avant utilisation. Facultatif. La valeur par défaut est false.
is_searchable Booléen Indicateur indiquant si la propriété peut faire l’objet d’une recherche. Facultatif. La valeur par défaut est false.
valeur String Valeur de la propriété personnalisée. Obligatoire.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 201 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 201 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 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 201 Created
  • Dernière mise à jour :