Erstellen und Verwalten von Containern

Gilt für: Entwickler

Erstellen und verwalten Sie Container, nachdem Ihr Containertyp erstellt, registriert und autorisiert wurde. Container sind die grundlegende Speichereinheit in SharePoint Embedded.

Schließen Sie die Konfiguration der Authentifizierung und Autorisierung ab, bevor Sie Container-APIs aufrufen.

Grundlegendes zu Containern

Alle SharePoint Embedded-Dateien und -Dokumente werden in Containern gespeichert.

Ein Container:

  • Gehört zu einem nutzenden Microsoft 365-Mandanten.
  • Verfügt über eine unveränderliche Containertyp-ID.
  • Speichert Inhalte für Ihre Anwendung.
  • Definiert eine Grenze für Mitgliedschaften und Berechtigungen.
  • Der Zugriff erfolgt über Microsoft Graph.

Eine Übersicht über die Architektur finden Sie unter SharePoint Embedded-App-Architektur.

Den Lebenszyklus kennen

Ein typischer Containerlebenszyklus umfasst Folgendes:

  1. Erstellen Sie einen Container.
  2. Mitglieder hinzufügen oder bestätigen.
  3. Hochladen und Verwalten von Dateien.
  4. Lesen oder Aktualisieren von Containermetadaten.
  5. Einen Container wiederverwenden, wenn er nicht mehr aktiv ist.
  6. Stellen Sie bei Bedarf einen wiederverwendeten Container wieder her.
  7. Dauerhaftes Löschen von Containern während der Bereinigung.

Fahren Sie mit Hochladen, Herunterladen und Verwalten von Dateien für Inhaltsvorgänge fort.

Voraussetzungen

Stellen Sie vor dem Erstellen von Containern Folgendes sicher:

  • Der Containertyp ist vorhanden.
  • Der Containertyp wird im verbrauchenden Mandanten registriert.
  • Die App verfügt über die Zustimmung von Microsoft Graph FileStorageContainer.Selected .
  • Die App verfügt über Containertypberechtigungen für den Vorgang.
  • Bei delegierten Aufrufen kann der angemeldete Benutzer die erforderliche Containerrolle erhalten.
  • Für Testcontainertypen befinden Sie sich innerhalb der Testgrenzwerte.

Wichtig

Testcontainertypen können bis zu fünf Container erstellen, einschließlich aktiver Container und Container im Papierkorb.

Auswählen der delegierten oder reinen App-Erstellung

Verwenden Sie delegierten Zugriff, wenn ein Benutzer die Erstellung initiiert, der Benutzer verantwortlich sein sollte oder der erstellende Benutzer zum Containerbesitzer wird.

Verwenden Sie nur app-Zugriff, wenn ein Dienst Container bereitstellt, kein Benutzer vorhanden ist und die App über die Berechtigung zum Erstellen von Containern verfügt.

Hinweis

Einem Benutzer, der einen neuen Container über delegierte Aufrufe erstellt, wird automatisch die Rolle Besitzer zugewiesen.

Erstellen eines Containers

Verwenden Sie Microsoft Graph, um einen Dateispeichercontainer für Ihren registrierten Containertyp zu erstellen.

Informationen zum kanonischen API-Shape finden Sie unter Erstellen von fileStorageContainer.

Implementierungsschritte:

  1. Abrufen eines gültigen Microsoft Graph-Tokens.
  2. Fügen Sie die für die API erforderlichen Zielcontainertypinformationen ein.
  3. Senden Sie die Erstellungsanforderung.
  4. Speichern Sie die zurückgegebene Container-ID.
  5. Speichern Von Anzeigemetadaten, die Ihre App benötigt.
  6. Zuweisen oder Bestätigen der Mitgliedschaft für delegierte Szenarien.

Tipp

Speichern Sie die Container-ID in Ihrer Anwendungsdatenbank als dauerhafte Verknüpfung zwischen Ihrem Geschäftsobjekt und dem SharePoint Embedded-Container.

Erstellen eines Containers in Visual Studio Code

Für die Testentwicklung kann die Visual Studio Code-Erweiterung Container erstellen.

  1. Öffnen Sie die SharePoint Embedded-Ansicht.

  2. Erweitern Sie den Containertyp der registrierten Testversion.

  3. Klicken Sie mit der rechten Maustaste auf Container.

  4. Wählen Sie Container erstellen aus.

  5. Geben Sie einen Namen ein.

  6. Vergewissern Sie sich, dass der Container unter dem Containertyp angezeigt wird.

Informationen zum Erweiterungsflow finden Sie unter Schnellstart: Erstellen Ihrer ersten App mit VS Code .

Auflisten von Containern

Auflisten von Containern, um verfügbare Container anzuzeigen, die Bereitstellung zu überprüfen oder Wartung auszuführen.

Informationen zum kanonischen API-Shape finden Sie unter Auflisten von Containern.

