File Shares - Get
Obtient les propriétés d’un partage spécifié.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01&$expand={$expand}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nom du compte de stockage au sein du groupe de ressources spécifié. Ce nom doit comprendre entre 3 et 24 caractères, uniquement des lettres en minuscules et des nombres. Regex pattern: |
resource
|
path | True |
string |
Nom du groupe de ressources dans l’abonnement de l’utilisateur. Le nom ne respecte pas la casse. Regex pattern: |
share
|
path | True |
string |
Nom du partage de fichiers dans le compte de stockage spécifié. Les noms de partages de fichiers doivent comporter entre 3 et 63 caractères et utiliser des chiffres, des minuscules et des tirets (-) uniquement. Chaque tiret (-) doit être immédiatement précédé et suivi d'une lettre ou d'un chiffre. |
subscription
|
path | True |
string |
ID de l’abonnement cible. |
api-version
|
query | True |
string |
Version de l’API à utiliser pour cette opération. |
$expand
|
query |
string |
Facultatif, utilisé pour développer les propriétés dans les propriétés du partage. Les valeurs valides sont les suivantes : stats. Doit être passé sous forme de chaîne avec le délimiteur ','. |
En-tête de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
x-ms-snapshot |
string |
Facultatif, utilisé pour récupérer les propriétés d’un instantané. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
OK : l’opération Obtenir le partage s’est terminée avec succès. |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
Get |
Get |
GetShares
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634?api-version=2023-01-01
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634",
"name": "share1634",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"etag": "\"0x8D592D74CC20EBA\"",
"properties": {
"lastModifiedTime": "2019-05-26T05:06:14Z",
"shareQuota": 1024
}
}
GetShareStats
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634?api-version=2023-01-01&$expand=stats
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634",
"name": "share1634",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"etag": "\"0x8D592D74CC20EBA\"",
"properties": {
"lastModifiedTime": "2019-05-26T05:06:14Z",
"shareQuota": 1024,
"shareUsageBytes": 652945
}
}
Définitions
Nom | Description |
---|---|
Access |
|
Cloud |
Réponse d’erreur du service Stockage. |
Cloud |
Réponse d’erreur du service Stockage. |
Enabled |
Protocole d’authentification utilisé pour le partage de fichiers. Ne peut être spécifié que lors de la création d’un partage. |
File |
Propriétés du partage de fichiers, notamment ID, nom de la ressource, type de ressource, Etag. |
Lease |
Spécifie si le bail sur un partage est d’une durée infinie ou fixe, uniquement lorsque le partage est loué. |
Lease |
État du bail du partage. |
Lease |
Le bail status de la part. |
Root |
La propriété est pour le partage NFS uniquement. La valeur par défaut est NoRootSquash. |
Share |
Niveau d’accès pour un partage spécifique. Le compte GpV2 peut choisir entre TransactionOptimized (valeur par défaut), Chaud et Froid. FichierCompte de stockage peut choisir Premium. |
Signed |
AccessPolicy
Nom | Type | Description |
---|---|---|
expiryTime |
string |
Heure d’expiration de la stratégie d’accès |
permission |
string |
Liste des autorisations abrégées. |
startTime |
string |
Heure de début de la stratégie d’accès |
CloudError
Réponse d’erreur du service Stockage.
Nom | Type | Description |
---|---|---|
error |
Réponse d’erreur du service Stockage. |
CloudErrorBody
Réponse d’erreur du service Stockage.
Nom | Type | Description |
---|---|---|
code |
string |
Identificateur de l'erreur. Les codes sont invariants et sont destinés à être consommés par programmation. |
details |
Liste de détails supplémentaires sur l’erreur. |
|
message |
string |
Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur. |
target |
string |
Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur. |
EnabledProtocols
Protocole d’authentification utilisé pour le partage de fichiers. Ne peut être spécifié que lors de la création d’un partage.
Nom | Type | Description |
---|---|---|
NFS |
string |
|
SMB |
string |
FileShare
Propriétés du partage de fichiers, notamment ID, nom de la ressource, type de ressource, Etag.
Nom | Type | Description |
---|---|---|
etag |
string |
Etag de ressources. |
id |
string |
ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nom de la ressource. |
properties.accessTier |
Niveau d’accès pour un partage spécifique. Le compte GpV2 peut choisir entre TransactionOptimized (valeur par défaut), Chaud et Froid. FichierCompte de stockage peut choisir Premium. |
|
properties.accessTierChangeTime |
string |
Indique l’heure de la dernière modification pour le niveau d’accès de partage. |
properties.accessTierStatus |
string |
Indique s’il existe une transition en attente pour le niveau d’accès. |
properties.deleted |
boolean |
Indique si le partage a été supprimé. |
properties.deletedTime |
string |
Heure de suppression si le partage a été supprimé. |
properties.enabledProtocols |
Protocole d’authentification utilisé pour le partage de fichiers. Ne peut être spécifié que lors de la création d’un partage. |
|
properties.lastModifiedTime |
string |
Renvoie la date et l'heure de la dernière modification du partage. |
properties.leaseDuration |
Spécifie si le bail sur un partage est d’une durée infinie ou fixe, uniquement lorsque le partage est loué. |
|
properties.leaseState |
État du bail du partage. |
|
properties.leaseStatus |
Le bail status de la part. |
|
properties.metadata |
object |
Paire nom-valeur à associer au partage en tant que métadonnées. |
properties.remainingRetentionDays |
integer |
Jours de rétention restants pour le partage supprimé de manière réversible. |
properties.rootSquash |
La propriété est pour le partage NFS uniquement. La valeur par défaut est NoRootSquash. |
|
properties.shareQuota |
integer |
Taille maximale du partage, en gigaoctets. Doit être supérieure à 0, et inférieure ou égale à 5 To (5120) Pour les partages de fichiers volumineux, la taille maximale est 102400. |
properties.shareUsageBytes |
integer |
Taille approximative des données stockées sur le partage. Notez que cette valeur peut ne pas inclure tous les fichiers récemment créés ou récemment redimensionnés. |
properties.signedIdentifiers |
Liste des stratégies d’accès stockées spécifiées sur le partage. |
|
properties.snapshotTime |
string |
Heure de création du partage instantané retournée dans la réponse des partages de liste avec développer param « instantanés ». |
properties.version |
string |
Version du partage. |
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
LeaseDuration
Spécifie si le bail sur un partage est d’une durée infinie ou fixe, uniquement lorsque le partage est loué.
Nom | Type | Description |
---|---|---|
Fixed |
string |
|
Infinite |
string |
LeaseState
État du bail du partage.
Nom | Type | Description |
---|---|---|
Available |
string |
|
Breaking |
string |
|
Broken |
string |
|
Expired |
string |
|
Leased |
string |
LeaseStatus
Le bail status de la part.
Nom | Type | Description |
---|---|---|
Locked |
string |
|
Unlocked |
string |
RootSquashType
La propriété est pour le partage NFS uniquement. La valeur par défaut est NoRootSquash.
Nom | Type | Description |
---|---|---|
AllSquash |
string |
|
NoRootSquash |
string |
|
RootSquash |
string |
ShareAccessTier
Niveau d’accès pour un partage spécifique. Le compte GpV2 peut choisir entre TransactionOptimized (valeur par défaut), Chaud et Froid. FichierCompte de stockage peut choisir Premium.
Nom | Type | Description |
---|---|---|
Cool |
string |
|
Hot |
string |
|
Premium |
string |
|
TransactionOptimized |
string |
SignedIdentifier
Nom | Type | Description |
---|---|---|
accessPolicy |
Stratégie d’accès |
|
id |
string |
Identificateur unique de la stratégie d’accès stockée. |