OneDrive-reference (forhåndsvisning)

Bemærkning

Funktionerne i denne artikel drives af standardledningsnettet, som bruger de faktureringsmuligheder beskrevet i Licensering for agenter drevet af standardledningsnettet. Lær, hvordan du får adgang til standardfunktioner i Access standardagenter og agentflows.

Vigtig

Dette er en prøveversionsfunktion.

• Microsoft udgiver prøveversionsfunktioner før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
• Prøveversionsfunktioner har begrænset funktionalitet og er ikke beregnet til produktionsbrug.
• Microsoft kan ændre navnene og parametrene for MCP-værktøjer i prøveversion. Undgå hardkodede afhængigheder. Microsoft vedligeholder scenariesupport.
• Prøveversionsfunktioner er underlagt Microsoft supplerende vilkår for anvendelse.

Oversigt

Server-ID	URL-adresse på lejerniveau	Vis navn	Beskrivelse
mcp_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	OneDrive	Værktøjer til OneDrive-operationer. Brug denne server til at administrere filer og mapper i brugerens personlige OneDrive. Alle filhandlinger begrænset til ≤5 MB.

Tilgængelige værktøjer

getOnedrive

Henter oplysninger om brugerens OneDrive, herunder drevmetadata, kvote og ejeroplysninger.

Der kræves ingen parametre.

getFolderChildrenInMyOnedrive

Optæller de øverste 20 filer og mapper (DriveItems), der er indeholdt i en angivet overordnet mappe i brugerens OneDrive.

Valgfrie parametre:

• parentFolderId: Id for den overordnede mappe, hvis filer og mapper du vil vise (standard: 'root')

findFileOrFolderInMyOnedrive

Finder en fil eller mappe (DriveItem) i brugerens OneDrive efter søgeforespørgsel. Denne metode er mere effektiv end at søge i alle tilgængelige filer, hvis du ved, at elementet er i brugerens OneDrive.

Påkrævede parametre:

• searchQuery: Søgeforespørgsel; kan være hele filnavnet eller det delvise filnavn

getFileOrFolderMetadataInMyOnedrive

Henter metadata for en fil eller mappe (DriveItem) fra brugerens OneDrive.

Påkrævede parametre:

• fileOrFolderId: Id for filen eller mappen i brugerens OneDrive

getFileOrFolderMetadataByUrl

Henter metadata for en fil eller mappe (DriveItem) fra en URL-adresse til deling. Det er kun brugere med eksisterende eksplicitte tilladelser til at få adgang til filen, der kan hente metadataene.

Påkrævede parametre:

• fileOrFolderUrl: URL-adressen til filen eller mappen. URL-adressen indløses ikke for at dele den med brugeren. de skal allerede have eksplicit adgang.

læsLilleTekstfilFraMinOneDrive

Læser (downloader) en tekstfil fra brugerens OneDrive.

Påkrævede parametre:

• fileId: Id for den fil (DriveItem), der skal læses eller downloades

createSmallTextFileInMyOnedrive

Opretter eller overfører en tekstfil, der er mindre end 5 MB, til brugerens OneDrive.

Påkrævede parametre:

• Filnavn: Navnet på den fil, der skal oprettes
• indholdTekst: Tekstindholdet af filen.

Valgfrie parametre:

• parentFolderId: ID for forældremappen (standard: 'root').

createFolderInMyOnedrive

Opretter en ny mappe (DriveItem) i brugerens OneDrive som underordnet til den angivne overordnede mappe. Hvis der allerede findes en mappe med samme navn, tilføjer metoden et numerisk suffiks (f.eks. NewFolder (1)).

Påkrævede parametre:

• folderName: Navnet på den mappe, der skal oprettes

Valgfrie parametre:

• parentFolderId: ID for forældremappen (standard: 'root').

renameFileOrFolderInMyOnedrive

Omdøber en fil eller mappe (DriveItem) i brugerens OneDrive. Det nye navn skal overholde navngivningskonventionerne.

Påkrævede parametre:

• fileOrFolderId: Id for den fil eller mappe, der skal omdøbes
• newFileOrFolderName: Det nye navn til filen eller mappen

Valgfrie parametre:

• Etag: ETag-værdi for samtidighedskontrol. Handlingen lykkes kun, hvis DriveItems aktuelle ETag stemmer overens

deleteFileOrFolderInMyOnedrive

Sletter en fil eller mappe (DriveItem) fra brugerens OneDrive.

Påkrævede parametre:

• fileOrFolderId: Id for den fil eller mappe, der skal slettes

Valgfrie parametre:

• Etag: ETag-værdi for samtidighedskontrol

Del fil eller mappe i mit OneDrive

Sender en invitation til deling for at give læse- eller skrivetilladelser til en fil eller mappe (DriveItem) i brugerens OneDrive.

Påkrævede parametre:

• fileOrFolderId: Id for den fil eller mappe, der skal deles
• recipientEmails: Matrix af mailadresser på modtagere, der skal inviteres
• Roller: Matrix af roller, der skal tildeles. Accepterede værdier: 'read', 'write' (skriv giver både læse- og skriveadgang)

Valgfrie parametre:

• Besked: Brugerdefineret meddelelse, der skal medtages i invitationsmailen. Standard: 'Her er den fil, vi samarbejder om.'
• sendInvitation: Om du vil sende en invitation til deling. Standard: true.

