OneDrive-referentie (preview)

Note

De functies in dit artikel worden aangedreven door de standaard kabelboom, die gebruikmaakt van de factureringsopties zoals beschreven in Licensing voor agenten die door de standaardkabelboom worden aangestuurd. Leer hoe je standaardfuncties kunt openen in Access standaard agents en agentstromen.

Important

Dit is een preview-functie.

• Microsoft brengt previewfuncties uit vóór een officiële release, zodat klanten vroegtijdig toegang kunnen krijgen en feedback kunnen geven.
• Preview-functies hebben beperkte functionaliteit en zijn niet bedoeld voor productiegebruik.
• Microsoft kan de namen en parameters van het MCP-hulpprogramma preview wijzigen. Vermijd in code vastgelegde afhankelijkheden. Microsoft ondersteuning voor scenario's onderhoudt.
• Preview-functies zijn onderhevig aan Microsoft aanvullende gebruiksvoorwaarden.

Overview

Server-ID	URL op tenantniveau	weergavenaam	Description
mcp_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	OneDrive	Tools voor OneDrive-operaties. Gebruik deze server voor het beheren van bestanden en mappen in de persoonlijke OneDrive van de gebruiker. Alle bestandsbewerkingen zijn beperkt tot ≤5 MB.

Beschikbare hulpmiddelen

getOnedrive

Haalt informatie op over de OneDrive van de gebruiker, inclusief metagegevens van stations, quota en eigenaargegevens.

Er zijn geen parameters vereist.

getFolderChildrenInMyOnedrive

Geeft een opsomming van de eerste 20 bestanden en mappen (DriveItems) die zich bevinden in een opgegeven bovenliggende map in de OneDrive van de gebruiker.

Optionele parameters:

• parentFolderId: Id van de bovenliggende map waarvan u de bestanden en mappen wilt vermelden (standaard: 'root')

findFileOrFolderInMyOnedrive

Zoekt een bestand of map (DriveItem) in de OneDrive van de gebruiker op zoekquery. Deze methode is efficiënter dan het doorzoeken van alle toegankelijke bestanden als u weet dat het item zich in de OneDrive van de gebruiker bevindt.

Vereiste parameters:

• searchQuery: Zoekquery; kan de volledige of gedeeltelijke bestandsnaam zijn

getFileOrFolderMetadataInMyOnedrive

Hiermee worden metagegevens van een bestand of map (DriveItem) opgehaald uit de OneDrive van de gebruiker.

Vereiste parameters:

• fileOrFolderId:-id van het bestand of de map in de OneDrive van de gebruiker

getFileOrFolderMetadataByUrl

Hiermee haalt u metagegevens van een bestand of map (DriveItem) op uit een URL voor delen. Alleen gebruikers met bestaande expliciete machtigingen voor toegang tot het bestand kunnen de metagegevens ophalen.

Vereiste parameters:

• fileOrFolderUrl: URL van het bestand of de map. De URL wordt niet ingewisseld om deze te delen met de gebruiker; ze moeten al expliciete toegang hebben.

readSmallTextFileFromMyOnedrive

Leest (downloadt) een tekstbestand uit de OneDrive van de gebruiker.

Vereiste parameters:

• fileId: Id van het bestand (DriveItem) dat moet worden gelezen of gedownload

maakKleinTekstbestandInMijnOneDrive

Hiermee maakt of uploadt u een tekstbestand dat kleiner is dan 5 MB naar de OneDrive van de gebruiker.

Vereiste parameters:

• Bestandsnaam: Naam van het te maken bestand
• inhoudTekst: Tekstinhoud van het bestand.

Optionele parameters:

• parentFolderId: ID van de oudermap (standaard: 'root').

createFolderInMyOnedrive

Hiermee maakt u een nieuwe map (DriveItem) in de OneDrive van de gebruiker als onderliggend element van de opgegeven bovenliggende map. Als er al een map met dezelfde naam bestaat, voegt de methode een numeriek achtervoegsel toe (bijvoorbeeld NewFolder (1)).

