Vorgänge für die FileShare-Ressource

Die FileShare Ressource stellt eine Verwaltungsschnittstelle für die Azure-Dateifreigabe bereit, mit der Sie den Dateifreigabenamen, das aktivierte Protokoll, die zugewiesene Größe ("Kontingent") usw. steuern können. Die FileShare Ressource ist ein untergeordnetes Element der FileService Ressource, und ein Speicherkonto kann eine unendliche Anzahl von Dateifreigaben enthalten, abhängig von den Ressourcenlimits des Speicherkontos.

Sie können mit Ressourcen auf FileShare zwei Arten interagieren:

  • (Empfohlen) Der Speicherressourcenanbieter (Microsoft.Storage), der eine API auf Steuerungsebene bereitstellt, die über Azure Resource Manager verwaltet werden kann.
  • (Legacy) Die FileREST-API, die zusätzliche HTTPS-Endpunkte zum Verwalten FileSharesvon bereitstellt.

Sofern sie keinen bestimmten Grund haben, sollten Sie die API auf Steuerungsebene (den Speicherressourcenanbieter) für alle Verwaltungsaktivitäten verwenden. Zu verwaltende FileShares APIs werden aus älteren Gründen über die Datenebene verfügbar gemacht. ApIs auf Datenebene, die Verwaltungsaktionen ausführen, werden unter den folgenden Umständen vollständig unterstützt und für die Verwendung akzeptabel:

  • Sie verfügen über eine Legacyanwendung oder einen älteren Dienst, der diese APIs bereits verwendet.
  • Sie haben sehr hohe Skalierungsanforderungen. Die steuerungs-API, die vom Speicherressourcenanbieter bereitgestellt wird, hat viel geringere Skalierungsgarantien als die FileREST-API.

Neue Parameter und Aktionen auf dem FileService werden möglicherweise nicht zu den REST-SDKs auf Datenebene hinzugefügt, auch wenn sie in FileREST verfügbar gemacht werden. Verwenden Sie die SDKs der Steuerungsebene, um auf Parameter und Aktionen zuzugreifen.

Weitere Informationen zur Azure Files API-Oberfläche finden Sie unter Azure Files REST-API.

Verwaltungs-APIs

Aktion API auf Steuerungsebene (Microsoft.Storage) Datenebenen-API (FileREST) Verfügbar auf SMB-Dateifreigaben Verfügbar auf NFS-Dateifreigaben
Erstellen Sie FileShare. Dateifreigaben– Erstellen Erstellen einer Freigabe Ja Ja
Delete FileShare Dateifreigaben – Löschen Freigabe löschen Ja Ja
Get FileShare Dateifreigaben – Abrufen Ja Ja
Mieten FileShare Dateifreigaben – Lease Lease Share Ja Ja
Auflisten von FileShares Dateifreigaben – Liste Listenfreigaben Ja Ja
Wiederherstellen FileShare Dateifreigaben – Wiederherstellen Freigabe wiederherstellen Ja Nein
Aktualisieren von FileShare Dateifreigaben – Aktualisieren - Festlegen von Freigabeeigenschaften
- Festlegen von Freigabemetadaten
Ja Ja
Momentaufnahme FileShare -- Momentaufnahmefreigabe Ja Nein
Abrufen gespeicherter FileShare Zugriffsrichtlinien -- Freigabe-ACL abrufen Ja Nein
Festlegen FileShare gespeicherter Zugriffsrichtlinien -- Festlegen der Freigabe-ACL Ja Nein

Daten-APIs

Aktion API Verfügbar auf SMB-Dateifreigaben Verfügbar auf NFS-Dateifreigaben
Erstellen der Zugriffssteuerungslistenberechtigung Berechtigung erstellen Ja Nein
Abrufen der Zugriffssteuerungslistenberechtigung Berechtigung abrufen Ja Nein

Weitere Informationen