Angiv følsomhedsmærkat på fil i mit OneDrive

Angiver følsomhedsmærkaten for en fil i brugerens OneDrive.

Påkrævede parametre:

• fileId: ID på filen (DriveItem)
• sensitivityLabelId: Id'et for den følsomhedsmærkat, der skal tildeles, eller en tom streng, der skal fjernes

Valgfrie parametre:

• assignmentMethod: Tildelingsmetode: 'standard', 'privilegeret', 'auto' eller 'unknownFutureValue' (standard: 'privilegeret')
• justeringTekst: Begrundelsestekst til revisionsformål. påkrævet ved nedgradering eller fjernelse af en etiket (standard: 'Ændret af MCPServer')

createSmallBinaryFileInMyOnedrive

Opretter en binær fil af en størrelse på mindre end 5 MB ved at base64-kode indholdet til brugerens OneDrive.

Påkrævede parametre:

• Filnavn: Navnet på den fil, der skal oprettes, herunder filtypenavnet
• base64Content: Det binære filindhold kodet som en base64-streng

Valgfrie parametre:

• parentFolderId: ID for forældremappen (standard: 'root').

readSmallBinaryFileFromMyOnedrive

Læser en binær fil, der er mindre end 5 MB, fra brugerens OneDrive. Returnerer filindholdet som en base64-kodet streng.

Påkrævede parametre:

• fileId: Id for den fil (DriveItem), der skal læses eller downloades

kopierFilEllerMappeIMinOneDrive

Kopierer en fil eller mappe (DriveItem) til en destinationsmappe i brugerens OneDrive. Denne handling er asynkron. Bruges checkOperationStatusInMyOnedrive til at overvåge status.

Påkrævede parametre:

• sourcefileid: Id for den kildefil eller mappe (DriveItem), der skal kopieres
• destfolderid: Id for destinationsmappen (skal findes i brugerens OneDrive)

Valgfrie parametre:

• newfilename: Nyt navn på det kopierede element (standard er det oprindelige navn)

moveFileOrFolderInMyOnedrive

Flytter en fil eller mappe (DriveItem) til en destinationsmappe i brugerens OneDrive. Denne handling er asynkron. Bruges checkOperationStatusInMyOnedrive til at overvåge status.

Påkrævede parametre:

• sourcefileid: Id for den kildefil eller mappe (DriveItem), der skal flyttes
• destfolderid: Id for destinationsmappen (skal findes i brugerens OneDrive)

Valgfrie parametre:

• newfilename: Nyt navn for det flyttede element (standard er det oprindelige navn)

checkOperationStatusInMyOnedrive

Kontrollerer status for en asynkron handling, f.eks. kopiér eller flyt, ved hjælp af det handlingstoken, der returneres fra den oprindelige handling. Returnerer statusoplysninger, hvis de stadig er i gang, fejloplysninger, hvis de mislykkes, eller de endelige metadata for filer eller mapper, hvis de er fuldført.

Påkrævede parametre:

• operationToken: Det handlingstoken, der returneres fra en asynkron handling som copyFileOrFolderInMyOnedrive eller moveFileOrFolderInMyOnedrive

Vigtige funktioner

administration af OneDrive

• Henter OneDrive oplysninger, f.eks. kvote og ejer
• Få adgang til brugerens personlige OneDrive
• Alle handlinger er målrettet den godkendte brugers OneDrive

Filsøgning og -søgning

• Søg efter filer og mapper efter navn i brugerens OneDrive
• Hent fil- eller mappemetadata efter id eller URL-adresse til deling
• Gennemse mappens indhold (op til 20 elementer).

Filhandlinger

• Opret tekst og binære filer (≤5 MB)
• Læs tekst og binære filer (≤5 MB)
• Slet filer med samtidighedskontrol
• Omdøb filer med eTag-beskyttelse
• Kopiér og flyt filer og mapper asynkront

Mappeadministration

• Opret mapper med valgfrie overordnede stier
• Automatisk numerisk endelse for dublerede mappenavne.
• Vis mappeindhold (op til 20 elementer)
• Hent mappemetadata
• Slet mapper med samtidighedskontrol
• Omdøb mapper med eTag-beskyttelse

Deling og tilladelser

• Del filer og mapper med brugere
• Rollebaseret adgangskontrol (læse, skrive)
• E-mail-notifikationer til deling.
• Brugerdefinerede beskeder i invitationer.

Sikkerhed og overholdelse af angivne standarder

• Anvend og fjern følsomhedsmærkater.
• Brug flere tildelingsmetoder, herunder standard, privilegerede og automatiske.
• Understøtter revisionsberettigelse.
• Brug samtidighedskontrol med eTags.

Bemærkninger

• Alle handlinger er målrettet den godkendte brugers personlige OneDrive.
• Filhandlinger er begrænset til filer, der er 5 MB eller mindre til overførsel og download.
• Handlinger til sletning og omdøbning understøtter eTags for samtidighedskontrol.
• Deling kræver gyldige mailadresser og relevante tilladelser.
• Følsomhedsmærkater kræver korrekt licens og konfiguration.
• Mappelisten returnerer som standard maksimalt 20 elementer.