Partilhar via


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
accountName
path True

string

minLength: 3
maxLength: 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.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

shareName
path True

string

minLength: 3
maxLength: 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.

subscriptionId
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

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.

properties.enabledProtocols

EnabledProtocols

O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento.

properties.fileSharePaidBursting

FileSharePropertiesFileSharePaidBursting

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

RootSquashType

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

SignedIdentifier[]

Lista de políticas de acesso armazenado especificadas no compartilhamento.

Respostas

Nome Tipo Descrição
200 OK

FileShare

Operação do Azure concluída com êxito.

Other Status Codes

CloudError

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

UpdateShareAcls
UpdateSharePaidBursting
UpdateShareProvisionedV2
UpdateShares

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
AccessPolicy
CloudError

Uma resposta de erro do serviço de armazenamento.

CloudErrorBody

Uma resposta de erro do serviço de armazenamento.

EnabledProtocols

O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento.

FileShare

Propriedades do compartilhamento de arquivos, incluindo Id, nome do recurso, tipo de recurso, Etag.

FileSharePropertiesFileSharePaidBursting

Propriedades de intermitência paga de compartilhamento de arquivos.

LeaseDuration

Especifica se a concessão em um contêiner é de duração infinita ou fixa, somente quando o contêiner é alugado.

LeaseState

Estado de locação do contêiner.

LeaseStatus

O status de concessão do contêiner.

RootSquashType

A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.

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.

SignedIdentifier

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

CloudErrorBody

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

CloudErrorBody[]

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

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.

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

EnabledProtocols

O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento.

properties.fileSharePaidBursting

FileSharePropertiesFileSharePaidBursting

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

LeaseDuration

Especifica se a locação de uma ação é de duração infinita ou fixa, somente quando a ação é arrendada.

properties.leaseState

LeaseState

Estado de locação da ação.

properties.leaseStatus

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

RootSquashType

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

SignedIdentifier[]

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

AccessPolicy

Política de acesso

id

string

Um identificador exclusivo da política de acesso armazenado.