Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Der Basistyp für verschiedene Arten von Anlagen in einem Benutzer-, Nachrichten-, Aufgaben- oder Gruppenbeitrag, der als Basisressource für die folgenden abgeleiteten Anlagentypen dient:
- Datei (fileAttachment-Ressource)
- Ein Element (Kontakt, Ereignis oder Nachricht, dargestellt durch eine itemAttachment-Ressource )
- Link zu einer Datei (referenceAttachment-Ressource)
Sie können verwandte Inhalte zu einem Benutzerereignis, einer Nachricht, einer Outlook-Aufgabe oder einem Gruppenbeitrag in Form einer Anlage hinzufügen.
Achtung
Outlook-Aufgaben sind veraltet und geben seit dem 10. August 2022 keine Daten mehr zurück. Aktualisieren Sie vorhandene Apps, die dieses Feature mit Outlook-Aufgaben verwenden.
In Gruppenkalendern werden Anlagen zu Ereignissen nicht unterstützt.
Outlook-Aufgaben unterstützen keine Referenzanlagen.
Hinweis: Wenn Sie eine Datei an einen Gruppenbeitrag oder ein Element an ein Ereignis, eine Nachricht oder einen Gruppenbeitrag anfügen, begrenzen Sie die Größe der Anlage auf 3 MB.
Wenn Sie eine Datei unter 3 MB anfügen, können Sie die Dateianlage einem Benutzerereignis, einer Nachricht oder einem Gruppenbeitrag hinzufügen.
Wenn Sie eine Datei zwischen 3 MB und 150 MB an ein Ereignis oder eine Nachricht anfügen, können Sie eine Uploadsitzung erstellen und iterativ Bereiche der Datei hochladen, um sie anzufügen. Ein Beispiel finden Sie unter Anfügen von großen Dateien an Outlook-Nachrichten .
Methoden
Die folgenden Methoden gelten für alle abgeleiteten Typen von Anlagen (fileAttachment, itemAttachment oder referenceAttachment).
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Get | attachment | Lesen Sie die Eigenschaften, Beziehungen oder unformatierten Inhalte einer Anlage, die an ein Benutzerereignis, eine Nachricht, eine Outlook-Aufgabe oder einen Beitrag angefügt ist. |
| Löschen | Keine | Löschen Sie eine Anlage zu einem Ereignis, einer Nachricht, einer Outlook-Aufgabe oder einem Beitrag. |
| Anlage zu einem Benutzerereignis hinzufügen | attachment | Dient dem Hinzufügen einer Datei, eines Elements oder einer verknüpften Anlage zu einem Ereignis in dem Kalender eines Benutzers. Dadurch wird die Größe der Anlage, die Sie hinzufügen können, auf unter 3 MB begrenzt. |
| Anlagen einer Nachricht hinzufügen | attachment | Dient dem Hinzufügen einer Datei, eines Elements oder einer verknüpften Anlage zu einer Nachricht. Dadurch wird die Größe der Anlage, die Sie hinzufügen können, auf unter 3 MB begrenzt. |
| Erstellen einer Sitzung zum Anfügen einer großen Datei | uploadSession | Erstellen Sie eine Uploadsitzung, die es einer App ermöglicht, Bereiche einer Datei iterativ hochzuladen, um die Datei an die angegebene Nachricht oder das angegebene Ereignis anzufügen. Die Dateigröße muss zwischen 3 MB und 150 MB betragen. |
| Hinzufügen einer Anlage zu einer Outlook-Aufgabe (veraltet) | attachment | Fügen Sie einer Outlook-Aufgabe eine Anlage einer Datei oder eines Elements hinzu. |
| Anlage einem Beitrag hinzufügen | attachment | Fügen Sie einem Gruppenbeitrag eine Datei-, Element- oder Linkanlage hinzu. Dadurch wird die Größe der Anlage, die Sie hinzufügen können, auf unter 3 MB begrenzt. |
| Anlagen eines Benutzerereignisses auflisten | attachment collection | Liste der Anlagen für ein Ereignis in einem Benutzerkalender abrufen. |
| Anlagen einer Nachricht auflisten | attachment collection | Liste der Anlagen für eine Nachricht abrufen |
| Auflisten von Anlagen einer Outlook-Aufgabe (veraltet) | attachment-Sammlung | Abrufen einer Liste von Anlagen für eine Outlook-Aufgabe. |
| Anlagen eines Beitrags auflisten | attachment collection | Liste der Anlagen für einen Beitrag abrufen |
Eigenschaften
Nachfolgend finden Sie die grundlegenden Eigenschaften von attachment-Ressourcen. Zusätzliche Eigenschaften finden Sie bei dem jeweiligen Anlagentyp (fileAttachment, itemAttachment oder referenceAttachment).
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| contentType | String | Der MIME-Typ. |
| id | Zeichenfolge | Schreibgeschützt. |
| isInline | Boolean |
true, wenn die Anlage eine Inlineanlage ist, andernfalls false. |
| lastModifiedDateTime | DateTimeOffset | Der Typ „Zeitstempel“ stellt die Datums- und Uhrzeitinformationen im Format der ISO 8601 dar und gibt immer die UTC an. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z |
| name | String | Der Anzeigename der Anlage. Dies muss nicht der tatsächliche Dateiname sein. |
| size | Int32 | Die Länge der Anlage in Byte. |
Beziehungen
Keine
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"contentType": "string",
"id": "string (identifier)",
"isInline": true,
"lastModifiedDateTime": "String (timestamp)",
"name": "string",
"size": 1024
}