OneDrive-referanse (forhåndsvisning)

Oversikt

Tilgjengelige verktøy

getOnedrive

Henter informasjon om brukerens OneDrive, inkludert stasjonsmetadata, kvote og eierinformasjon.

Ingen parametere kreves.

getFolderChildrenInMyOnedrive

Nummererer de 20 mest populære filene og mappene (DriveItems) i en angitt overordnet mappe i brukerens OneDrive.

Valgfrie parametere:

• parentFolderId: ID for den overordnede mappen med filer og mapper du vil vise (standard: 'rot')

findFileOrFolderInMyOnedrive

Finner en fil eller mappe (DriveItem) i brukerens OneDrive etter søkespørring. Denne metoden er mer effektiv enn å søke i alle tilgjengelige filer hvis du vet at elementet er i brukerens OneDrive.

Obligatoriske parametere:

• searchQuery: Søkespørring; kan være hele eller deler av filnavnet

getFileOrFolderMetadataInMyOnedrive

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

Obligatoriske parametere:

• fileOrFolderId:-ID for filen eller mappen i brukerens OneDrive

getFileOrFolderMetadataByUrl

Henter metadata for en fil eller mappe (DriveItem) fra en url-adresse for deling. Bare brukere med eksisterende eksplisitte tillatelser til å få tilgang til filen, kan få metadataene.

Obligatoriske parametere:

• fileOrFolderUrl: URL-adressen til filen eller mappen. URL-adressen er ikke løst inn for å dele den med brukeren. de må allerede ha eksplisitt tilgang.

lesLitenTekstfilFraMinOneDrive

Leser (laster ned) en tekstfil fra brukerens OneDrive.

Obligatoriske parametere:

• fileId: ID for filen (DriveItem) som skal leses eller lastes ned

createSmallTextFileInMyOnedrive

Oppretter eller laster opp en tekstfil som er mindre enn 5 MB, til brukerens OneDrive.

Obligatoriske parametere:

• Filnavn: Navnet på filen som skal opprettes
• innholdTekst: Tekstinnholdet i filen.

Valgfrie parametere:

• parentFolderId: ID for foreldremappen (standard: 'root').

createFolderInMyOnedrive

Oppretter en ny mappe (DriveItem) i brukerens OneDrive som underordnet den angitte overordnede mappen. Hvis en mappe med samme navn allerede finnes, legger metoden til et numerisk suffiks (for eksempel NewFolder (1)).

Obligatoriske parametere:

• Mappenavn: Navnet på mappen som skal opprettes

Valgfrie parametere:

• parentFolderId: ID for foreldremappen (standard: 'root').

renameFileOrFolderInMyOnedrive

Gir nytt navn til en fil eller mappe (DriveItem) i brukerens OneDrive. Det nye navnet må være i samsvar med navnekonvensjoner.

Obligatoriske parametere:

• fileOrFolderId: ID for filen eller mappen for å gi nytt navn
• newFileOrFolderName: Det nye navnet på filen eller mappen

Valgfrie parametere:

• Etag: ETag-verdi for samtidighetskontroll. Operasjonen lykkes bare hvis DriveItems gjeldende ETag samsvarer

slettFilEllerMappeIMinOneDrive

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

Obligatoriske parametere:

• fileOrFolderId: ID for filen eller mappen som skal slettes

Valgfrie parametere:

• Etag: ETag-verdi for samtidighetskontroll

shareFileOrFolderInMyOnedrive

Sender en delingsinvitasjon for å gi lese- eller skrivetillatelser for en fil eller mappe (DriveItem) i brukerens OneDrive.

Obligatoriske parametere:

• fileOrFolderId: ID for filen eller mappen som skal deles
• recipientEmails: Matrise med e-postadresser til mottakere som skal inviteres
• Roller: Matrise med roller som skal tilordnes. Godtatte verdier: «lese», «skrive» (skrive gir både lese- og skrivetilgang)

Valgfrie parametere:

• Melding: Egendefinert melding som skal inkluderes i invitasjons-e-postmeldingen. Standard: «Her er filen vi samarbeider om.»
• sendInvitation: Om du vil sende en delingsinvitasjon. Standard: sann.

angiFølsomhetsetikettPåFilIMinOneDrive

Angir følsomhetsetiketten for en fil i brukerens OneDrive.

Obligatoriske parametere:

• fileId: ID-en til filen (DriveItem)
• sensitivityLabelId: ID for følsomhetsetiketten som skal tilordnes, eller tom streng som skal fjernes

Valgfrie parametere:

• assignmentMethod: Tildelingsmetode: standard, privilegert, auto eller ukjentFutureValue (standard: Privilegert)
• justificationText: Justeringstekst for overvåkingsformål; kreves når du nedgraderer eller fjerner en etikett (standard: «Endret av MCPServer»)

