Insérer des colonnes

Espace de noms: microsoft.graph

Upsert (créer ou mettre à jour) jusqu’à 20 objets columnDefinition sur un fileStorageContainer en une seule requête. Le correctif delta permet à l’appelant d’effectuer plusieurs opérations (création, mise à jour) sur un maximum de 20 colonnes avec une seule requête.

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 FileStorageContainer.Manage.All
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}/columns

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 un objet JSON ayant les propriétés suivantes.

Nom Type Description
@context String Annotation OData qui identifie le type de charge utile. Doit être définie #$delta sur pour signaler une opération de patch delta. Obligatoire.
valeur collection columnDefinition Collection d’un maximum de 20 objets columnDefinition à traiter. Obligatoire.

Chaque entrée de la collection de valeurs représente une opération sur une columnDefinition. La présence de la propriété id détermine la façon dont l’entrée est interprétée :

  • Créer : omettez la propriété id . Spécifiez la propriété name (nom) et la propriété de type de colonne (par exemple, booléen, texte, choix).
  • Mettre à jour : Incluez l’ID de la colonne existante et les propriétés à mettre à jour.

Réponse

En cas de réussite, cette méthode renvoie un 200 OK code de réponse et une collection d’objets columnDefinition dans le corps de la réponse. Les colonnes traitées avec succès incluent l’objet columnDefinition complet. Les éléments ayant échoué incluent une annotation @Core.DataModificationException avec les détails de l’erreur.

Cette API peut également retourner les codes de réponse d’erreur suivants pour l’ensemble de la requête :

Code HTTP Description
400 Demande incorrecte
401 La demande ne dispose pas d’informations d’authentification valides.
403 Les informations d’authentification fournies sont valides, mais insuffisantes pour effectuer l’opération demandée.
404 Le conteneur n’existe pas.
423 Le conteneur est verrouillé. Par exemple, le conteneur est archivé.

Exemples

Demande

L’exemple suivant montre une seule demande de patch delta qui mélange, crée et met à jour des éléments en un seul appel. Les éléments sans ID sont traités comme des opérations de création ; les éléments avec un ID sont traités comme des opérations de mise à jour. Les éléments en échec sont signalés en ligne avec une annotation @Core.DataModificationException . Les autres éléments réussissent encore.

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns
Content-Type: application/json

{
  "@context": "#$delta",
  "value": [
    {
      "id": "aec21c58-7f1f-4875-b438-d47ef622306c",
      "isSearchable": false
    },
    {
      "id": "aec21c58-7f1f-4875-b438-d47df622306c",
      "isSearchable": false
    },
    {
      "name": "booleanColumn1234",
      "boolean": {}
    },
    {
      "name": "booleanColumn33",
      "boolean": {}
    }
  ]
}

Réponse

L’exemple suivant illustre la réponse. La réponse inclut un élément pour chaque élément de la demande, dans le même ordre. Dans cet exemple, le premier élément de demande est une opération de mise à jour qui réussit, le deuxième élément de demande est une opération de mise à jour qui échoue parce qu’aucune colonne avec cet ID n’existe, le troisième élément de demande est une opération de création qui réussit et le quatrième élément de demande est une opération de création qui échoue parce qu’une colonne portant ce nom existe déjà.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#storage/fileStorage/containers('b%21ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z')/columns/$delta",
  "value": [
    {
      "@odata.etag": "\"4\"",
      "description": "",
      "displayName": "booleanColumn8",
      "id": "aec21c58-7f1f-4875-b438-d47ef622306c",
      "indexed": false,
      "isSearchable": false,
      "isDeletable": true,
      "isSealed": false,
      "name": "booleanColumn8",
      "readOnly": false,
      "type": "boolean",
      "boolean": {}
    },
    {
      "@Core.DataModificationException": {
        "@odata.type": "#Org.OData.Core.V1.DataModificationExceptionType",
        "failedOperation": "Update",
        "responseCode": 404,
        "info": {
          "code": "NotFound",
          "message": "Item not found."
        }
      },
      "id": "aec21c58-7f1f-4875-b438-d47df622306c",
      "type": "unknownFutureValue"
    },
    {
      "@odata.etag": "\"1\"",
      "description": "",
      "displayName": "booleanColumn1234",
      "id": "7eac4ae0-afe9-4a02-8cfa-9369558b44db",
      "indexed": false,
      "isSearchable": false,
      "isDeletable": true,
      "isSealed": false,
      "name": "booleanColumn1234",
      "readOnly": false,
      "type": "boolean",
      "boolean": {}
    },
    {
      "@Core.DataModificationException": {
        "@odata.type": "#Org.OData.Core.V1.DataModificationExceptionType",
        "failedOperation": "Create",
        "responseCode": 409,
        "info": {
          "code": "Conflict",
          "message": "A field with the specified name already exists"
        }
      },
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "booleanColumn33",
      "type": "unknownFutureValue",
      "boolean": {}
    }
  ]
}
  • Last updated on