File Shares - Update
Atualizações compartilhar propriedades conforme especificado no corpo da solicitação. As propriedades não mencionadas na solicitação 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=2023-01-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres, usar números e apenas letras minúsculas. Regex pattern: |
resource
|
path | True |
string |
O nome do grupo de recursos na assinatura do usuário. O nome diferencia maiúsculas de minúsculas. Regex pattern: |
share
|
path | True |
string |
O nome do compartilhamento de arquivos dentro da 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 (-). Todo caractere de traço (-) precisa ser precedido e seguido imediatamente por uma letra ou um número. |
subscription
|
path | True |
string |
A ID da assinatura de destino. |
api-version
|
query | True |
string |
A versão da API a ser usada para esta operação. |
Corpo da solicitação
Nome | Tipo | Description |
---|---|---|
properties.accessTier |
Camada de acesso para compartilhamento específico. A conta gpv2 pode escolher entre TransactionOptimized (padrão), Frequente e Esporádico. 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.metadata |
object |
Um par de nome-valor a ser associado ao compartilhamento como metadados. |
properties.rootSquash |
A propriedade é somente para compartilhamento NFS. O padrão é NoRootSquash. |
|
properties.shareQuota |
integer |
O tamanho máximo do compartilhamento, em gigabytes. Deve ser maior que 0 e menor ou igual a 5 TB (5120). Para Compartilhamentos de Arquivos Grandes, o tamanho máximo é 102400. |
properties.signedIdentifiers |
Lista de políticas de acesso armazenadas especificadas no compartilhamento. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK -- Operação de atualização de compartilhamento concluída com êxito. |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo do OAuth2 do Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
Update |
Update |
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"
}
}
}
Definições
Nome | Description |
---|---|
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. |
Lease |
Especifica se a concessão em um compartilhamento é de duração infinita ou fixa, somente quando o compartilhamento é concedido. |
Lease |
Estado de concessão do compartilhamento. |
Lease |
O status de concessão do compartilhamento. |
Root |
A propriedade é somente para compartilhamento NFS. O padrão é NoRootSquash. |
Share |
Camada de acesso para compartilhamento específico. A conta gpv2 pode escolher entre TransactionOptimized (padrão), Frequente e Esporádico. A conta FileStorage pode escolher Premium. |
Signed |
AccessPolicy
Nome | Tipo | Description |
---|---|---|
expiryTime |
string |
Hora de expiração da política de acesso |
permission |
string |
Lista de permissões abreviadas. |
startTime |
string |
Hora de início da política de acesso |
CloudError
Uma resposta de erro do serviço de Armazenamento.
Nome | Tipo | Description |
---|---|---|
error |
Uma resposta de erro do serviço de Armazenamento. |
CloudErrorBody
Uma resposta de erro do serviço de Armazenamento.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente. |
details |
Uma lista de detalhes adicionais sobre o erro. |
|
message |
string |
Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário. |
target |
string |
O destino 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.
Nome | Tipo | Description |
---|---|---|
NFS |
string |
|
SMB |
string |
FileShare
Propriedades do compartilhamento de arquivos, incluindo ID, nome do recurso, tipo de recurso, Etag.
Nome | Tipo | Description |
---|---|---|
etag |
string |
Etag de recurso. |
id |
string |
ID de recurso totalmente qualificada 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), Frequente e Esporádico. A conta FileStorage pode escolher Premium. |
|
properties.accessTierChangeTime |
string |
Indica a hora 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 |
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.lastModifiedTime |
string |
Retorna a data e a hora em que o compartilhamento foi modificado pela última vez. |
properties.leaseDuration |
Especifica se a concessão em um compartilhamento é de duração infinita ou fixa, somente quando o compartilhamento é concedido. |
|
properties.leaseState |
Estado de concessão do compartilhamento. |
|
properties.leaseStatus |
O status de concessão do compartilhamento. |
|
properties.metadata |
object |
Um par de nome-valor a ser associado ao compartilhamento como metadados. |
properties.remainingRetentionDays |
integer |
Dias de retenção restantes para o compartilhamento que foi excluído temporariamente. |
properties.rootSquash |
A propriedade é somente para compartilhamento NFS. O padrão é NoRootSquash. |
|
properties.shareQuota |
integer |
O tamanho máximo do compartilhamento, em gigabytes. Deve ser maior que 0 e menor ou igual a 5 TB (5120). Para Compartilhamentos de Arquivos Grandes, o tamanho máximo é 102400. |
properties.shareUsageBytes |
integer |
O tamanho aproximado dos dados armazenados no compartilhamento. Observe que esse valor pode não incluir todos os arquivos recém-criados ou redimensionados recentemente. |
properties.signedIdentifiers |
Lista de políticas de acesso armazenadas especificadas no compartilhamento. |
|
properties.snapshotTime |
string |
O tempo de criação do compartilhamento instantâneo retornado na resposta de compartilhamentos de lista com "instantâneos" de parâmetro de expansão. |
properties.version |
string |
A versão do compartilhamento. |
type |
string |
Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
LeaseDuration
Especifica se a concessão em um compartilhamento é de duração infinita ou fixa, somente quando o compartilhamento é concedido.
Nome | Tipo | Description |
---|---|---|
Fixed |
string |
|
Infinite |
string |
LeaseState
Estado de concessão do compartilhamento.
Nome | Tipo | Description |
---|---|---|
Available |
string |
|
Breaking |
string |
|
Broken |
string |
|
Expired |
string |
|
Leased |
string |
LeaseStatus
O status de concessão do compartilhamento.
Nome | Tipo | Description |
---|---|---|
Locked |
string |
|
Unlocked |
string |
RootSquashType
A propriedade é somente para compartilhamento NFS. O padrão é NoRootSquash.
Nome | Tipo | Description |
---|---|---|
AllSquash |
string |
|
NoRootSquash |
string |
|
RootSquash |
string |
ShareAccessTier
Camada de acesso para compartilhamento específico. A conta gpv2 pode escolher entre TransactionOptimized (padrão), Frequente e Esporádico. A conta FileStorage pode escolher Premium.
Nome | Tipo | Description |
---|---|---|
Cool |
string |
|
Hot |
string |
|
Premium |
string |
|
TransactionOptimized |
string |
SignedIdentifier
Nome | Tipo | Description |
---|---|---|
accessPolicy |
Política de acesso |
|
id |
string |
Um identificador exclusivo da política de acesso armazenada. |