File Shares - Update
As atualizações compartilham propriedades conforme especificado no corpo da solicitação. As propriedades não mencionadas no pedido não serão alteradas. A atualização falhará se o compartilhamento especificado ainda não existir.
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 URI
| Nome | Em | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes das contas de armazenamento devem ter entre 3 e 24 caracteres e usar apenas números e letras minúsculas. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
share
|
path | True |
string minLength: 3maxLength: 63 |
O nome do compartilhamento de arquivos na conta de armazenamento especificada. Os nomes de compartilhamento de arquivos devem ter entre 3 e 63 caracteres e usar números, letras minúsculas e traço (-) apenas. Cada caractere de traço (-) deve ser imediatamente precedido e seguido por uma letra ou número. |
|
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser um UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a utilizar para esta operação. |
Órgão do Pedido
| Nome | Tipo | Descrição |
|---|---|---|
| properties.accessTier |
Camada de acesso para compartilhamento específico. A conta GpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium. |
|
| properties.enabledProtocols |
O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento. |
|
| properties.fileSharePaidBursting |
Propriedades de intermitência paga de compartilhamento de arquivos. |
|
| properties.metadata |
object |
Um par nome-valor para associar ao compartilhamento como metadados. |
| properties.provisionedBandwidthMibps |
integer (int32) |
A largura de banda provisionada do compartilhamento, em mebibytes por segundo. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para largura de banda provisionada. |
| properties.provisionedIops |
integer (int32) |
O IOPS provisionado da ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para IOPS provisionadas. |
| properties.rootSquash |
A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash. |
|
| properties.shareQuota |
integer (int32) |
O tamanho provisionado do compartilhamento, em gibibytes. Deve ser maior que 0 e menor ou igual a 5TB (5120). Para compartilhamentos de arquivos grandes, o tamanho máximo é 102400. Para compartilhamentos de arquivos criados em Arquivos provisionados tipo de conta v2, consulte a resposta da API GetFileServiceUsage para obter o tamanho mínimo e máximo permitido de armazenamento provisionado. |
| properties.signedIdentifiers |
Lista de políticas de acesso armazenado especificadas no compartilhamento. |
Respostas
| Nome | Tipo | Descrição |
|---|---|---|
| 200 OK |
Operação do Azure concluída com êxito. |
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Ative Directory.
Tipo:
oauth2
Flow:
implicit
URL de autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Alcances
| Nome | Descrição |
|---|---|
| user_impersonation | personificar a sua conta de utilizador |
Exemplos
|
Update |
|
Update |
|
Update |
|
Update |
UpdateShareAcls
Pedido de exemplo
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"
}
]
}
}
Resposta de exemplo
{
"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
Pedido de exemplo
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
}
}
}
Resposta de exemplo
{
"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
Pedido de exemplo
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
}
}
Resposta de exemplo
{
"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
Pedido de exemplo
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"
}
}
}
Resposta de exemplo
{
"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"
}
}
}
Definições
| Nome | Descrição |
|---|---|
|
Access |
|
|
Cloud |
Uma resposta de erro do serviço de armazenamento. |
|
Cloud |
Uma resposta de erro do serviço de armazenamento. |
|
Enabled |
O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento. |
|
File |
Propriedades do compartilhamento de arquivos, incluindo Id, nome do recurso, tipo de recurso, Etag. |
|
File |
Propriedades de intermitência paga de compartilhamento de arquivos. |
|
Lease |
Especifica se a concessão em um contêiner é de duração infinita ou fixa, somente quando o contêiner é alugado. |
|
Lease |
Estado de locação do contêiner. |
|
Lease |
O status de concessão do contêiner. |
|
Root |
A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash. |
|
Share |
Camada de acesso para compartilhamento específico. A conta GpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium. |
|
Signed |
AccessPolicy
| Nome | Tipo | Descrição |
|---|---|---|
| expiryTime |
string (date-time) |
Prazo de validade da política de acesso |
| permission |
string |
Lista de permissões abreviadas. |
| startTime |
string (date-time) |
Hora de início da política de acesso |
CloudError
Uma resposta de erro do serviço de armazenamento.
| Nome | Tipo | Descrição |
|---|---|---|
| error |
Uma resposta de erro do serviço de armazenamento. |
CloudErrorBody
Uma resposta de erro do serviço de armazenamento.
| Nome | Tipo | Descrição |
|---|---|---|
| code |
string |
Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente. |
| details |
Uma lista de detalhes adicionais sobre o erro. |
|
| message |
string |
Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário. |
| target |
string |
O alvo do erro específico. Por exemplo, o nome da propriedade em erro. |
EnabledProtocols
O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento.
| Valor | Descrição |
|---|---|
| SMB | |
| NFS |
FileShare
Propriedades do compartilhamento de arquivos, incluindo Id, nome do recurso, tipo de recurso, Etag.
| Nome | Tipo | Descrição |
|---|---|---|
| etag |
string |
Etag de recurso. |
| id |
string |
ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
O nome do recurso |
| properties.accessTier |
Camada de acesso para compartilhamento específico. A conta GpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium. |
|
| properties.accessTierChangeTime |
string (date-time) |
Indica o tempo da última modificação para a camada de acesso de compartilhamento. |
| properties.accessTierStatus |
string |
Indica se há uma transição pendente para a camada de acesso. |
| properties.deleted |
boolean |
Indica se o compartilhamento foi excluído. |
| properties.deletedTime |
string (date-time) |
A hora excluída se o compartilhamento foi excluído. |
| properties.enabledProtocols |
O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento. |
|
| properties.fileSharePaidBursting |
Propriedades de intermitência paga de compartilhamento de arquivos. |
|
| properties.includedBurstIops |
integer (int32) |
O IOPS de intermitência calculado da ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. |
| properties.lastModifiedTime |
string (date-time) |
Devolve a data e a hora em que a partilha foi modificada pela última vez. |
| properties.leaseDuration |
Especifica se a locação de uma ação é de duração infinita ou fixa, somente quando a ação é arrendada. |
|
| properties.leaseState |
Estado de locação da ação. |
|
| properties.leaseStatus |
O status de locação da ação. |
|
| properties.maxBurstCreditsForIops |
integer (int64) |
Os créditos máximos de burst calculados para a ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. |
| properties.metadata |
object |
Um par nome-valor para associar ao compartilhamento como metadados. |
| properties.nextAllowedProvisionedBandwidthDowngradeTime |
string (date-time-rfc7231) |
Retorna o próximo tempo de downgrade de largura de banda provisionada permitido para o compartilhamento. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. |
| properties.nextAllowedProvisionedIopsDowngradeTime |
string (date-time-rfc7231) |
Retorna o próximo tempo de downgrade de IOPS provisionado permitido para o compartilhamento. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. |
| properties.nextAllowedQuotaDowngradeTime |
string (date-time-rfc7231) |
Retorna o próximo tempo de downgrade de tamanho de armazenamento provisionado permitido para o compartilhamento. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos Provisionados v1 SSD e Arquivos Provisionados v2 tipo de conta |
| properties.provisionedBandwidthMibps |
integer (int32) |
A largura de banda provisionada do compartilhamento, em mebibytes por segundo. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para largura de banda provisionada. |
| properties.provisionedIops |
integer (int32) |
O IOPS provisionado da ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para IOPS provisionadas. |
| properties.remainingRetentionDays |
integer (int32) |
Dias de retenção restantes para compartilhamento que foi excluído suavemente. |
| properties.rootSquash |
A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash. |
|
| properties.shareQuota |
integer (int32) |
O tamanho provisionado do compartilhamento, em gibibytes. Deve ser maior que 0 e menor ou igual a 5TB (5120). Para compartilhamentos de arquivos grandes, o tamanho máximo é 102400. Para compartilhamentos de arquivos criados em Arquivos provisionados tipo de conta v2, consulte a resposta da API GetFileServiceUsage para obter o tamanho mínimo e máximo permitido de armazenamento provisionado. |
| properties.shareUsageBytes |
integer (int64) |
O tamanho aproximado dos dados armazenados no compartilhamento. Observe que esse valor pode não incluir todos os arquivos criados ou redimensionados recentemente. |
| properties.signedIdentifiers |
Lista de políticas de acesso armazenado especificadas no compartilhamento. |
|
| properties.snapshotTime |
string (date-time) |
Tempo de criação do snapshot de compartilhamento retornado na resposta de compartilhamentos de lista com expand param "snapshots". |
| properties.version |
string |
A versão do compartilhamento. |
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
FileSharePropertiesFileSharePaidBursting
Propriedades de intermitência paga de compartilhamento de arquivos.
| Nome | Tipo | Descrição |
|---|---|---|
| paidBurstingEnabled |
boolean |
Indica se o bursting pago está habilitado para o compartilhamento. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v1 SSD tipo de conta. |
| paidBurstingMaxBandwidthMibps |
integer (int32) |
A largura de banda máxima de bursting paga para o compartilhamento, em mebibytes por segundo. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v1 SSD tipo de conta. O valor máximo permitido é 10340, que é a largura de banda máxima permitida para um compartilhamento. |
| paidBurstingMaxIops |
integer (int32) |
O máximo pago de IOPS bursting para a ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v1 SSD tipo de conta. O valor máximo permitido é 102400, que é o máximo permitido IOPS para uma ação. |
LeaseDuration
Especifica se a concessão em um contêiner é de duração infinita ou fixa, somente quando o contêiner é alugado.
| Valor | Descrição |
|---|---|
| Infinite | |
| Fixed |
LeaseState
Estado de locação do contêiner.
| Valor | Descrição |
|---|---|
| Available | |
| Leased | |
| Expired | |
| Breaking | |
| Broken |
LeaseStatus
O status de concessão do contêiner.
| Valor | Descrição |
|---|---|
| Locked | |
| Unlocked |
RootSquashType
A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.
| Valor | Descrição |
|---|---|
| NoRootSquash | |
| RootSquash | |
| AllSquash |
ShareAccessTier
Camada de acesso para compartilhamento específico. A conta GpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium.
| Valor | Descrição |
|---|---|
| TransactionOptimized | |
| Hot | |
| Cool | |
| Premium |
SignedIdentifier
| Nome | Tipo | Descrição |
|---|---|---|
| accessPolicy |
Política de acesso |
|
| id |
string |
Um identificador exclusivo da política de acesso armazenado. |