Vereiste parameters:

• Mapnaam: Naam van de map die moet worden gemaakt

Optionele parameters:

• parentFolderId: ID van de oudermap (standaard: 'root').

renameFileOrFolderInMyOnedrive

Wijzigt de naam van een bestand of map (DriveItem) in de OneDrive van de gebruiker. De nieuwe naam moet voldoen aan naamconventies.

Vereiste parameters:

• fileOrFolderId: Id van het bestand of de map waarvan u de naam wilt wijzigen
• newFileOrFolderName: De nieuwe naam voor het bestand of de map

Optionele parameters:

• etag: ETag-waarde voor gelijktijdigheidsbeheer. De bewerking slaagt alleen als de huidige ETag van driveItem overeenkomt

deleteFileOrFolderInMyOnedrive

Hiermee verwijdert u een bestand of map (DriveItem) uit de OneDrive van de gebruiker.

Vereiste parameters:

• fileOrFolderId: Id van het bestand of de map die u wilt verwijderen

Optionele parameters:

• etag: ETag-waarde voor gelijktijdigheidsbeheer

shareFileOrFolderInMyOnedrive

Hiermee wordt een deeluitnodiging verzonden om lees- of schrijfrechten te verlenen voor een bestand of map (DriveItem) in de OneDrive van een gebruiker.

Vereiste parameters:

• fileOrFolderId: Id van het bestand of de map die moet worden gedeeld
• recipientEmails: Matrix met e-mailadressen van geadresseerden die moeten worden uitgenodigd
• Rollen: Matrix met rollen die moeten worden toegewezen. Geaccepteerde waarden: 'lezen', 'schrijven' (schrijven verleent zowel lezen als schrijven)

Optionele parameters:

• Bericht: Aangepast bericht dat moet worden opgenomen in de uitnodigings-e-mail. Standaard: 'Hier is het bestand waar we aan samenwerken.'
• sendInvitation: Of u een uitnodiging voor delen wilt verzenden. Standaard: waar.

Gevoeligheidslabel instellen op bestand in mijn OneDrive

Hiermee stelt u het vertrouwelijkheidslabel van een bestand in de OneDrive van de gebruiker in.

Vereiste parameters:

• fileId: Id van het bestand (DriveItem)
• sensitivityLabelId: Id van het vertrouwelijkheidslabel dat moet worden toegewezen of een lege tekenreeks die moet worden verwijderd

Optionele parameters:

• assignmentMethod: Toewijzingsmethode: 'standard', 'privileged', 'auto' of 'unknownFutureValue' (standaardwaarde: 'privileged')
• justificationText: Redentekst voor controledoeleinden; vereist bij het downgraden of verwijderen van een label (standaard: 'Gewijzigd door MCPServer')

createSmallBinaryFileInMyOnedrive

Hiermee maakt u een binair bestand van minder dan 5 MB door base64-codering van de inhoud naar de OneDrive van de gebruiker.

Vereiste parameters:

• Bestandsnaam: Naam van het bestand dat moet worden gemaakt, inclusief de bestandsextensie
• base64Content: De binaire bestandsinhoud die is gecodeerd als een base64-tekenreeks

Optionele parameters:

• parentFolderId: ID van de oudermap (standaard: 'root').

readSmallBinaryFileFromMyOnedrive

Leest een binair bestand dat kleiner is dan 5 MB uit de OneDrive van de gebruiker. Retourneert de bestandsinhoud als een met base64 gecodeerde tekenreeks.

Vereiste parameters:

• fileId: Id van het bestand (DriveItem) dat moet worden gelezen of gedownload

copyFileOrFolderInMyOnedrive

Kopieert een bestand of map (DriveItem) naar een doelmap binnen de OneDrive van de gebruiker. Deze bewerking is asynchroon. Gebruik checkOperationStatusInMyOnedrive dit om de voortgang te controleren.

Vereiste parameters:

