Compartir a través de


File Shares - Update

Las actualizaciones comparten las propiedades especificadas en el cuerpo de la solicitud. Las propiedades no mencionadas en la solicitud no se cambiarán. Se produce un error en la actualización si el recurso compartido especificado aún no existe.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuentas de almacenamiento deben tener entre 3 y 24 caracteres, y usar solo números y letras minúsculas.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

shareName
path True

string

minLength: 3
maxLength: 63

Nombre del recurso compartido de archivos dentro de la cuenta de almacenamiento especificada. Los nombres de los recursos compartidos de archivos deben tener entre 3 y 63 caracteres y usar solo números, minúsculas y guiones (-). Cada guión (-) debe ir inmediatamente precedido y seguido de una letra o número.

subscriptionId
path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.

api-version
query True

string

minLength: 1

La versión de API que se va a utilizar para esta operación.

Cuerpo de la solicitud

Nombre Tipo Description
properties.accessTier

ShareAccessTier

Nivel de acceso para un recurso compartido específico. La cuenta de GpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta FileStorage puede elegir Premium.

properties.enabledProtocols

EnabledProtocols

Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido.

properties.fileSharePaidBursting

FileSharePropertiesFileSharePaidBursting

Propiedades de expansión de pago del recurso compartido de archivos.

properties.metadata

object

Par nombre-valor que se va a asociar al recurso compartido como metadatos.

properties.provisionedBandwidthMibps

integer (int32)

Ancho de banda aprovisionado del recurso compartido, en mebibytes por segundo. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos. Consulte la respuesta de la API GetFileServiceUsage para obtener el valor mínimo y máximo permitido para el ancho de banda aprovisionado.

properties.provisionedIops

integer (int32)

IOPS aprovisionadas del recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos. Consulte la respuesta de la API GetFileServiceUsage para obtener el valor mínimo y máximo permitido para IOPS aprovisionadas.

properties.rootSquash

RootSquashType

La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash.

properties.shareQuota

integer (int32)

Tamaño aprovisionado del recurso compartido, en gibibytes. Debe ser mayor que 0 y menor o igual que 5 TB (5120). Para recursos compartidos de archivos grandes, el tamaño máximo es 102400. En el caso de los recursos compartidos de archivos creados en Tipo de cuenta de Files Provisioned v2, consulte la respuesta de la API GetFileServiceUsage para obtener el tamaño de almacenamiento aprovisionado mínimo y máximo permitido.

properties.signedIdentifiers

SignedIdentifier[]

Lista de directivas de acceso almacenadas especificadas en el recurso compartido.

Respuestas

Nombre Tipo Description
200 OK

FileShare

La operación de Azure se completó correctamente.

Other Status Codes

CloudError

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

UpdateShareAcls
UpdateSharePaidBursting
UpdateShareProvisionedV2
UpdateShares

UpdateShareAcls

Solicitud de ejemplo

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2025-06-01

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

Respuesta de muestra

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

UpdateSharePaidBursting

Solicitud de ejemplo

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2025-06-01

{
  "properties": {
    "fileSharePaidBursting": {
      "paidBurstingEnabled": true,
      "paidBurstingMaxBandwidthMibps": 10340,
      "paidBurstingMaxIops": 102400
    }
  }
}

Respuesta de muestra

{
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "properties": {
    "fileSharePaidBursting": {
      "paidBurstingEnabled": true,
      "paidBurstingMaxBandwidthMibps": 10340,
      "paidBurstingMaxIops": 102400
    }
  }
}

UpdateShareProvisionedV2

Solicitud de ejemplo

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2025-06-01

{
  "properties": {
    "provisionedBandwidthMibps": 200,
    "provisionedIops": 5000,
    "shareQuota": 100
  }
}

Respuesta de muestra

{
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "properties": {
    "includedBurstIops": 15000,
    "maxBurstCreditsForIops": 36000000,
    "nextAllowedProvisionedBandwidthDowngradeTime": "Fri, 25 Oct 2024 01:48:09 GMT",
    "nextAllowedProvisionedIopsDowngradeTime": "Fri, 25 Oct 2024 01:48:09 GMT",
    "nextAllowedQuotaDowngradeTime": "Sat, 26 Oct 2024 01:50:50 GMT",
    "provisionedBandwidthMibps": 200,
    "provisionedIops": 5000,
    "shareQuota": 100
  }
}

