bloc-notes: copyNotebooknotebook: copyNotebook

Copie un bloc-notes dans le dossier bloc-notes de la bibliothèque documents de destination.Copies a notebook to the Notebooks folder in the destination Documents library. Le dossier est créé s’il n’existe pas.The folder is created if it doesn't exist.

Pour les opérations de copie, vous suivez un modèle d’appel asynchrone: appelez d’abord l’action Copy, puis interrogez le point de terminaison de l’opération pour le résultat.For Copy operations, you follow an asynchronous calling pattern: First call the Copy action, and then poll the operation endpoint for the result.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Notes.Create, Notes.ReadWrite, Notes.ReadWrite.AllNotes.Create, Notes.ReadWrite, Notes.ReadWrite.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Notes.Create, Notes.ReadWriteNotes.Create, Notes.ReadWrite
ApplicationApplication Notes.ReadWrite.AllNotes.ReadWrite.All

Requête HTTPHTTP request

POST /me/onenote/notebooks/{id}/copyNotebook
POST /users/{id | userPrincipalName}/onenote/notebooks/{id}/copyNotebook
POST /groups/{id}/onenote/notebooks/{id}/copyNotebook

En-têtes de demandeRequest headers

NomName TypeType DescriptionDescription
AutorisationAuthorization stringstring Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type stringstring application/json

Corps de la demandeRequest body

Dans le corps de la demande, fournissez un objet JSON qui contient les paramètres dont votre opération a besoin.In the request body, provide a JSON object that contains the parameters that your operation needs. Il est possible d’envoyer un corps vide si aucun n’est nécessaire.It's okay to send an empty body if none are needed.

ParamètreParameter TypeType DescriptionDescription
groupIdgroupId ChaîneString ID du groupe vers lequel copier.The id of the group to copy to. À utiliser uniquement lors de la copie vers un groupe Office 365.Use only when copying to an Office 365 group.
renommerasrenameAs ChaîneString Nom de la copie.The name of the copy. Par défaut, il s’agit du nom de l’élément existant.Defaults to the name of the existing item.

RéponseResponse

Si elle réussit, cette méthode 202 Accepted renvoie un code de Operation-Location réponse et un en-tête.If successful, this method returns a 202 Accepted response code and an Operation-Location header. Interrogez le point de terminaison Operation-location pour obtenir l’état de l’opération de copie.Poll the Operation-Location endpoint to get the status of the copy operation.

ExempleExample

Voici comment vous pouvez appeler cette API.Here is an example of how to call this API.

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

POST https://graph.microsoft.com/v1.0/me/onenote/notebooks/{id}/copyNotebook
Content-type: application/json
Content-length: 108

{
  "groupId": "groupId-value",
  "renameAs": "renameAs-value"
}
RéponseResponse

Voici un exemple de réponse.Here is an example of the response.

HTTP/1.1 202 Accepted