Beim Auflisten von Containern:

  • Verwenden Sie den reinen App-Zugriff für Dienstinventurszenarien.
  • Verwenden Sie delegierten Zugriff nur, wenn der Benutzerkontext geeignet ist.
  • Verarbeiten von Paging.
  • Ordnen Sie Ergebnisse Ihren Anwendungsdaten zu.

Hinweis

Delegierte Listencontainer geben derzeit zurück 403 Forbidden , wenn der Benutzer nicht über ein OneDrive verfügt. Diese Abhängigkeit gilt nicht für Listenaufrufe nur für Apps.

Abrufen eines Containers

Rufen Sie einen Container ab, wenn Sie die neuesten Metadaten benötigen, bevor Sie handeln.

Verwenden Sie diesen Vorgang, um zu bestätigen, dass der Container vorhanden ist, um die Anzeigeeigenschaften zu lesen, den Containertyp zu überprüfen, den Status vor Dateivorgängen zu überprüfen und die Wiederherstellung zu bestätigen.

Verknüpfen Sie Implementierungen mit dem Ressourcentyp fileStorageContainer.

Aktualisieren von Containermetadaten

Aktualisieren Sie Metadaten, wenn sich unterstützte Eigenschaften ändern.

Vor dem Aktualisieren:

  1. Vergewissern Sie sich, dass die App über die Containertypberechtigung Write verfügt.
  2. Vergewissern Sie sich, dass der delegierte Benutzer über eine geeignete Rolle verfügt.
  3. Liest den aktuellen Containerstatus.
  4. Übernehmen Sie nur beabsichtigte Änderungen.
  5. Überprüfen Sie die Antwort.

Löschen oder Recyceln eines Containers

Verwenden Sie das Löschverhalten, wenn ein Container nicht mehr aktiv ist.

Vor dem Löschen:

  • Vergewissern Sie sich, dass der Aufrufer über die Berechtigung verfügt.
  • Vergewissern Sie sich, dass Ihre App über archivierte Geschäftsverweise verfügt.
  • Entscheiden Sie, ob der Container zuerst wiederverwendet werden soll.
  • Erläutern der Wiederherstellungsoptionen.

Die Visual Studio Code-Erweiterung enthält Wiederverwendungs- und Wiederherstellungsfunktionen für die Testentwicklung.

Wiederherstellen eines wiederverwendeten Containers

Ein Wiederherstellungsflow sollte Folgendes ausführen:

  1. Identifizieren Sie den wiederverwendeten Container.
  2. Vergewissern Sie sich, dass der Aufrufer über die Berechtigung verfügt.
  3. Stellen Sie den Container wieder her.
  4. Aktualisieren Sie den Anwendungsstatus.
  5. Vergewissern Sie sich, dass Dateien und Metadaten verfügbar sind.
  6. Benachrichtigen Sie den Benutzer.

Wichtig

Bei Testcontainertypen werden Container im Papierkorb weiterhin auf den Grenzwert von fünf Containern angerechnet.

Container endgültig löschen

Dauerhaftes Löschen nur dann, wenn Sie sicher sind, dass der Container nicht mehr benötigt wird.

Sie müssen alle Container eines Containertyps entfernen, einschließlich gelöschter Container, bevor Sie den Containertyp selbst löschen.

Verwenden Sie die dauerhafte Löschung für die Testbereinigung, das Entfernen von Testdaten, das Ausmustern eines Containertyps oder die Erfüllung von Lebenszyklusanforderungen.

Überprüfen von Lebenszyklusvorgängen

Erstellen sie einen Feuerprobe:

  1. Erstellen Sie einen Testcontainer.
  2. Rufen Sie sie nach ID ab.
  3. Listen Sie Container auf, und vergewissern Sie sich, dass sie angezeigt werden.
  4. Aktualisieren Sie einen unterstützten Metadatenwert.
  5. Laden Sie eine kleine Datei hoch.
  6. Den Container wiederverwenden oder löschen.
  7. Stellen Sie es wieder her, falls unterstützt.
  8. Löschen Sie sie während der Bereinigung endgültig.

Behandeln von Lebenszyklusproblemen

Problembeschreibung Prüfen
Fehler beim Erstellen Registrierung und Create Berechtigung.
Fehler beim delegierten Erstellen Verhalten der Benutzerzustimmung und Rollenzuweisung.
Liste schlägt für delegierten Benutzer fehl Im Authentifizierungsartikel erwähnte OneDrive-Abhängigkeit.
Fehler beim Löschen Delete Berechtigung und Rolle "Benutzerbesitzer".
Fehler beim Erstellen der Testversion Aktive und wiederverwendete Container haben möglicherweise den Grenzwert erreicht.
Fehler beim Löschen des Containertyps Alle aktiven und gelöschten Container müssen zuerst entfernt werden.

Nächste Schritte

Fügen Sie Dateivorgänge unter Hochladen, Herunterladen und Verwalten von Dateien hinzu.

  • Last updated on