Partager via

Création d’un dossier dans un lecteur

  • Article

Créez un dossier ou un objet DriveItem dans un lecteur possédant un élément parent ou un chemin d’accès spécifié.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.ReadWrite, Files.ReadWrite.All
Application Files.ReadWrite.All, Sites.ReadWrite.All

Requête HTTP

POST /drives/{drive-id}/items/{parent-item-id}/children
POST /groups/{group-id}/drive/items/{parent-item-id}/children
POST /me/drive/items/{parent-item-id}/children
POST /sites/{site-id}/drive/items/{parent-item-id}/children
POST /users/{user-id}/drive/items/{parent-item-id}/children

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de la ressource DriveItem à créer.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 201 Created et une ressource Driveitem dans le corps de la réponse.

Exemple

Demande

Voici un exemple de la demande de création d’un dossier dans le dossier racine du lecteur OneDrive de l’utilisateur connecté. La propriété @microsoft.graph.conflictBehavior utilisée indique que, si un élément portant le même nom existe déjà, le service doit choisir un nouveau nom pour le dossier lorsqu’il le crée.

POST /me/drive/root/children
Content-Type: application/json

{
  "name": "New Folder",
  "folder": { },
  "@microsoft.graph.conflictBehavior": "rename"
}

Réponse

Si elle réussit, cette méthode renvoie le dossier créé en tant que ressourceDriveItem.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "createdBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "309EC495-3E92-431D-9124-F0299633171D"
    }
  },
  "createdDateTime": "2016-09-20T14:34:00Z",
  "eTag": "343F1FBD-E9B3-4DDE-BCA7-D61AEAFF44E5,1",
  "id": "ACEA49D1-1444-45A9-A1CB-68B1B28AE491",
  "lastModifiedBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "309EC495-3E92-431D-9124-F0299633171D"
    }
  },
  "lastModifiedDateTime": "2016-09-20T14:34:00Z",
  "name": "New Folder",
  "parentReference": {
    "driveId": "5FE38E3C-051C-4D55-9B83-8A437658275B",
    "id": "E67A8F34-B0AA-46E1-8FF7-0750A29553DF",
    "path": "/drive/root:/"
  },
  "size": 0,
  "folder": {
    "childCount": 0
  }
}

Réponse d’erreur

Pour plus d’informations sur la façon dont les erreurs sont renvoyées, consultez Réponses d’erreur.