• sourcefileid: Id van het bronbestand of de bronmap (DriveItem) die u wilt kopiëren
• destfolderid:-id van de doelmap (moet aanwezig zijn in de OneDrive van de gebruiker)

Optionele parameters:

• newfilename: Nieuwe naam voor het gekopieerde item (standaard ingesteld op de oorspronkelijke naam)

moveFileOrFolderInMyOnedrive

Hiermee verplaatst u een bestand of map (DriveItem) naar een doelmap binnen de OneDrive van de gebruiker. Deze bewerking is asynchroon. Gebruik checkOperationStatusInMyOnedrive dit om de voortgang te controleren.

Vereiste parameters:

• sourcefileid: Id van het bronbestand of de bronmap (DriveItem) die u wilt verplaatsen
• destfolderid:-id van de doelmap (moet aanwezig zijn in de OneDrive van de gebruiker)

Optionele parameters:

• newfilename: Nieuwe naam voor het verplaatste item (standaard ingesteld op de oorspronkelijke naam)

checkOperationStatusInMyOnedrive

Controleert de status van een asynchrone bewerking, zoals kopiëren of verplaatsen, met behulp van het bewerkingstoken dat is geretourneerd door de oorspronkelijke bewerking. Retourneert voortgangsgegevens als deze nog steeds worden uitgevoerd, foutdetails als dit is mislukt of het uiteindelijke bestand of de uiteindelijke metagegevens van de map als dit is voltooid.

Vereiste parameters:

• operationToken: Het bewerkingstoken dat wordt geretourneerd door een asynchrone bewerking, zoals copyFileOrFolderInMyOnedrive of moveFileOrFolderInMyOnedrive

Belangrijkste kenmerken

beheer van OneDrive

• Haalt OneDrive informatie op, zoals quotum en eigenaar
• Toegang tot de persoonlijke OneDrive van de gebruiker
• Alle bewerkingen zijn gericht op geverifieerde gebruikers OneDrive

Zoeken en detecteren van bestanden

• Bestanden en mappen zoeken op naam binnen de OneDrive van de gebruiker
• Bestands- of mapmetagegevens ophalen op basis van ID of deel-URL
• Blader door de inhoud van de map (tot 20 items).

Bestandsbewerkingen

• Tekst- en binaire bestanden maken (≤5 MB)
• Tekst- en binaire bestanden lezen (≤5 MB)
• Bestanden verwijderen met gelijktijdigheidscontrole
• De naam van bestanden wijzigen met eTag-beveiliging
• Bestanden en mappen asynchroon kopiëren en verplaatsen

Mapbeheer

• Mappen maken met optionele ouderpaden
• Automatische numerieke achtervoegsel voor dubbele mapnamen.
• Inhoud van de lijstmap (maximaal 20 items)
• Metagegevens van map ophalen
• Mappen verwijderen met concurrencybeheer
• De naam van mappen wijzigen met eTag-beveiliging

Delen en machtigingen

• Bestanden en mappen delen met gebruikers
• Op rollen gebaseerd toegangsbeheer (lezen, schrijven)
• E-mailmeldingen voor het delen.
• Aangepaste berichten in uitnodigingen.

Beveiliging en naleving

• Vertrouwelijkheidslabels toepassen en verwijderen.
• Gebruik meerdere toewijzingsmethoden, waaronder standaard, bevoegd en automatisch.
• Ondersteuning voor auditverantwoording.
• Gelijktijdigheidsbeheer gebruiken met eTags.

Aantekeningen

• Alle bewerkingen richten zich op de persoonlijke OneDrive van de geverifieerde gebruiker.
• Bestandsbewerkingen zijn beperkt tot bestanden van 5 MB of minder voor uploaden en downloaden.
• Verwijder- en hernoembewerkingen ondersteunen eTags voor concurrencybeheer.
• Voor delen zijn geldige e-mailadressen en de juiste machtigingen vereist.
• Voor vertrouwelijkheidslabels zijn de juiste licenties en configuratie vereist.
• De mapinhoud geeft standaard maximaal 20 items weer.