UpdateShares

Solicitud de ejemplo

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2025-06-01

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

Respuesta de muestra

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

Definiciones

Nombre Description
AccessPolicy
CloudError

Respuesta de error del servicio Storage.

CloudErrorBody

Respuesta de error del servicio Storage.

EnabledProtocols

Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido.

FileShare

Propiedades del recurso compartido de archivos, incluido Id, nombre de recurso, tipo de recurso, Etag.

FileSharePropertiesFileSharePaidBursting

Propiedades de expansión de pago del recurso compartido de archivos.

LeaseDuration

Especifica si la concesión de un contenedor es de duración infinita o fija, solo cuando se concede el contenedor.

LeaseState

Estado de concesión del contenedor.

LeaseStatus

El estado de concesión del contenedor.

RootSquashType

La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash.

ShareAccessTier

Nivel de acceso para un recurso compartido específico. La cuenta de GpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta FileStorage puede elegir Premium.

SignedIdentifier

AccessPolicy

Nombre Tipo Description
expiryTime

string (date-time)

Hora de expiración de la directiva de acceso

permission

string

Lista de permisos abreviados.

startTime

string (date-time)

Hora de inicio de la directiva de acceso

CloudError

Respuesta de error del servicio Storage.

Nombre Tipo Description
error

CloudErrorBody

Respuesta de error del servicio Storage.

CloudErrorBody

Respuesta de error del servicio Storage.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

details

CloudErrorBody[]

Lista de detalles adicionales sobre el error.

message

string

Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

target

string

Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

EnabledProtocols

Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido.

Valor Description
SMB
NFS

FileShare

Propiedades del recurso compartido de archivos, incluido Id, nombre de recurso, tipo de recurso, Etag.

Nombre Tipo Description
etag

string

Etag de recursos.

id

string

Identificador de recurso completo para el recurso. Ej: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nombre del recurso

properties.accessTier

ShareAccessTier

Nivel de acceso para un recurso compartido específico. La cuenta de GpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta FileStorage puede elegir Premium.

properties.accessTierChangeTime

string (date-time)

Indica la hora de la última modificación para el nivel de acceso compartido.

properties.accessTierStatus

string

Indica si hay una transición pendiente para el nivel de acceso.

properties.deleted

boolean

Indica si se eliminó el recurso compartido.

properties.deletedTime

string (date-time)

La hora de eliminación si se eliminó el recurso compartido.

properties.enabledProtocols

EnabledProtocols

Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido.

properties.fileSharePaidBursting

FileSharePropertiesFileSharePaidBursting

Propiedades de expansión de pago del recurso compartido de archivos.

properties.includedBurstIops

integer (int32)

Las IOPS de ráfaga calculadas del recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos.

properties.lastModifiedTime

string (date-time)

Devuelve la fecha y la hora en que se modificó por última vez el recurso compartido.

properties.leaseDuration

LeaseDuration

Especifica si el arrendamiento de un recurso compartido es de duración infinita o fija, solo cuando se concede el recurso compartido.

properties.leaseState

LeaseState

Estado de arrendamiento de la acción.

properties.leaseStatus

LeaseStatus

El estado de arrendamiento de la acción.

properties.maxBurstCreditsForIops

integer (int64)

Los créditos de ráfaga máximos calculados para el recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos.

properties.metadata

object

Par nombre-valor que se va a asociar al recurso compartido como metadatos.

properties.nextAllowedProvisionedBandwidthDowngradeTime

string (date-time-rfc7231)

Devuelve el siguiente tiempo de degradación de ancho de banda aprovisionado permitido para el recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos.

properties.nextAllowedProvisionedIopsDowngradeTime

string (date-time-rfc7231)

Devuelve el siguiente tiempo de degradación de IOPS aprovisionadas permitido para el recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos.

