Abschnitt: copytosectiongroupundsection: copyToSectionGroup

Namespace: Microsoft. Graph kopiert einen Abschnitt in eine bestimmte Abschnittsgruppe.Namespace: microsoft.graph Copies a section to a specific section group.

Bei Kopiervorgängen folgen Sie einem asynchronen Aufruf Muster: Rufen Sie zunächst die Copy-Aktion auf, und übernehmen Sie dann den Endpunkt des Vorgangs für das Ergebnis.For Copy operations, you follow an asynchronous calling pattern: First call the Copy action, and then poll the operation endpoint for the result.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Notes.Create, Notes.ReadWrite, Notes.ReadWrite.AllNotes.Create, Notes.ReadWrite, Notes.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Notes.Create, Notes.ReadWriteNotes.Create, Notes.ReadWrite
AnwendungApplication Notes.ReadWrite.AllNotes.ReadWrite.All

HTTP-AnforderungHTTP request

POST /me/onenote/sections/{id}/copyToSectionGroup
POST /users/{id | userPrincipalName}/onenote/sections/{id}/copyToSectionGroup
POST /groups/{id}/onenote/sections/{id}/copyToSectionGroup

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type stringstring application/json

AnforderungstextRequest body

Geben Sie im Anforderungstext ein JSON-Objekt mit den Parametern an, die der Vorgang benötigt.In the request body, provide a JSON object that contains the parameters that your operation needs.

ParameterParameter TypType BeschreibungDescription
groupIdgroupId ZeichenfolgeString Die ID der Gruppe, in die kopiert werden soll.The id of the group to copy to. Nur beim Kopieren in eine Office 365 Gruppe verwenden.Use only when copying to an Office 365 group.
idid StringString Erforderlich.Required. Die ID der Ziel Abschnittsgruppe.The id of the destination section group.
namens NamenrenameAs ZeichenfolgeString Der Name der Kopie.The name of the copy. Der Standardwert ist der Name des vorhandenen Elements.Defaults to the name of the existing item.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 202 Accepted werden der Antwortcode Operation-Location und eine Kopfzeile zurückgegeben.If successful, this method returns a 202 Accepted response code and an Operation-Location header. Fragt den Endpunkt des Vorgangs Standorts ab, um den Status des Kopiervorgangs abzurufen.Poll the Operation-Location endpoint to get the status of the copy operation.

BeispielExample

Nachfolgend sehen Sie ein Beispiel dafür, wie diese API aufgerufen wird.Here is an example of how to call this API.

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

POST https://graph.microsoft.com/v1.0/me/onenote/sections/{id}/copyToSectionGroup
Content-type: application/json
Content-length: 84

{
  "id": "id-value",
  "groupId": "groupId-value",
  "renameAs": "renameAs-value"
}
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response.

HTTP/1.1 202 Accepted