opprettLitenBinærFilIMinOneDrive

Oppretter en binær fil med størrelse mindre enn 5 MB ved å basere 64 koding av innholdet til brukerens OneDrive.

Obligatoriske parametere:

• Filnavn: Navnet på filen som skal opprettes, inkludert filtypen
• base64Content: Det binære filinnholdet kodet som en base64-streng

Valgfrie parametere:

• parentFolderId: ID for foreldremappen (standard: 'root').

readSmallBinaryFileFromMyOneDrive

Leser en binærfil som er mindre enn 5 MB fra brukerens OneDrive. Returnerer filinnholdet som en base64-kodet streng.

Obligatoriske parametere:

• fileId: ID for filen (DriveItem) som skal leses eller lastes ned

kopierFilEllerMappeIMinOneDrive

Kopierer en fil eller mappe (DriveItem) til en målmappe i brukerens OneDrive. Denne operasjonen er asynkron. Brukes checkOperationStatusInMyOnedrive til å overvåke fremdriften.

Obligatoriske parametere:

• sourcefileid: ID for kildefilen eller mappen (DriveItem) som skal kopieres
• destfolderid:-ID for målmappen (må finnes i brukerens OneDrive)

Valgfrie parametere:

• newfilename: Nytt navn for det kopierte elementet (standard til det opprinnelige navnet)

moveFileOrFolderInMyOnedrive

Flytter en fil eller mappe (DriveItem) til en målmappe i brukerens OneDrive. Denne operasjonen er asynkron. Brukes checkOperationStatusInMyOnedrive til å overvåke fremdriften.

Obligatoriske parametere:

• sourcefileid: ID for kildefilen eller mappen (DriveItem) som skal flyttes
• destfolderid:-ID for målmappen (må finnes i brukerens OneDrive)

Valgfrie parametere:

• newfilename: Nytt navn for det flyttede elementet (standard til det opprinnelige navnet)

checkOperationStatusInMyOnedrive

Kontrollerer statusen for en asynkron operasjon, for eksempel kopier eller flytt, ved hjelp av operasjonstokenet som returneres fra den opprinnelige operasjonen. Returnerer fremdriftsinformasjon hvis den fortsatt pågår, feildetaljer hvis den mislyktes, eller den endelige filen eller mappemetadataene hvis den er fullført.

Obligatoriske parametere:

• operationToken: Operasjonstokenet som returneres fra en asynkron operasjon, for eksempel copyFileOrFolderInMyOnedrivemoveFileOrFolderInMyOnedrive

Nøkkelfunksjoner

OneDrive administrasjon

• Henter OneDrive informasjon, for eksempel kvote og eier
• Få tilgang til brukerens personlige OneDrive
• Alle operasjoner retter seg mot den autentiserte brukerens OneDrive

Filsøk og oppdagelse

• Søk i filer og mapper etter navn i brukerens OneDrive
• Hent fil- eller mappemetadata etter ID eller url-adresse for deling
• Bla gjennom mappens innhold (opptil 20 elementer).

Filoperasjoner

• Opprette tekst- og binærfiler (≤5 MB)
• Lese tekst og binærfiler (≤5 MB)
• Slette filer med samtidighetskontroll
• Gi nytt navn til filer med beskyttelse mot eTag
• Kopiere og flytte filer og mapper asynkront

Mappebehandling

• Opprette mapper med valgfrie overordnede baner
• Automatisk numerisk suffiks for dupliserte mappenavn.
• Listemappeinnhold (opptil 20 elementer)
• Hent mappemetadata
• Slette mapper med samtidighetskontroll
• Gi nytt navn til mapper med eTag-beskyttelse

Deling og tillatelser

• Dele filer og mapper med brukere
• Rollebasert tilgangskontroll (lese, skrive)
• E-postvarsler ved deling.
• Egendefinerte meldinger i invitasjoner.

Sikkerhet og samsvar

• Bruk og fjern følsomhetsetiketter.
• Bruk flere tildelingsmetoder, inkludert standard, privilegert og automatisk.
• Støtt revisjonsbegrunnelse.
• Bruk samtidighetskontroll med eTags.

Notater

• Alle operasjoner er rettet mot den godkjente brukerens personlige OneDrive.
• Filoperasjoner er begrenset til filer som er 5 MB eller mindre for opplasting og nedlasting.
• Slett og gi nytt navn til operasjoner støtter eTags for samtidighetskontroll.
• Deling krever gyldige e-postadresser og riktige tillatelser.
• Følsomhetsetiketter krever riktig lisensiering og konfigurasjon.
• Mappeoppføring returnerer maksimalt 20 elementer som standard.