Opérations sur la ressource FileShare
La FileShare ressource fournit une interface de gestion pour le partage de fichiers Azure, qui vous permet de contrôler le nom du partage de fichiers, le protocole activé, la taille allouée (« quota »), etc. La FileShare ressource est un enfant de la FileService ressource, et un compte de stockage peut contenir un nombre infini de partages de fichiers, sous réserve des limites de ressources du compte de stockage.
Vous pouvez interagir avec FileShare les ressources de deux façons :
- (Recommandé) Le fournisseur de ressources de stockage (Microsoft.Storage), qui fournit une API de plan de contrôle à gérer via Azure Resource Manager.
- (Hérité) L’API FileREST, qui fournit des points de terminaison HTTPS supplémentaires pour gérer
FileShares.
À moins que vous n’ayez une raison spécifique, vous devez utiliser l’API de plan de contrôle (fournisseur de ressources de stockage) pour toutes les activités de gestion. Les API à gérer FileShares sont exposées via le plan de données pour des raisons héritées. Les API de plan de données qui effectuent des actions de gestion sont entièrement prises en charge et acceptables pour une utilisation dans les circonstances suivantes :
- Vous avez une application ou un service hérité qui utilise déjà ces API.
- Vous avez des exigences de mise à l’échelle très élevées. L’API de contrôle fournie par le fournisseur de ressources de stockage offre des garanties de mise à l’échelle beaucoup plus faibles que l’API FileREST.
Les nouveaux paramètres et actions sur ne FileService peuvent pas être ajoutés aux kits SDK REST du plan de données, même s’ils sont exposés dans FileREST. Utilisez les SDK du plan de contrôle pour accéder aux paramètres et aux actions.
Pour en savoir plus sur la surface d’exposition de l’API Azure Files, consultez Azure Files’API REST.
API de gestion
| Action | API du plan de contrôle (Microsoft.Storage) | API de plan de données (FileREST) | Disponible sur les partages de fichiers SMB | Disponible sur les partages de fichiers NFS |
|---|---|---|---|---|
Créez FileShare. |
Partages de fichiers - Créer | Création de partage |  |
|
Delete FileShare |
Partages de fichiers - Supprimer | Supprimer le partage | |
|
Get FileShare |
Partages de fichiers - Obtenir | |
|
|
Bail FileShare |
Partages de fichiers - Bail | Partage de bail | |
|
Liste FileShares |
Partages de fichiers - Liste | Partages de liste | |
|
Restaurer FileShare |
Partages de fichiers - Restaurer | Restaurer le partage | |
 |
Mettre à jour FileShare |
Partages de fichiers - Mise à jour | - Définir les propriétés du partage - Définir les métadonnées de partage |
|
|
Instantané FileShare |
-- | partage de fichiers d'instantanés | |
|
Obtenir des FileShare stratégies d’accès stockées |
-- | Obtention de l'ACL du partage | |
|
Définir des FileShare stratégies d’accès stockées |
-- | Définir l’ACL de partage | |
|
API de données
| Action | API | Disponible sur les partages de fichiers SMB | Disponible sur les partages de fichiers NFS |
|---|---|---|---|
| Créer une autorisation de liste de contrôle d’accès | Créer une autorisation | |
|
| Obtenir l’autorisation de liste de contrôle d’accès | Autorisation Get | |
|