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 |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 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. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
share
|
path | True |
string minLength: 3maxLength: 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. |
|
subscription
|
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 |
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 |
Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido. |
|
| properties.fileSharePaidBursting |
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 |
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 |
Lista de directivas de acceso almacenadas especificadas en el recurso compartido. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
La operación de Azure se completó correctamente. |
|
| Other Status Codes |
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
|
Update |
|
Update |
|
Update |
|
Update |
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 |
|---|---|
|
Access |
|
|
Cloud |
Respuesta de error del servicio Storage. |
|
Cloud |
Respuesta de error del servicio Storage. |
|
Enabled |
Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido. |
|
File |
Propiedades del recurso compartido de archivos, incluido Id, nombre de recurso, tipo de recurso, Etag. |
|
File |
Propiedades de expansión de pago del recurso compartido de archivos. |
|
Lease |
Especifica si la concesión de un contenedor es de duración infinita o fija, solo cuando se concede el contenedor. |
|
Lease |
Estado de concesión del contenedor. |
|
Lease |
El estado de concesión del contenedor. |
|
Root |
La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash. |
|
Share |
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. |
|
Signed |
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 |
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 |
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 |
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 |
Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido. |
|
| properties.fileSharePaidBursting |
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 |
Especifica si el arrendamiento de un recurso compartido es de duración infinita o fija, solo cuando se concede el recurso compartido. |
|
| properties.leaseState |
Estado de arrendamiento de la acción. |
|
| properties.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 |
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 |
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 |
Directiva de acceso |
|
| id |
string |
Identificador único de la directiva de acceso almacenada. |