File Shares - Update

Mises à jour les propriétés de partage comme spécifié dans le corps de la requête. Les propriétés non mentionnées dans la demande ne seront pas modifiées. La mise à jour échoue si le partage spécifié n’existe pas déjà.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01

Paramètres URI

Nom Dans Obligatoire Type Description
accountName
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: ^[a-z0-9]+$

resourceGroupName
path True

string

Nom du groupe de ressources dans l’abonnement de l’utilisateur. Le nom ne respecte pas la casse.

Regex pattern: ^[-\w\._\(\)]+$

shareName
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.

subscriptionId
path True

string

ID de l’abonnement cible.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Type Description
properties.accessTier

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.

properties.enabledProtocols

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.metadata

object

Paire nom-valeur à associer au partage en tant que métadonnées.

properties.rootSquash

RootSquashType

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.signedIdentifiers

SignedIdentifier[]

Liste des stratégies d’accès stockées spécifiées sur le partage.

Réponses

Nom Type Description
200 OK

FileShare

OK : l’opération de mise à jour du partage s’est terminée avec succès.

Other Status Codes

CloudError

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

UpdateShareAcls
UpdateShares

UpdateShareAcls

Sample Request

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-01-01

{
  "properties": {
    "signedIdentifiers": [
      {
        "id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
        "accessPolicy": {
          "startTime": "2021-04-01T08:49:37.0000000Z",
          "expiryTime": "2021-05-01T08:49:37.0000000Z",
          "permission": "rwd"
        }
      }
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "signedIdentifiers": [
      {
        "id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
        "accessPolicy": {
          "startTime": "2021-04-01T08:49:37.0000000Z",
          "expiryTime": "2021-05-01T08:49:37.0000000Z",
          "permission": "rwd"
        }
      }
    ]
  }
}

UpdateShares

Sample Request

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-01-01

{
  "properties": {
    "metadata": {
      "type": "image"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "metadata": {
      "type": "image"
    }
  }
}

Définitions

Nom Description
AccessPolicy
CloudError

Réponse d’erreur du service Stockage.

CloudErrorBody

Réponse d’erreur du service Stockage.

EnabledProtocols

Protocole d’authentification utilisé pour le partage de fichiers. Ne peut être spécifié que lors de la création d’un partage.

FileShare

Propriétés du partage de fichiers, notamment ID, nom de la ressource, type de ressource, Etag.

LeaseDuration

Spécifie si le bail sur un partage est d’une durée infinie ou fixe, uniquement lorsque le partage est loué.

LeaseState

État du bail du partage.

LeaseStatus

Le bail status de la part.

RootSquashType

La propriété est pour le partage NFS uniquement. La valeur par défaut est NoRootSquash.

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.

SignedIdentifier

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

CloudErrorBody

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

CloudErrorBody[]

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

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.

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

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

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

LeaseState

État du bail du partage.

properties.leaseStatus

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

RootSquashType

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

SignedIdentifier[]

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

AccessPolicy

Stratégie d’accès

id

string

Identificateur unique de la stratégie d’accès stockée.