properties.nextAllowedQuotaDowngradeTime

string (date-time-rfc7231)

Devuelve el siguiente tiempo de degradación del tamaño de almacenamiento aprovisionado permitido para el recurso compartido. Esta propiedad solo es para recursos compartidos de archivos creados en el tipo de cuenta SSD Files Provisioned v1 y Files Provisioned v2

properties.provisionedBandwidthMibps

integer (int32)

Ancho de banda aprovisionado del recurso compartido, en mebibytes por segundo. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos. Consulte la respuesta de la API GetFileServiceUsage para obtener el valor mínimo y máximo permitido para el ancho de banda aprovisionado.

properties.provisionedIops

integer (int32)

IOPS aprovisionadas del recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en Tipo de cuenta aprovisionado v2 de Archivos. Consulte la respuesta de la API GetFileServiceUsage para obtener el valor mínimo y máximo permitido para IOPS aprovisionadas.

properties.remainingRetentionDays

integer (int32)

Días de retención restantes para el recurso compartido que se eliminó temporalmente.

properties.rootSquash

RootSquashType

La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash.

properties.shareQuota

integer (int32)

Tamaño aprovisionado del recurso compartido, en gibibytes. Debe ser mayor que 0 y menor o igual que 5 TB (5120). Para recursos compartidos de archivos grandes, el tamaño máximo es 102400. En el caso de los recursos compartidos de archivos creados en Tipo de cuenta de Files Provisioned v2, consulte la respuesta de la API GetFileServiceUsage para obtener el tamaño de almacenamiento aprovisionado mínimo y máximo permitido.

properties.shareUsageBytes

integer (int64)

El tamaño aproximado de los datos almacenados en el recurso compartido. Tenga en cuenta que es posible que este valor no incluya todos los archivos creados recientemente o cuyo tamaño se ha cambiado recientemente.

properties.signedIdentifiers

SignedIdentifier[]

Lista de directivas de acceso almacenadas especificadas en el recurso compartido.

properties.snapshotTime

string (date-time)

Hora de creación de la instantánea del recurso compartido devuelta en la respuesta de los recursos compartidos de lista con "instantáneas" de parámetros de expansión.

properties.version

string

La versión del recurso compartido.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

FileSharePropertiesFileSharePaidBursting

Propiedades de expansión de pago del recurso compartido de archivos.

Nombre Tipo Description
paidBurstingEnabled

boolean

Indica si la expansión de pago está habilitada para el recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en tipo de cuenta SSD aprovisionada v1 de Files.

paidBurstingMaxBandwidthMibps

integer (int32)

Ancho de banda máximo de expansión de pago para el recurso compartido, en mebibytes por segundo. Esta propiedad solo es para los recursos compartidos de archivos creados en tipo de cuenta SSD aprovisionada v1 de Files. El valor máximo permitido es 10340, que es el ancho de banda máximo permitido para un recurso compartido.

paidBurstingMaxIops

integer (int32)

Número máximo de IOPS de expansión de pago para el recurso compartido. Esta propiedad solo es para los recursos compartidos de archivos creados en tipo de cuenta SSD aprovisionada v1 de Files. El valor máximo permitido es 102400, que es el valor máximo permitido de IOPS para un recurso compartido.

LeaseDuration

Especifica si la concesión de un contenedor es de duración infinita o fija, solo cuando se concede el contenedor.

Valor Description
Infinite
Fixed

LeaseState

Estado de concesión del contenedor.

Valor Description
Available
Leased
Expired
Breaking
Broken

LeaseStatus

El estado de concesión del contenedor.

Valor Description
Locked
Unlocked

RootSquashType

La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash.

Valor Description
NoRootSquash
RootSquash
AllSquash

ShareAccessTier

Nivel de acceso para un recurso compartido específico. La cuenta de GpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta FileStorage puede elegir Premium.

Valor Description
TransactionOptimized
Hot
Cool
Premium

SignedIdentifier

Nombre Tipo Description
accessPolicy

AccessPolicy

Directiva de acceso

id

string

Identificador único de la directiva de acceso almacenada.